إعداد Webhooks الواردة والصادرة

استقبل أحداث المصدر وأشعر الأنظمة الخارجية وافحص نتائج التسليم.

اختيار الاتجاه والمالك

الوارد يستقبل أحداث النظام الخارجي، والصادر يرسلها لنقطة اتصالك. توجد Webhooks التكامل في تبويب التكامل، وللأتمتة شاشة الأتمتة → Webhooks. استخدم المصدر المحدد في إعداد السير أو التكامل ولا تخمّن الرابط.

الإعداد والاختبار

  1. افتح تبويب Webhooks للتكامل أو شاشة الأتمتة بصلاحية الإدارة.
  2. أنشئ اسماً واضحاً وحدد الاتجاه والأحداث المدعومة والحالة. للصادر أدخل رابط نقطة اتصالك والترويسات المدعومة.
  3. للوارد انسخ الرابط المعروض للمصدر المهيأ واحتفظ بالسر بشكل خاص.
  4. أكد عقد المصادقة والتوقيع والحمولة مع منفذ التكامل أو الخادم. لا تستخدم وصفة اتجاه مختلف.
  5. أرسل حدثاً تجريبياً منزوع الأسرار أو استخدم الاختبار. لسير العمل افحص المصدر والحدث والحمولة الملتقطة.
  6. افحص السجل وحالة HTTP والرد أو الخطأ وعدد الإعادات عند عرضها. تحقق من النتيجة التجارية مستقلاً.

تنفيذ نقطة الاتصال

استخدم HTTPS وتحقق من الحمولة وفق العقد. افحص التوقيع على البايتات الأصلية وبالطريقة المتفق عليها. تعامل مع التكرار بأمان. عداد الإعادة لا يثبت جدول إعادة مضموناً؛ أكده مع مالك الخادم.

النتيجة والاستعادة

يصل الحدث للمستهلك المقصود بأثر تجاري غير مكرر. عند الفشل راجع النشاط والاتجاه والاسم والمصادقة والشروط وربط المستلم والخطأ. نجاح HTTP لا يثبت اكتمال سير العمل.