بروتوكول تسليم Messenger: مشاركة صندوق وارد الصفحة بين وكيل ذكاء اصطناعي والأشخاص
استبدلت Meta بروتوكول التسليم في Messenger بـ Conversation Routing، الذي يحتفظ باستدعاءات التحكم في المحادثة نفسها: يسلّم pass_thread_control محادثة إلى تطبيق آخر، مثل صندوق وارد الصفحة ومعرّف التطبيق 263902037430900، ويتولى take_thread_control المطالبة بها، ويطلب request_thread_control التحكم، ويعيدها release_thread_control إلى الوضع الخامل. عند تفعيل التوجيه، يتلقى التطبيق المتحكم في المحادثة رسائلها، ويتلقاها التطبيقات الأخرى عبر قناة standby.
يمنح easyCoexistence وكيل الذكاء الاصطناعي لديك محادثات Messenger الخاصة بالصفحة عبر موصل MCP واحد: يرد send_social_dm داخل نافذة الـ 24 ساعة، وتُحوَّل الرسائل الجديدة إلى نقطة النهاية (endpoint) الخاصة بك فور وصولها.
target_app_id الذي تمنحه Meta لتمرير التحكم في المحادثة إلى صندوق وارد الصفحة.
الرمز الفرعي (subcode) ضمن الخطأ 10 للرسالة التي فشلت لأن تطبيقاً آخر يتحكم في المحادثة.
إذا لم يرسل الشخص رسالة لهذه المدة، تصبح المحادثة خاملة، ولا يستطيع بعدها الإرسال سوى التطبيق الافتراضي.
المدى الذي يمكن أن يمدّ به extend_thread_control تحكم التطبيق بما يتجاوز نافذة زمن الاستجابة البالغة 24 ساعة.
تولّي التحكم في المحادثات مع Business AI الخاص بك؛ وعند إيقافه تفشل الرسائل غير الموسومة إلى محادثة Business AI بالخطأ 10 والرمز الفرعي 2018300.
ماذا حدث لبروتوكول التسليم؟
دمجته Meta في Conversation Routing. يقول دليلها إن Meta لم تعد تدعم بروتوكول التسليم لـ Messenger، وإن النشاطات التجارية نُقلت إلى Conversation Routing، وإن التوجيه متوافق مع معظم استدعاءات بروتوكول التسليم السابقة، فمن المتوقع أن تواصل pass_thread_control وtake_thread_control وخطاف الويب (webhook) messaging_handovers العمل. ما تغيّر هو من يقرر: يحدد النشاط التجاري تطبيقاً افتراضياً وقواعد توجيه في إعدادات الصفحة، ضمن Conversation Routing.
من يتحكم في المحادثة؟
تطبيق واحد في كل مرة، تسميه Meta مالك المحادثة (thread owner). تكون المحادثة نشطة ما دام الشخص والتطبيق المالك يتبادلان الرسائل، وتصبح خاملة عندما لا يكتب الشخص لمدة 24 ساعة أو عندما يتخلى المالك عن التحكم؛ وفي المحادثة الخاملة لا يستطيع الإرسال سوى التطبيق الافتراضي، ضمن نافذة المراسلة. تحدد قواعد التوجيه من يتولى المحادثة:
- التطبيق الافتراضي: التطبيق الذي يرد عندما لا يكون هناك تطبيق آخر مُعدّ أو يستجيب.
- توجيه Social routing: التطبيق الذي يتولى التحكم عندما يفتح الشخص محادثة خاملة أو ينقر على زر Get Started.
- توجيه الروابط (Link routing): تطبيق مخصص لكل رابط m.me.
- توجيه الحملات (Campaign routing): التطبيق المختار لإعلان Click-to-Messenger، ويتحكم في محادثة ذلك الإعلان طوال نافذة المراسلة، حتى 7 أيام.
أي الاستدعاءات تنقل التحكم بين التطبيقات؟
كل استدعاء هو طلب POST إلى نقطة النهاية (edge) الخاصة بالصفحة، مع تحديد recipient بمعرّف PSID للشخص، ويُعيد كل منها success true، ويقبل معظمها أيضاً سلسلة metadata يتسلمها التطبيق التالي:
pass_thread_control: يسلّم المحادثة إلى التطبيق فيtarget_app_id، الذي يتلقى حدثmessaging_handovers.release_thread_control: ينهي تحكم التطبيق ويعيد المحادثة إلى الوضع الخامل.take_thread_control: يجعل التطبيق المستدعي هو المالك، للتطبيقات التي يسمح لها النشاط التجاري بتولي التحكم.request_thread_control: يطلب التحكم في المحادثة.extend_thread_control: يُبقي التحكم بعد نافذة زمن الاستجابة البالغة 24 ساعة، حتى 7 أيام، مع تحديد المدة بالثواني.- عبر كائن
thread_controlيُرسل مع الرسالة نفسها، يمكن لـ Send API تمرير التحكم أو إطلاقه.
POST /{page-id}/pass_thread_control
?recipient={id:<PSID>}
&target_app_id=263902037430900
&metadata=Customer asked for a person
{ "success": true }كيف يتدخل الأشخاص في صندوق وارد الصفحة؟
بالرد. تتعامل Conversation Routing مع صندوق الوارد في Meta Business Suite بوصفه تطبيقاً متصلاً آخر، ويمكن للنشاط التجاري حتى أن يجعله الافتراضي؛ فعندما يرد أحد هناك على محادثة لا يتحكم فيها الصندوق، أو ينقلها إلى المجلد الرئيسي (Main)، يتولى الصندوق التحكم. يسلّم التطبيق المحادثة إلى الأشخاص بـ pass_thread_control وtarget_app_id بالقيمة 263902037430900، ويرسل التطبيق الذي ينقل رد الشخص بعد نافذة الـ 24 ساعة ذلك الرد بالوسم HUMAN_AGENT، خلال 7 أيام من آخر رسالة للشخص.
ماذا يحدث عندما يتولى Business AI من Meta محادثة؟
تتلقى التطبيقات الأخرى رسائل الشخص عبر قناة standby ولا ينبغي أن ترد عليها. يقول دليل Meta إن الرد يبدأ بعد حدث messaging_handovers مع pass_thread_control؛ وقد يحمل إشعار messages الحقلين admin_text وhandoff_reason، مثل human_requested أو purchase_intent، لكنه لا ينقل الملكية. وعند إيقاف تولّي التحكم في المحادثات مع Business AI الخاص بك، وهو الإعداد الافتراضي، يفشل الإرسال غير الموسوم إلى تلك المحادثة بالخطأ 10 والرمز الفرعي 2018300.
كيف يتحقق التطبيق من مالك المحادثة؟
يعيد الطلب GET /{page-id}/thread_owner، مع تحديد recipient بمعرّف PSID، معرّف app_id للتطبيق المالك وموعد انتهاء تحكمه، سواء أُرسل للمالك نفسه أو للتطبيق الافتراضي للصفحة. يجيب حقل is_owner في Conversations API عن السؤال نفسه لكل محادثة بعد تفعيل التوجيه، ويُظهر GET /{page-id}?fields=messaging_feature_status في الحقول المتعلقة بـ msgr_multi_app حالة Conversation Routing للصفحة.
ماذا يحدث بدون Conversation Routing؟
تسميه Meta السلوك الافتراضي، وهو مخصص لصفحة بتطبيق واحد متصل يستقبل الرسائل ويرد عليها بنفسه. تتلقى جميع التطبيقات المتصلة إشعارات الرسائل وقد ترد على الرسالة نفسها، ويُحظر take_thread_control حتى يُعيَّن تطبيق افتراضي، ولا يتوفر سوى توجيه الحملات. تنصح Meta في هذا الإعداد بتنسيق عمل التطبيق وصندوق الوارد حتى لا يرد أحد على الرسالة نفسها مرتين.
ماذا يفعل easyCoexistence في صندوق وارد مشترك؟
يشترك في كل صفحة في feed وmessages وmention، لا في messaging_handovers أو standby أو message_echoes؛ لذلك يمرر رسائل الشخص بينما يتلقاها تطبيقه، ولا يرى أحداث التسليم ولا الردود المرسلة من صندوق وارد الصفحة. يرسل send_social_dm رداً من نوع RESPONSE بدون thread_control، وعندما ترفض Meta الإرسال لأن تطبيقاً آخر يملك المحادثة، تُعيد الأداة الرمز 10 ورسالته إلى الذكاء الاصطناعي لديك. استدعاءات التحكم بالمحادثة وthread_owner وis_owner ليست من بين أدواته.
الأخطاء الشائعة
- الرد على رسائل standby. تصل هذه الرسائل إلى تطبيق لا يملك المحادثة؛ انتظر pass_thread_control قبل الرد.
- قراءة admin_text كتسليم. إشعار messages الذي يحمل سياق التسليم لا ينقل الملكية؛ الحدث messaging_handovers هو ما ينقلها.
- تشغيل ذكاء اصطناعي وصندوق الوارد جنباً إلى جنب دون توجيه. مع السلوك الافتراضي يستقبل الاثنان الرسالة، وتطلب Meta التنسيق لتفادي ردّين.
- الاحتفاظ بالمحادثة بعد انتهاء المسار. تنصح Meta بإنهاء التحكم فور انتهاء التطبيق من مهمته، بدل انتظار انقضاء زمن الاستجابة.
استدعاءات Meta للتحكم في المحادثة ليست من بين أدواته؛ إذ يتولى شخص المحادثة بالرد في صندوق وارد الصفحة. US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ينخفض كلما أضفت اتصالات، مع فترة تجريبية مجانية لأول 3 أيام.
الأسئلة الشائعة
هل يحتاج تطبيقان على الصفحة نفسها إلى Conversation Routing؟
توصي Meta بذلك عندما تكون عدة تطبيقات مراسلة متصلة ويجب أن يرد كل منها على محادثات معينة. مع تطبيق واحد يستقبل ويرد، يكفي السلوك الافتراضي.
كم تحتفظ المحادثة بتحكم التطبيق؟
حتى يتخلى عن التحكم أو تصبح المحادثة خاملة، أي بعد 24 ساعة من آخر رسالة للشخص. يضيف extend_thread_control وقتاً إضافياً حتى 7 أيام.
هل يصل الرد من صندوق وارد الصفحة إلى التطبيقات الأخرى؟
تستقبله التطبيقات المشتركة في message_echoes بوصفه صدى (echo) يحمل app_id لصندوق وارد الصفحة، أي 263902037430900، كما يوضح سجل التغييرات لدى Meta لإصدار Graph API v12.0 وما بعده.
ماذا يحدث لردود easyCoexistence عندما يرد الشخص من صندوق الوارد؟
مع تفعيل Conversation Routing يتولى صندوق الوارد التحكم، وحتى يعود التحكم تصل رسائل الشخص إلى تطبيق easyCoexistence في وضع الاستعداد فقط، وهو لا يشترك فيه. بدون التوجيه، يستمر وصول الرسائل إلى الطرفين.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في