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

استقبل في نظامك حالة رسائل 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 للحالة مفيدة للتدقيق، والمطابقة، ولوحات القيادة الداخلية، والدعم، والقواعد في نظامك الخاص.

يقوم webhook بإبلاغ نتيجة رسالة؛ إنه ليس طلب إرسال. استخدم Messaging API لإرسال الرسائل و Events API لتشغيل الأتمتة بواسطة أحداث تجارية مدعومة.

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 عام مع HTTPS وقم بتمكين الأحداث في لوحة التحكم. العقد الحالي لا يرسل توقيع HMAC؛ قم بتكوين الحماية والتحقق الملائمين للمستقبل دون افتراض وجود توقيع غير موجود.

رد سريع

أجب بـ HTTP 2xx خلال 15 ثانية ومعالجة المهام طويلة التشغيل في قائمة انتظار داخلية. لا يتم اتباع عمليات إعادة التوجيه.

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

استخدم معرّف الحدث، المرسل أيضاً في Webhook-Id، لتجنب المعالجة المكررة وقبول الأحداث غير المرتبة. يشير Webhook-Attempt إلى رقم المحاولة. يتم تسجيل وإرسال الأحداث الممكّنة فقط.

سجلات

عرض محاولات واستجابات HTTP في GET /webhooks مع webhooks:read. يتم الاحتفاظ بالسجلات المكتملة أو المسلمة أو التي فشلت نهائيًا لمدة 30 يومًا. احمِ البيانات الشخصية ومحتوى الرسائل في سجلاتك الخاصة.

محاولات جديدة

أخطاء اتصال، انتهاء مهلة واستجابات 408 أو 425 أو 429 أو 5xx قد تؤدي إلى ما يصل إلى سبع محاولات إجمالاً، بفواصل زمنية قدرها 1 و5 و15 دقيقة، و1 و6 و24 ساعة. يتم الالتزام بقيمة Retry-After حتى 24 ساعة. الأخطاء الأخرى من فئة 4xx توقف التسليم.

فصل

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

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

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

إعداد webhooks