خطاف الويب messages

ما الذي تحمله الحمولة؟

تسليم واحد قد يحتوي على رسالة واحدة أو أكثر، ولكل رسالة المرسل و id ونوع. يحدد type المفاتيح الأخرى الموجودة.

• رقم هاتف المرسل، و phone number id للرقم الذي كتب إليه.
• معرّف رسالة wamid، وهو الأساس الذي تُبنى عليه عملية منع التكرار.
• طابع زمني بنظام unix.
• نوع type: text أو image أو audio أو video أو document أو sticker أو location أو contacts أو reaction أو button أو interactive.
• بالنسبة إلى أنواع الوسائط، يوجد media id لجلب الوسائط بدلاً من تضمين البيانات نفسها.

لماذا لا يصل إلينا على رقم موجّه؟

لأن override ينقل هذا الحقل، إلى جانب smb_message_echoes، إلى الوجهة التي تحددها.\n\nتسمح Meta للتطبيق بتجاوز المكان الذي يسلّم فيه حساب WhatsApp Business خطافات الويب الخاصة به. نضبط هذا التجاوز على عنوان URL الخاص بك، فيخرج مسار الرسالة بالكامل من بنيتنا التحتية. لا توجد نسخة أو قائمة انتظار أو احتفاظ من جانبنا، لأن التسليم لا يصل إلينا أصلاً.\n\nعند عدم تحديد وجهة، تعود هذه الأحداث إلى callback الافتراضي لدينا، حيث يتجاهلها المعالج من دون حفظها. هذا هو الفرق بين ادعاء متعلق بالتخزين ومسار برمجي فعلي: لا يوجد مكان تذهب إليه محتويات المحادثة.

كيف تؤكد الاستلام بشكل صحيح؟

أعد 200 قبل تنفيذ العمل، لا بعده.\n\nتتعامل Meta مع الاستجابة البطيئة على أنها فشل وتعيد المحاولة، ما يعني أن المعالج الذي يعالج الطلب داخلياً سيرى الرسالة نفسها أكثر من مرة. أرسل الاستجابة فوراً، وضع الحمولة في قائمة انتظار أو مهمة تعمل في الخلفية، ودع المعالجة تحدث خارج الطلب.\n\nفي بيئات serverless هذا ليس اختيارياً. قد تتجمد الدالة التي تعيد الاستجابة ثم تواصل العمل بمجرد إرسالها، لذلك يجب أن يكون تأكيد الاستلام والمعالجة منفصلين فعلياً.

كيف تمنع التكرار؟

اعتمد دائماً على wamid، لأن إعادة المحاولة أمر طبيعي وليست حالة استثنائية.\n\nقد تصل الرسالة نفسها مرتين لأسباب لا علاقة لها بخلل من جانبك: استجابة بطيئة أو مهلة شبكة أو نشر إصدار أثناء التسليم. حفظ المعرّفات التي شوهدت وتخطي التكرارات لا يتطلب سوى بضعة أسطر، وهو الفارق بين الرد على العميل مرة واحدة والرد عليه مرتين.\n\nفي رقم Coexistence تزداد أهمية ذلك، لأن smb_message_echoes يصل عبر المسار نفسه، والمعالج الذي يعامل كل حدث كأنه جديد سيرد فوق رد بشري سبق أن أرسله فريقك.

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

• المعالجة قبل إعادة 200. تعيد Meta المحاولة عند بطء الاستجابة، فتعالج الرسالة مرتين.
• تخطي منع التكرار. إعادة المحاولة مصممة لتحدث وليست حالة نادرة.
• توقع وجود بيانات الوسائط داخل الحمولة. فهي تحمل media id لجلبها.

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

تابع القراءة