لاگ اِن کریںفری ٹرائل شروع کریں
easyCoexistence آفیشل APIs

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 گھنٹے کی میسجنگ ونڈو کے اندر جواب دیتا ہے اور نئے میسجز آتے ہی آپ کے اینڈ پوائنٹ پر آگے بھیجے جاتے ہیں۔

263902037430900

وہ target_app_id جو Meta گفتگو کا کنٹرول پیج ان باکس کو دینے کے لیے فراہم کرتا ہے۔

2018300

ایرر کوڈ 10 کے تحت آنے والا سب کوڈ، اس میسج کے لیے جو اس لیے ناکام ہوا کہ گفتگو کسی اور ایپ کے کنٹرول میں ہے۔

24 hours

اگر شخص اتنی دیر تک میسج نہ کرے تو تھریڈ غیر فعال ہو جاتا ہے، اور اس کے بعد صرف ڈیفالٹ ایپ بھیج سکتی ہے۔

Up to 7 days

extend_thread_control کسی ایپ کے کنٹرول کو 24 گھنٹے کی جواب کی مدت سے آگے کتنا بڑھا سکتا ہے۔

Off by default

آپ کے بزنس 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 آبجیکٹ کے ذریعے، خود میسج کے ساتھ کنٹرول منتقل یا ختم کر سکتی ہے۔
Handing a conversation to the Page Inbox
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 دن کے اندر۔

1AI agentThe app that owns the thread replies to the person
2Hand overpass_thread_control to 263902037430900
3Page inboxPeople answer; a reply there also takes control
4IdleReleased, or 24 hours without a message from the person

جب 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 مشورہ دیتا ہے کہ ایپ کا کام مکمل ہوتے ہی کنٹرول چھوڑ دیا جائے، جواب کی مدت ختم ہونے کا انتظار نہ کیا جائے۔
EasyCoexistence کے ساتھ یہ کام کرنا

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 پر پہنچتے ہیں، جسے وہ سبسکرائب نہیں کرتی۔ روٹنگ کے بغیر دونوں انہیں وصول کرتے رہتے ہیں۔

مزید پڑھیں

Messenger Send API: فیس بک پیج سے میسج بھیجنافیس بک پیج POST /{page-id}/messages سے Messenger میسج کیسے بھیجتا ہے: PSID، messaging_type، ٹیکسٹ، اٹیچمنٹ، ریٹ لمٹس اور خرابیاں۔Messenger میسج ٹیگز 2026 میں: 24 گھنٹے کی ونڈو کے بعد Facebook پیج کیا بھیج سکتا ہے2026 میں Messenger کی 24 گھنٹے کی ونڈو کے بعد Facebook پیج کیا بھیج سکتا ہے: HUMAN_AGENT، CUSTOMER_FEEDBACK، تین ختم شدہ ٹیگز اور ان کے متبادل۔API کے ذریعے Messenger گفتگو کی ہسٹری پڑھناConversations API سے Facebook Page کی Messenger ہسٹری پڑھیں: /{page-id}/conversations، میسج فیلڈز، 20 میسج کی حد اور اجازتیں۔Facebook Page ویب ہک فیلڈز: مکمل فہرستMeta کی دستاویز کردہ 64 Facebook Page ویب ہک فیلڈز: feed، mention، messages جیسے Messenger فیلڈز، پروفائل فیلڈز، اور ہر ایک کی درکار اجازت۔Facebook Page کے لیے Messenger ویب ہک: میسجز اور منشن ایونٹسFacebook Page کے لیے Messenger میسجز اور منشنز کی ویب ہک فیلڈز: پے لوڈ کا ڈھانچہ، سینڈر آئی ڈیز، اور ایونٹس آپ کے اینڈ پوائنٹ تک کیسے پہنچتے ہیں۔Facebook ایرر 10: اجازت مسترد یا پیغام اجازت شدہ ونڈو سے باہرFacebook ایرر 10: ایپ کو اس کارروائی کی اجازت نہیں، یا Messenger پر پیغام اجازت شدہ ونڈو سے باہر بھیجا گیا۔ دونوں کے حل یہاں ہیں۔

دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔

کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔

  • 3 دن مفت
  • کسی بھی وقت منسوخ کریں
  • صرف آفیشل API
  • 24/7 نگرانی

تصدیق شدہ تاریخ