إعداد واحد
1
احصل على رابط من النظام المستقبِل
في n8n، عقدة Webhook. وفي Zapier، مشغّل “Catch Hook”. وفي نظامك الخاص، أي نقطة نهاية تقبل
طلب POST.
2
أضف نقطة النهاية
التكاملات ← Webhooks ← إضافة. ويجب أن يكون الرابط متاحًا علنًا عبر http(s) — فالعناوين
الداخلية والخاصة مرفوضة.
3
اختر الأحداث
ما تحتاجه فقط. فكل حدث زائد هو حركة بيانات على المستقبِل تجاهلها.
4
اختر الحقول
لكل حدث يمكنك اختيار الحقول التي تُرسَل.
5
أرسل اختبارًا
يؤكد أن نقطة النهاية تقبل ما نرسله قبل أن يعتمد عليها شيء حقيقي.
الأحداث
المراسلة: استُلمت رسالة، أُرسلت، سُلّمت، قُرئت، فشلت؛ واستُلم تعليق. النظام (CRM): أُنشئ عميل محتمل، حُدّث، تغيّرت مرحلته، أُسند، رُبح، خُسر.مفتاح التوقيع
لكل نقطة نهاية مفتاح يُستخدم لتوقيع كل طلب. وينبغي أن يتحقق منه المستقبِل لديك — وإلا استطاع أي شخص يعرف رابطك إرسال أحداث مزيّفة إليه. ويمكنك تدوير المفتاح. حدّث المستقبِل في الوقت نفسه؛ فالطلبات الموقّعة بالمفتاح الجديد ستفشل في التحقق مقابل القديم.سجل التسليم
آخر 300 محاولة لكل نقطة نهاية، مع ما أُرسل وما عاد.إخفاقات لم تصل إلى نقطة النهاية أصلًا
إخفاقات لم تصل إلى نقطة النهاية أصلًا
مشكلات DNS أو TLS أو اتصال. فالرابط خاطئ، أو المستقبِل غير متاح علنًا.
نقطة النهاية رفضت الطلب
نقطة النهاية رفضت الطلب
ردّت بحالة خطأ. والنص في السجل هو رسالة المستقبِل نفسه — وهناك سيكون السبب.
لا شيء في السجل إطلاقًا
لا شيء في السجل إطلاقًا
لم يقع بعد أي حدث مطابق لاشتراكك. أرسل اختبارًا لتأكيد الربط.
إبقاؤه سليمًا
- رُد بسرعة، بحالة 2xx. ونفّذ العمل البطيء بعد الإقرار. فالمستقبِل الذي يستغرق ثوانٍ للرد سيبدو كأنه فشل.
- توقّع الحدث نفسه أكثر من مرة. اجعل معالجك آمنًا عند تشغيله مرتين على الحدث نفسه بدل افتراض التسليم مرة واحدة تمامًا.
- اشترك بضيق. فإضافة حدث لاحقًا أسهل من معرفة أي خمسة عشر حدثًا يسبب المشكلة.