Messenger ہینڈ اوور پروٹوکول: AI ایجنٹ اور لوگوں کے درمیان پیج کا ان باکس بانٹنا
Meta نے Messenger ہینڈ اوور پروٹوکول کی جگہ Conversation Routing متعارف کرائی ہے، جو تھریڈ کنٹرول کی کالز برقرار رکھتی ہے۔ pass_thread_control گفتگو کو کسی دوسری ایپ کے حوالے کرتی ہے، جیسے ایپ آئی ڈی 263902037430900 والا پیج ان باکس؛ take_thread_control اس پر کنٹرول لیتی ہے، request_thread_control اس کی درخواست کرتی ہے، اور release_thread_control اسے غیر فعال حالت میں لوٹا دیتی ہے۔ روٹنگ آن ہو تو جو ایپ تھریڈ کو کنٹرول کرتی ہے اسے اس کے میسجز ملتے ہیں، اور باقی ایپس انہیں standby چینل پر وصول کرتی ہیں۔
easyCoexistence آپ کے AI ایجنٹ کو ایک MCP کنیکٹر کے ذریعے پیج کی Messenger گفتگو دیتا ہے: send_social_dm 24 گھنٹے کی میسجنگ ونڈو کے اندر جواب دیتا ہے اور نئے میسجز آتے ہی آپ کے اینڈ پوائنٹ پر آگے بھیجے جاتے ہیں۔
وہ target_app_id جو Meta گفتگو کا کنٹرول پیج ان باکس کو دینے کے لیے فراہم کرتا ہے۔
ایرر کوڈ 10 کے تحت آنے والا سب کوڈ، اس میسج کے لیے جو اس لیے ناکام ہوا کہ گفتگو کسی اور ایپ کے کنٹرول میں ہے۔
اگر شخص اتنی دیر تک میسج نہ کرے تو تھریڈ غیر فعال ہو جاتا ہے، اور اس کے بعد صرف ڈیفالٹ ایپ بھیج سکتی ہے۔
extend_thread_control کسی ایپ کے کنٹرول کو 24 گھنٹے کی جواب کی مدت سے آگے کتنا بڑھا سکتا ہے۔
آپ کے بزنس AI کے ساتھ گفتگو کا کنٹرول لینے کی سیٹنگ بند ہو تو بغیر ٹیگ کے بھیجے گئے میسجز کوڈ 10 اور سب کوڈ 2018300 کے ساتھ ناکام ہوتے ہیں۔
ہینڈ اوور پروٹوکول کے ساتھ کیا ہوا؟
Meta نے اسے Conversation Routing میں شامل کر دیا ہے۔ اس کی گائیڈ کے مطابق Meta اب Messenger کے لیے ہینڈ اوور پروٹوکول کی معاونت نہیں کرتا، کاروبار Conversation Routing پر منتقل ہو چکے ہیں، اور روٹنگ زیادہ تر پرانی ہینڈ اوور کالز کے ساتھ مطابقت رکھتی ہے، اس لیے pass_thread_control، take_thread_control اور messaging_handovers ویب ہک کام کرتے رہنے چاہئیں۔ بدلاؤ یہ ہے کہ فیصلہ کون کرتا ہے: کاروبار اپنے پیج کی سیٹنگز میں Conversation Routing کے تحت ڈیفالٹ ایپ اور روٹنگ کے قواعد طے کرتا ہے۔
گفتگو کا کنٹرول کس کے پاس ہے؟
ایک وقت میں ایک ایپ، جسے Meta تھریڈ کا مالک کہتا ہے۔ تھریڈ اس وقت فعال ہوتا ہے جب شخص اور مالک ایپ بات چیت کر رہے ہوں، اور غیر فعال ہو جاتا ہے جب شخص 24 گھنٹے سے میسج نہ کرے یا مالک کنٹرول چھوڑ دے؛ غیر فعال تھریڈ میں صرف ڈیفالٹ ایپ میسجنگ ونڈو کے اندر بھیج سکتی ہے۔ روٹنگ کے قواعد طے کرتے ہیں کہ تھریڈ کون لے گا:
- ڈیفالٹ ایپ: وہ ایپ جو جواب دیتی ہے جب کوئی اور ایپ ترتیب نہ دی گئی ہو یا جواب نہ دے رہی ہو۔
- سوشل روٹنگ: وہ ایپ جو کنٹرول لیتی ہے جب شخص کسی غیر فعال تھریڈ کو کھولے یا Get Started دبائے۔
- لنک روٹنگ: ہر m.me لنک کے لیے مقرر کی گئی ایپ۔
- کیمپین روٹنگ: Click-to-Messenger اشتہار کے لیے منتخب ایپ، جو اس گفتگو کی میسجنگ ونڈو کے دوران، زیادہ سے زیادہ 7 دن تک، کنٹرول میں رہتی ہے۔
کون سی کالز ایپس کے درمیان کنٹرول منتقل کرتی ہیں؟
ہر کال Page کے edge پر POST کی جاتی ہے، جس میں 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 دن تک، مدت سیکنڈز میں دی جاتی ہے۔- Send API،
thread_controlآبجیکٹ کے ذریعے، خود میسج کے ساتھ کنٹرول منتقل یا ختم کر سکتی ہے۔
POST /{page-id}/pass_thread_control
?recipient={id:<PSID>}
&target_app_id=263902037430900
&metadata=Customer asked for a person
{ "success": true }پیج ان باکس میں لوگ کیسے مداخلت کرتے ہیں؟
لوگ جواب دے کر مداخلت کرتے ہیں۔ Conversation Routing، Meta کے بزنس سوٹ ان باکس کو ایک اور منسلک ایپ سمجھتی ہے، جسے کاروبار ڈیفالٹ بھی بنا سکتا ہے؛ جب کوئی وہاں ایسی گفتگو میں جواب دیتا ہے جو ان باکس کے کنٹرول میں نہیں، یا اسے Main فولڈر میں لے جاتا ہے، تو ان باکس کنٹرول لے لیتا ہے۔ ایک ایپ pass_thread_control اور target_app_id 263902037430900 کے ساتھ گفتگو لوگوں کے حوالے کرتی ہے، اور وہ ایپ جو 24 گھنٹے کی مدت کے بعد شخص کا جواب آگے بھیجتی ہے، اسے HUMAN_AGENT ٹیگ کے ساتھ بھیجتی ہے، شخص کے آخری میسج کے 7 دن کے اندر۔
جب Meta کا بزنس AI کسی گفتگو کا مالک ہو تو کیا ہوتا ہے؟
دوسری ایپس شخص کے میسجز standby چینل پر وصول کرتی ہیں اور انہیں جواب نہیں دینا چاہیے۔ Meta کی گائیڈ کہتی ہے کہ messaging_handovers ایونٹ کے ساتھ pass_thread_control آنے کے بعد جواب دینا شروع کریں؛ messages نوٹیفکیشن میں admin_text اور handoff_reason شامل ہو سکتے ہیں، جیسے human_requested یا purchase_intent، مگر یہ مالکیت منتقل نہیں کرتا۔ جب آپ کے بزنس AI کے ساتھ گفتگو کا کنٹرول لینے کی سیٹنگ بند ہو، جو ڈیفالٹ ہے، تو اس گفتگو میں بغیر ٹیگ کے بھیجا گیا میسج کوڈ 10 اور سب کوڈ 2018300 کے ساتھ ناکام ہوتا ہے۔
ایپ کیسے چیک کرتی ہے کہ تھریڈ کا مالک کون ہے؟
GET /{page-id}/thread_owner، جس میں recipient پر PSID رکھا گیا ہو، مالک ایپ کی app_id اور اس کا کنٹرول کب ختم ہوگا، واپس کرتا ہے، یہ جواب خود مالک کو یا پیج کی ڈیفالٹ ایپ کو ملتا ہے۔ روٹنگ آن ہونے کے بعد Conversations API کا is_owner فیلڈ ہر گفتگو کے لیے یہی سوال حل کرتا ہے، اور GET /{page-id}?fields=messaging_feature_status پیج کی Conversation Routing اسٹیٹس کو msgr_multi_app جیسے فیلڈز میں دکھاتا ہے۔
Conversation Routing کے بغیر کیا ہوتا ہے؟
Meta اسے ڈیفالٹ رویہ کہتا ہے، جو ایک ایسے پیج کے لیے ہے جس میں ایک منسلک ایپ ہو جو خود میسجز وصول اور جواب دیتی ہے۔ تمام منسلک ایپس میسجنگ ویب ہکس وصول کرتی ہیں اور ایک ہی میسج کا جواب دے سکتی ہیں، take_thread_control اس وقت تک بلاک رہتا ہے جب تک ڈیفالٹ ایپ مقرر نہ ہو، اور صرف کیمپین روٹنگ دستیاب ہوتی ہے۔ اس سیٹ اپ کے لیے Meta کا مشورہ ہے کہ ایپ اور پیج ان باکس میں ہم آہنگی رکھی جائے تاکہ کوئی ایک ہی میسج دو بار جواب نہ دے۔
easyCoexistence مشترکہ ان باکس میں کیا کرتا ہے؟
یہ ہر پیج کو feed، messages اور mention پر سبسکرائب کرتا ہے، messaging_handovers، standby یا message_echoes پر نہیں، اس لیے یہ شخص کے میسجز آگے بھیجتا ہے جبکہ اس کی ایپ انہیں وصول کرتی ہے، اور اسے نہ ہینڈ اوور ایونٹس نظر آتے ہیں نہ وہ جواب جو پیج ان باکس سے بھیجے جاتے ہیں۔ send_social_dm تھریڈ کنٹرول کے بغیر RESPONSE بھیجتا ہے، اور جب Meta کسی بھیجنے کو اس لیے رد کرے کہ گفتگو کسی اور ایپ کے پاس ہے، تو ٹول Meta کا کوڈ 10 اور میسج آپ کے AI کو واپس دیتا ہے۔ تھریڈ کنٹرول کالز، thread_owner اور is_owner اس کے ٹولز میں شامل نہیں۔
عام غلطیاں
- standby میسجز کا جواب دینا۔ یہ ایسی ایپ تک پہنچتے ہیں جو تھریڈ کی مالک نہیں؛ جواب دینے سے پہلے pass_thread_control کا انتظار کریں۔
- admin_text کو ہینڈ اوور سمجھنا۔ ہینڈ اوور سیاق والا messages نوٹیفکیشن مالکیت منتقل نہیں کرتا؛ یہ کام messaging_handovers ایونٹ کرتا ہے۔
- روٹنگ کے بغیر AI اور ان باکس ساتھ ساتھ چلانا۔ ڈیفالٹ رویے میں دونوں میسج وصول کرتے ہیں، اور 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 کی ایپ تک صرف standby پر پہنچتے ہیں، جسے وہ سبسکرائب نہیں کرتی۔ روٹنگ کے بغیر دونوں انہیں وصول کرتے رہتے ہیں۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ