Webhooks

استقبال الأحداث

سجّل رابط ويبهوك في صفحة مفاتيح API ليصلك تنبيه فوري عند وصول رسائل واتساب أو تغيّر حالة الجلسة.

التحقق من التوقيع

كل طلب ويبهوك يحمل رأس X-Moatmt-Signature يحتوي توقيع HMAC-SHA256 لجسم الطلب الخام باستخدام السر الذي أدخلته في اللوحة. تحقّق منه دائمًا قبل معالجة البيانات.

الأحداث المدعومة

  • message.received — رسالة واردة من عميل.
  • message.sent — رسالة صادرة تم إرسالها بنجاح.
  • session.connected — جلسة اتصلت بواتساب.
  • session.disconnected — جلسة انفصلت.

نصائح

  • • أعِد الرد 200 بسرعة (أقل من 5 ثوانٍ).
  • • إذا ردّ خادمك بـ 4xx/5xx، تُسجَّل حالة التسليم في اللوحة.
  • • استعمل HTTPS فقط — الطلبات على HTTP سترفض.