ما هو وما الغرض منه
من خلال n8n أو Make أو Zapier، يمكنك ربط PaperOffice AI بأنظمتك الأخرى. تستخدم المكونات الإنشائية القياسية لهذه الأدوات: طلبات HTTP إلى واجهة برمجة التطبيقات REST والإشارات المرجعية. يمكن لـ n8n أيضاً الاتصال بخادم MCP الخاص بـ PaperOffice باستخدام عميل MCP الخاص به. تتوفر أهداف الإشارات المرجعية في وكلاء سير العمل فقط بدءاً من خطة Professional.
كيفية العمل
- قم بإنشاء مفتاح في صفحة مفاتيح API. أدخله في عقدة HTTP كرمز حامل (Bearer token).
- استدعِ واجهة برمجة التطبيقات REST، على سبيل المثال لتحميل أو البحث. راجع وثائق API للحصول على نقاط النهاية.
- لتلقي النتائج، افتح Workflow AI → Workflow Agents، وقم بتعديل وكيل محفوظ واختر علامة التبويب خطافات الويب (Webhooks).
- انقر على إضافة هدف ويب هوك. أدخل عنوان الإشارة المرجعية من n8n أو Make أو Zapier كـ عنوان URL المستهدف.
- تحت الإرسال عند، اختر اكتمل التنفيذ بنجاح، أو فشل التنفيذ، أو كليهما.
- لمراجعة بشرية، ينشئ تدفقك مهمة مراجعة وينتظر إشارة مرجعية. يبلغ الحدث task.completed عن القرار من Workflow AI → مهام Human In The Loop.
معلومات مفيدة
- يتم الدفع عن كل عملية تسليم ناجحة للإشارة المرجعية. عمليات إعادة المحاولة، الأحداث الاختبارية، والتسليمات الفاشلة مجانية.
- استدعاءات API مدفوعة.
- مسموح بالمواضع النائبة مثل {trigger.pofid} في المسار والاستعلام والعناوين، ولكن ليس في اسم المضيف.
- الإشارات المرجعية القادمة من PaperOffice موقعة في رأس X-PaperOffice-Signature. تحقق منها في تدفقك.
- لـ Make و Zapier، استخدم وحدات HTTP والإشارة المرجعية الخاصة بهما.
المزيد: التكاملات على paperoffice.ai.