Naffes
Englishابدأ مجانًا↗

التكاملات

إنشاء Webhook صادر لأحداث جهات الاتصال والشركات والصفقات

الـ Webhook الصادر في نافس CRM يرسل طلب POST إلى نظامك كلما أُنشئت جهة اتصال أو شركة أو صفقة أو عُدّلت أو حُذفت. كل تسليم موقّع ويُعاد عند الفشل ومسجَّل، فهو الطريق الموثوق لمزامنة نظام محاسبة أو مستودع بيانات دون سحب دوري.

آخر تحديثدقيقتا قراءة

الخطوات

  1. افتح صفحة Webhooks

    بصفتك مدير مساحة العمل، افتح «الإعدادات» ← «التكاملات» ← «التطبيقات والواجهات البرمجية» ← «Webhooks».

  2. أنشئ Webhook جديدًا

    اضغط «Webhook جديد»، واكتب «الاسم»، ثم «URL نقطة الوصول»: رابط عام يبدأ بـ https في نظامك. العناوين الخاصة والداخلية مرفوضة.

  3. اكتب اسم الحدث

    في حقل «الحدث» اكتب اسم حدث واحد بدقة، مثل deal.created أو contact.updated. الحقل نص حر، فالخطأ الإملائي يعني أن الحدث لن يطابق شيئًا.

  4. أنشئ وراقب

    اضغط «إنشاء». تعرض بطاقة الـ Webhook «معدّل النجاح» و«آخر تسليم» وآخر 4 أحرف من «السرّ»، ومنها أيضًا «إيقاف مؤقت» و«استئناف» و«حذف».

ملاحظة

كل Webhook من الشاشة يشترك في حدث واحد. لتلقي أكثر من حدث أنشئ Webhook لكل حدث، ويمكن أن تشير كلها إلى الرابط نفسه.

الأحداث المتاحة

السجلإنشاءتعديلحذف
جهة اتصالcontact.createdcontact.updatedcontact.deleted
شركةcompany.createdcompany.updatedcompany.deleted
صفقةdeal.createddeal.updateddeal.deleted

يحمل كل طلب خصائص السجل، ويحمل طلب التعديل الحقول التي تغيّرت. تغيير مرحلة الصفقة يصل حدث deal.updated، ولا توجد أحداث للمهام أو الاجتماعات أو الملاحظات أو التذاكر أو الفواتير أو الرسائل. والاستيراد الجماعي لا يطلق أحداثًا.

ما يصل إلى نظامك وكيف تستقبله

  • الترويسات: X-Naffes-Signature بصيغة t=الطابع الزمني,v1=التوقيع (HMAC-SHA256)، وX-Naffes-Event، وX-Naffes-Delivery-Id، وX-Naffes-Webhook-Id.
  • إعادة المحاولة: حتى 7 محاولات إجمالًا، بعد 30 ثانية ثم دقيقتين ثم 10 دقائق ثم ساعة ثم 6 ساعات ثم 24 ساعة. ردّ برمز نجاح 2xx بسرعة، وعالج البيانات بعد ذلك.
  • التكرار المحتمل: بسبب إعادة المحاولة قد يصلك التسليم نفسه أكثر من مرة، فاستخدم X-Naffes-Delivery-Id لتجاهل المكرر.
  • التحقق من التوقيع: الشاشة تعرض آخر 4 أحرف فقط من السر، والسر الكامل يظهر في رد الواجهة البرمجية عند الإنشاء فقط. لذلك يحتاج التحقق من التوقيع حاليًا إنشاء الـ Webhook عبر الواجهة البرمجية.

حل المشكلات

  • توقف الإرسال فجأة: يُوقف النظام الاشتراك تلقائيًا إذا فشلت نصف تسليماته الأخيرة أو أكثر (من آخر 100، بحد أدنى 10). أصلح نقطة الاستقبال ثم اضغط «استئناف».
  • رقم «عمليات التسليم خلال 24 ساعة» يبدو كبيرًا: البطاقة تعرض حاليًا إجمالي التسليمات منذ الإنشاء، لا آخر 24 ساعة فقط.
  • لا سجل تسليمات على الشاشة: سجل كل محاولة وإعادة إرسال تجربة وتدوير السر متاحة عبر الواجهة البرمجية فقط حاليًا.
  • تحتاج حدث تغيير المرحلة تحديدًا في Make أو n8n: تكامل متجر التطبيقات يرسل deal.stage_changed إلى Make أو n8n، لكنه غير موقّع ولا يعيد المحاولة.