الطلب أو السلة أو الدفع أو الشحن أو الإلغاء أو التسجيل يتم في نظام المصدر.
واجهة برمجة تطبيقات الأحداث
أرسل أحداثًا من متجرك أو نظام ERP لتشغيل الأتمتة على WhatsApp.
استخدم Events API عندما يحتاج نظامك לדווח إلى WPP Marketing عن سلة، طلب، دفع، شحن، إلغاء أو إنشاء عميل.
تستقبل Events API الحدث التجاري وتستخدم الأتمتة المُكوَّنة. لإرسال رسالة مباشرة، استخدم الـ Messaging API. لتتبع التسليم، إشعارات القراءة والأخطاء، استخدم الـ webhooks الحالة.
تدفق
نظامك يبلغ عن الحدث. WPP Marketing يقرر الأتمتة.
تُعد Events API مثالية للمتاجر المخصصة، وأنظمة ERP، والـ back offices، والتكاملات التي لا تملك موصلًا plug-and-play.
يرسل الباك‑אנד الخاص بك الحدث مع التوكن والمعرّف والعميل والقيم والروابط المتاحة.
تفحص WPP Marketing ما إذا كانت هناك أتمتة نشطة لذلك الحدث ولتلك العميلة/العميل.
يتلقى العميل رسائل WhatsApp للاسترجاع، الدفع، الطلب، الشحن، الحملة أو ما بعد البيع.
الأحداث التجارية المدعومة.
يجب أن تتوافق التسمية النهائية والحقول الإلزامية مع وثائق Events API.
POST
cart.created
يسجل نية الشراء ويتيح التشغيل الآلي للمتابعة الأولية.
Carrinho
POST
cart.abandoned
يفعل استرداد العربة مع تذكير ورابط للعودة عند توفره.
Recuperação
POST
order.created
يُعلِم بإنشاء طلب أو في انتظار الدفع للرسائل المعاملاتية.
Pedido
POST
order.paid
يؤكد الدفع ويسمح برسالة تأكيد وتعليمات والخطوات التالية.
Pagamento
POST
order.shipped
يرسل تحديثات الشحن أو التتبع أو حالة اللوجستيات لتقليل التذاكر اليدوية.
Envio
POST
order.cancelled
يسجل إلغاء الطلب لتشغيل التواصل المُهيأ لهذا الحدث.
Cancelamento
POST
customer.created
يغذي قاعدة جهات الاتصال للترحيبات وإدارة العلاقات والوسوم والحملات.
Cliente
البيانات الموصى بها
كلما كان الحدث أفضل، كانت الأتمتة أفضل.
يجب أن تتلقى Events API بيانات كافية لتحديد العميل، عملية الشراء، المبلغ، الحالة، والروابط المفيدة للرسالة.
رقم الهاتف، الاسم، البريد الإلكتروني، البلد والمعرّف الخارجي تساعد في إزالة التكرارات والتجزئة.
الرقم، معرّف خارجي، الإجمالي، العملة، الحالة، طريقة الدفع والعناصر تجعل الرسالة أكثر فائدة.
يمكن استخدام صفحة الدفع (Checkout)، أو الدفع، أو تتبع الشحنة، أو صفحة الطلب في الرسائل الآلية.
زوّد external_id أو order.id وحافظ على ثبات المصدر. تضمّن إزالة التكرار الحساب والمصدر المُطبّع ونوع الحدث والمعرّف الخارجي. تعيد الأحداث المتكررة HTTP 200 مع العبارة Duplicate event ignored. لا يستخدم هذا endpoint ترويسة Idempotency-Key لواجهة Messaging API.
HTTP 200 يؤكد معالجة الحدث، لا تسليم رسالة. الإرسال يتطلب أتمتة نشطة للحدث، بيانات عميل صالحة، واتصال مكوّن. تتبع الرسالة عبر التقارير وwebhooks الحالة.
أنشئ بيانات اعتماد (credential) بصلاحية events:write وأرسل الأحداث من الخادم. احتفظ بالرمز (token) خارج الواجهة الأمامية والمستودعات العامة. استخدم customer.phone لرقم الهاتف وكائنات customer وorder كما في المثال وعقد OpenAPI.
هل تريد توصيل متجر مخصص أو نظام ERP؟
افتح وثائق Events API للتحقق من الحمولات (payloads) والمصادقة والأمثلة قبل إرسال الأحداث إلى بيئة الإنتاج.