إشعارات Webhooks الصادرة

توقيع محتوى الطلب الأصلي

اقرأ ترويسة التوقيع واستخرج الوقت والتوقيع، ثم احسب HMAC للوقت متبوعاً بنقطة ثم محتوى الطلب الأصلي تماماً. قارن التوقيع بزمن ثابت وارفض الطوابع الزمنية القديمة. تحقّق قبل تحليل الحدث أو معالجته.

x-evnao-signature: t=TIMESTAMP,v1=HEX
HMAC-SHA256(secret, timestamp + "." + rawBody)

التسليم وإعادة المحاولة

أعد استجابة 2xx خلال 10 ثوانٍ بعد قبول الحدث بأمان. تُعاد محاولة التسليم بفترات انتظار متزايدة وتتوقف بعد ثماني محاولات. تؤدي 20 حالة فشل متتالية لنقطة الاستقبال إلى تعطيلها؛ والتسليم الناجح يصفّر عدد إخفاقاتها.

x-evnao-delivery — استخدم معرّف التسليم لتجنّب معالجة التسليم نفسه مرتين. احفظه بشكل دائم مع نتيجة المعالجة. قد تصلك إعادة محاولة بعد قبول الخادم للحدث إذا ضاعت استجابته.

متطلبات الاتصال

استخدم رابط HTTPS عاماً ومباشراً. تُفحص عناوين DNS عند الإعداد والتسليم. تُرفض العناوين الخاصة والمحلية وعناوين الربط المحلي والروابط التي تحتوي بيانات دخول. لا يتبع التسليم أي تحويل، حتى داخل النطاق نفسه.

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

• ticket.created
• ticket.updated
• message.created
• conversation.rating.created
• knowledge.article.created
• knowledge.article.updated

لا يتضمن message.created الملاحظات الداخلية. حقول الحدث هي id وtype وcreatedAt وdata. تبقى أسماء الأحداث والترويسات كما هي في جميع اللغات.

الإعداد والتحقق من التسليم

1. أضف نقطة الاستقبال واختر الأحداث المطلوبة فقط. احفظ سر التوقيع في مخزن أسرار الخادم واضبط التحقق قبل تفعيل المعالجة.
2. راجع حالة التسليم والأخطاء الآمنة في إعدادات API. وضع اختبار في قائمة الإرسال لا يثبت وصوله؛ تحقق من الحدث المستلم ونتيجة التسليم.
3. عند استبدال سر التوقيع، حدّث نظام الاستقبال فوراً. تستخدم محاولات التسليم الجديدة السر الحالي؛ لا توفر Evnao فترة تداخل يُقبل فيها السر القديم.