ويبهوكس الحالة

استقبل في نظامك حالة رسائل WhatsApp.

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

الإعداد في لوحة التحكم عرض Events API

Webhook POST https://seusistema.com/webhooks/wpp

{
  "id": "evt_0123456789abcdef",
  "event": "MESSAGE_DELIVERED",
  "timestamp": "2026-09-15T10:30:00Z",
  "message": {
    "id": "msg_123",
    "status": "delivered",
    "phone": "5511999999999"
  }
}

تدفق

تقوم WPP Marketing بإبلاغ نظامك عند تغيير الحالة.

تعد webhooks للحالة مفيدة للتدقيق، والمطابقة، ولوحات القيادة الداخلية، والدعم، والقواعد في نظامك الخاص.

01 أنت تقوم بتزويد عنوان URL

سجّل في اللوحة نقطة نهاية HTTPS من نظامك لتلقي الردود.

02 اختر الأحداث

فعل الحالات التي يحتاج نظامك لمعالجتها فقط لتجنب الضوضاء التشغيلية.

03 يتغير الوضع

يتم تطبيع الإنشاء أو التسليم أو القراءة أو الخطأ بنفس الطريقة بغض النظر عن الاتصال المختار.

04 استلم وتابع

يقوم الـ endpoint بمعالجة الـ payload وسجل التسليمات يصبح متاحًا في لوحة القيادة وعن طريق GET /webhooks.

الأحداث المتاحة والاستعلام عن التوصيلات.

تستخدم الأحداث الأربعة نفس العقدة في أي اتصال، وتتيح الـ API الاستعلام عن نتيجة كل محاولة تسليم.

POST MESSAGE_CREATED

تم إنشاء الرسالة في التدفق وتلقيت معرّفًا للتتبع.

Criação

POST MESSAGE_DELIVERED

تم تسليم الرسالة إلى المستلم عندما يُرجع القناة تأكيدًا.

Entrega

POST MESSAGE_READ

تمت قراءة الرسالة عندما تكون إشعار القراءة متاحًا.

Leitura

POST MESSAGE_ERROR

واجهت الرسالة خطأ أثناء الإرسال أو التحقق أو المعالجة.

Erro

GET /webhooks

عرض سجل التسليمات مع الحالة والمحاولات واستجابة HTTP والترقيم الصفحات. يتطلب صلاحية webhooks:read.

Logs

أفضل الممارسات

حضّر نقطة النهاية (endpoint) لديك لتلقي أحداث مكررة وغير مرتبة.

تعدّ webhooks عمليات تسليم بين الأنظمة. يجب على الـ backend الخاص بك الاستجابة بسرعة، تسجيل السجلات، والمعالجة بشكل idempotent.

HTTPS

استخدم عنوان URL آمنًا وعامًا ومستقرًا لاستلام أحداث الاسترجاع.

رد سريع

استجب بـ HTTP 200 أو 204 بعد استلام الحدث وعالج المهام طويلة التنفيذ في طابور داخلي.

اللامتغيرة (Idempotency)

استخدم معرفات الرسالة والحدث لمنع التكرار عند إعادة التسليم.

سجلات

سجِّل الحمولة (payload) والتاريخ وحالة HTTP ونتيجة المعالجة للمراجعة.

تنبيهات

استخدم MESSAGE_ERROR لتنبيه الدعم أو العمليات حول الإخفاقات التي تعيدها أي جهة اتصال.

فصل

تُعدّ webhooks الحالة ردودًا من WPP Marketing. لإرسال أحداث تجارية من المتجر، استخدم Events API.

هل تريد متابعة عمليات التسليم والأخطاء في نظامك؟

قم بإعداد عنوان URL في لوحة التحكم، اختر الحالات وتابع التسليمات في تقرير webhooks.

Configurar webhooks