حقول خطاف الويب (webhook) في WhatsApp، وأين يذهب كل منها

ماذا يحمل كل حقل؟

يحمل messages كل ما يرسله العميل إلى الرقم: النص، ومراجع الوسائط، والردود، والتفاعلات. ويحمل smb_message_echoes ما يرسله فريقك من تطبيق WhatsApp Business، وهو موجود فقط في رقم Coexistence، ومن خلاله ترى البرامج ردود الإنسان.

يحمل account_update حالة الاتصال، مثل PARTNER_REMOVED عند إلغاء تثبيت التطبيق من الحساب، و ACCOUNT_OFFBOARDED، و ACCOUNT_RECONNECTED، وأحداث التقييد أو المخالفة. ويحمل phone_number_quality_update تغييرات تقييم الجودة ومعدل النقل. ويحمل account_alerts التنبيهات التي ترفعها Meta ضد الحساب، بينما يحمل account_review_update نتيجة المراجعة.

يحمل business_capability_update تغييرات حد الرسائل والقدرات، ويحمل phone_number_name_update الموافقات على اسم العرض ورفضها.

لماذا يهم هذا الفصل من ناحية البنية؟

لأنه يحدد ما إذا كان محتوى المحادثة سيصل إلى مزود في أي وقت.

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

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

ما الحقول التي ينبغي أن يتوقعها المعالج؟

الحقلان الخاصان بالرسائل فقط عند ضبط التجاوز، ومن الأفضل أن يتجاهل المعالج أي شيء آخر بدل أن يفشل عند مواجهته.

تضيف Meta حقولًا بمرور الوقت، وقد يكتسب شكل الحمولة مفاتيح جديدة من دون إشعار. يظل المعالج الذي يختار بناءً على اسم الحقل ويتجاهل ما لا يتعرف إليه يعمل، أما الذي يفترض شكلًا ثابتًا فسيفشل عند أول حدث غير مألوف.

ومن المفيد أيضًا معالجة smb_message_echoes صراحةً بدل اعتباره ضجيجًا. فمن دونه، لا تعرف البرامج أن إنسانًا قد أجاب بالفعل، فينتهي الأمر بالعميل إلى تلقي ردين عن السؤال نفسه.

الأخطاء الشائعة

• افتراض وجود حمولة عامة. كل حدث يذكر حقله، وعلى المعالج الاختيار بناءً عليه.
• تجاهل smb_message_echoes. من دونه ترد البرامج فوق رد إنسان سبق أن أجاب.
• الفشل عند الحقول غير المعروفة بدل تخطيها. تضيف Meta حقولًا من دون طلب الإذن.

الأسئلة الشائعة

تابع القراءة