أحداث المراسلة وتوفر Webhooks
تعرّف على متابعة أحداث الرسائل في تكاملك والواجهات المتاحة اليوم.
ربط تطبيقك
افتح قسم المطوّر ثم Webhooks وأضف عنوان HTTPS عامًا واختر الأحداث. احفظ سر التوقيع وأرسل اختبارًا وافتح سجل التسليم. يمكن للمالك والمسؤول والمطوّر إدارة عشر نقاط لكل مساحة عمل.
التحقق والتغطية
تحقق من HMAC SHA-256 باستخدام السر والطابع الزمني ونص JSON الخام. ارفض الطلبات الأقدم من خمس دقائق وامنع تكرار معرّف الحدث. تدعم الرسائل النصية وواتساب حالات الإرسال والتسليم والفشل والاستقبال، ويضيف واتساب القراءة. تتطلب أحداث تسليم البريد والارتداد تقارير المزوّد.
التوقيت والمحاولات
تُراجع السجلات عادة كل دقيقة وقد تتأخر تحت الضغط. تُعالج الرسائل المنشأة بعد التسجيل فقط وقد تفوت حالات وسيطة. تتم إعادة المحاولة بعد دقيقة وخمس وثلاثين دقيقة وساعتين وست ساعات بإجمالي ست محاولات. الترتيب غير مضمون وتحتفظ إعادة الإرسال بمعرّف الحدث.
المتطلبات والتوافق
يلزم HTTPS على المنفذ 443 وعنوان IPv4 عام. لا تُقبل الشبكات الخاصة أو الأسماء الداخلية أو إعادة التوجيه. مهلة الطلب عشر ثوانٍ. لم تتغير واجهات /v1. تستخدم الإدارة جلسة العميل وحماية CSRF. الأحداث قد تتضمن المستلم ونص الرسالة. الخدمة منفصلة عن PayPal.
Receiver example / مثال الاستقبال
Payload, signature verification and integration reference (English)