تكامل n8n مع نافس CRM: أحداث الصفقات في سير عمل تملكونه

لمن يناسب هذا التكامل

تفضّل فرق تقنية كثيرة n8n لأنه يعمل على خوادمها أو في سحابة n8n، ويتيح كتابة شيفرة داخل سير العمل عند الحاجة. التكامل مع نافس يعطي هذه الفرق نقطة بداية واضحة: كل تغيير في مرحلة صفقة يصل إلى n8n، ومن هناك يمر إلى أنظمتكم الداخلية كما تريدون.

أمثلة: إرسال الصفقات التي تصل إلى مرحلة التعاقد إلى نظام تخطيط الموارد لديكم، أو تسجيل كل انتقال في مستودع بيانات للتحليل، أو فتح طلب في نظام التذاكر الداخلي عندما تدخل صفقة مرحلة التنفيذ.

الإعداد في n8n ثم في نافس

1. 1

   أضف عقدة Webhook

   في سير عمل جديد في n8n أضف عقدة Webhook بالطريقة POST، وغيّر مسارها العشوائي الافتراضي إلى deal.stage_changed.

2. 2

   انشر سير العمل

   يسجل n8n رابط الإنتاج عند نشر سير العمل وتفعيله. ونافس يرسل دائمًا إلى رابط الإنتاج، لا إلى رابط الاختبار، فلن تصل الأحداث إلى سير عمل غير منشور.

3. 3

   جهّز مفتاح API

   أنشئ مفتاح API من إعدادات n8n. يحتاجه نافس لاختبار الاتصال، ويرسله أيضًا في الترويسة X-N8N-API-KEY مع كل حدث.

4. 4

   أدخل البيانات في نافس

   بصفتك مديرًا، افتح «متجر التطبيقات» ← n8n ← زر الإعداد، واكتب العنوان الأساسي للنسخة، مثل https://n8n.example.com، والصق المفتاح، ثم «حفظ».

5. 5

   اختبر ثم جرّب حدثًا حقيقيًا

   اضغط «اختبار الاتصال»، فيستدعي نافس قائمة سير العمل في واجهة n8n للتأكد من العنوان والمفتاح. بعدها انقل صفقة تجريبية إلى مرحلة أخرى وراقب التنفيذ في n8n.

ولحماية العقدة من الطلبات المجهولة، اضبط فيها المصادقة بالترويسة (Header Auth) على الترويسة X-N8N-API-KEY وقيمتها، ويفضَّل أن تخصص مفتاحًا لهذا الغرض وحده.

الرابط والبيانات

يبني نافس الرابط بإضافة المسار /webhook/deal.stage_changed إلى العنوان الأساسي، ويرسل إليه طلب POST بصيغة JSON على هذا الشكل:

{
  "event": "deal.stage_changed",
  "delivered_at": "2026-09-28T09:15:00.000Z",
  "data": {
    "deal_id": 418,
    "name": "Clinic group renewal",
    "amount": 48000,
    "pipeline": "Enterprise",
    "previous_stage": "Proposal",
    "stage": "Negotiation",
    "updated_at": "2026-09-28T09:14:58.000Z"
  }
}

تصل المراحل والمسار بأسمائها المعروضة، وقد تكون بالعربية، لا بمعرّفات داخلية؛ فاكتب شروط عقدة IF أو Switch على الأسماء كما ظهرت في أول تنفيذ. والاتجاه من نافس إلى n8n فقط؛ وللكتابة في نافس استخدم عقدة HTTP Request مع الواجهة البرمجية REST ورمز Bearer.

حدود يجب أن تعرفها

• العنوان يجب أن يكون عامًا: يرفض نافس الإرسال إلى عناوين الشبكات الداخلية والخاصة، فالنسخة المستضافة داخليًا تحتاج عنوانًا منشورًا على الإنترنت.
• بطاقة المتجر تعرض «غير متصل» دائمًا: خلل معروف في قراءة حالة الاتصال؛ فاعتمد على «اختبار الاتصال» وسجل التنفيذات في n8n.
• حدث واحد، بلا توقيع ولا إعادة محاولة: إذا كانت النسخة متوقفة لحظة الانتقال ضاع الحدث.
• المفتاح يُرسل مع كل طلب: لأن مفتاح API يمر في الترويسة، اجعله مفتاحًا مخصصًا بأضيق صلاحيات تتيحها نسختك من n8n.

للأحداث التسعة لجهات الاتصال والشركات والصفقات، بتوقيع HMAC وحتى 7 محاولات تسليم، سجّل Webhook صادرًا من الإعدادات يشير إلى عقدة Webhook أخرى في n8n، وتحقق من التوقيع في عقدة Code. هذه الميزة ضمن خطة Pro.

أسئلة شائعة

المصادر

1. n8n Docs: Webhook nodeاطُّلع عليه في 2026-09-28