n8n
اربط n8n بمفتاح API وعنوان Webhook ليستطيع الوكيل بدء سير عملك أثناء المكالمة.
ما الذي ستحققه
سيعرض n8n Connected، وستعرف كيف يبدأ سير العمل.
نظرة عامة وحالات الاستخدام
يستطيع الربط سرد سير العمل لديك وعمليات تشغيله، وبدء سير عمل عبر مشغّل Webhook الخاص به. ويستطيع n8n بعدها الوصول إلى مئات التطبيقات الأخرى.
المتطلبات المسبقة
- نسخة n8n (سحابية أو مستضافة ذاتيًا) مع تفعيل API العام. وAPI لدى n8n غير متاح في الفترة التجريبية المجانية.
- سير عمل يبدأ بعقدة Webhook، إذا أردت بدء سير العمل.
إعداد الحساب الخارجي (في n8n)
n8n هي التي تتحكم في هذه الشاشات. دليل n8n: API authentication.
- في n8n اختر Settings ثم n8n API ثم Create an API key. وانسخه.
- لسير عمل تريد بدءه: افتح عقدة Webhook الخاصة به وانسخ Production URL (ويحتوي
/webhook/). لا تستخدم Test URL (/webhook-test/): فهو لا يردّ إلا والمحرر مفتوح ويستمع، لذا تفشل الاستدعاءات إليه عشوائيًا. - إذا كانت عقدة Webhook تستخدم Header Auth، فدوّن اسم الترويسة وقيمتها.
اربطه في Phynxa
- Integrations، Connect في n8n.
- أدخل Instance URL (مثل
https://acme.app.n8n.cloud) وAPI key. - اختياريًا أدخل Webhook URL وWebhook auth header وWebhook auth value.
- اختر Check and connect.
الأذونات والإعدادات
| الحقل | المعنى |
|---|---|
| Instance URL | عنوان n8n لديك. ويُتسامح مع مسار API ملصق أو مضيف مجرد. |
| API key | يُرسَل في الترويسة X-N8N-API-KEY إلى <instance>/api/v1. مطلوب. |
| Webhook URL | اختياري. عنوان Production لسير العمل. |
| Webhook auth header / value | اختياري. لعقدة Webhook ذات Header Auth. ولا يُرسَل مفتاح API إلى Webhook أبدًا. |
وتُرفَض عناوين http العادية وعناوين الشبكات الخاصة.
استخدمه في مكالمة
في تبويب Tools للوكيل، Add tool، Integration، n8n:
| الإجراء | ما يفعله | يعمل |
|---|---|---|
| Trigger workflow | يبدأ سير العمل الذي حفظت عنوان Webhook الخاص به مع الربط ويمرّر إليه name وphone وemail وdetails الخاصة بالمتصل. ولا يستطيع الوكيل اختيار سير عمل أو عنوان آخر. | في الخلفية |
يستقبلها سير العمل كحقول في عقدة Webhook الخاصة به. أما عرض سير العمل وتشغيلاته فيبقى في لوحة التحكم ولا يُعرض للوكلاء.
اختبره
يجب أن يجيب Test connection "n8n is responding."
النتيجة المتوقعة
تعرض البطاقة Connected.
استكشاف الأخطاء
- يفشل الفحص بـ 401. مفتاح API خاطئ، أو أن API العام غير مفعّل في خطتك.
- "Could not reach the service." تحقق من عنوان النسخة ومن إمكانية الوصول إليها من الإنترنت.
- يفشل استدعاء Webhook أحيانًا. استخدمتَ Test URL؛ فانتقل إلى Production URL وفعّل سير العمل.
الأمان وبيانات الاعتماد
يُخزَّن مفتاح API وقيمة Webhook مشفّرَين. اسحب المفتاح في n8n لقطع الوصول. وRemove ينساهما هنا.
أدلة ذات صلة
هل في هذه الصفحة ما لا يطابق ما تراه في لوحة التحكم؟ أخبرنا.