دورة رسالة واتساب

اربط رقم أعمال مسجّلًا#

يتضمّن الخادم موصّل WhatsApp Cloud API مرتبطًا بهوية حساب أعمال ورقم هاتف. يحدّد الإعداد الارتباط وبيانات الاعتماد ورمز التحقّق ومسار الاستدعاء. يجب تفعيل التنفيذ وتسجيل القناة في البيئة قبل معالجة رسائل العملاء.

تحقّق واحفظ ثم أقرّ بالاستلام#

يوفّر العامل بعد إعداده GET وPOST على /v1/webhooks/whatsapp/{attachment_id}. يعالج GET تحدّي التحقّق. ويتحقّق POST من توقيع بايتات الطلب ومن هويّتَي حساب الأعمال ورقم الهاتف قبل تحويل الرسائل وإشعارات حالة التسليم.

تُحفظ الدفعة المقبولة كاملة قبل إرجاع 200. تُمنع ازدواجية الاستدعاءات المكرّرة. وتُسجّل الوسائط غير المدعومة كمدخلات غير مدعومة، ولا تُعامل تلقائيًا كرسائل نصية.

راجع المحادثة#

مثلًا، يسأل عميل عن حالة طلب قائم. يستطيع الوكيل المهيّأ استدعاء أداة القراءة المسموح بها واستخدام الأدلة المسترجعة ووضع الردّ في قائمة الإرسال. اقرأ المحادثة ودورات المعالجة والعمليات عبر واجهة المحادثات لمراجعة ما حدث.

تأتي رسائل واتساب الواردة من قناتها الموثّقة. المسار POST /v1/conversations/{id}/messages مخصّص لإدخال محادثات API؛ لا تستخدمه لمحاكاة رسالة واتساب واردة.

افصل قبول الإرسال عن التسليم#

تراجع قائمة الإرسال صلاحية الإرسال الحالية وإمكانات القناة واعتماد القالب عند الحاجة قبل التنفيذ. قبول المزوّد يختلف عن delivered أو read، ولا تلغي إشعارات التسليم المفقودة حالة مؤكّدة سابقة.

تتطلّب رسائل القوالب اللغة المعتمدة ومعلمات نصية موضعية في جسم القالب فقط. لا تفترض السماح بالمرفقات أو الأزرار أو ترجمة القالب أو إعادة الإرسال. إذا كانت نتيجة المحاولة غير معروفة، احتفظ بهذه الحالة للتحقّق منها.