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

Messenger profile API: گریٹنگ، Get Started بٹن، آئس بریکرز اور پرسسٹنٹ مینو

Facebook Page کا Messenger پروفائل /{page-id}/messenger_profile کے ذریعے سیٹ ہوتا ہے، جس کے لیے Page ایکسیس ٹوکن اور pages_messaging درکار ہیں۔ POST میں get_started، greeting، ice_breakers، persistent_menu اور commands جیسی properties لکھی جاتی ہیں، GET انہیں fields کے ساتھ پڑھتا ہے، اور DELETE fields array میں نام لی گئی properties ہٹا دیتا ہے۔ Meta ہر Page کے لیے ہر 10 منٹ میں 10 کالز کی حد لگاتا ہے، اور صرف بھیجی گئی properties اوور رائٹ ہوتی ہیں۔

easyCoexistence Page کی Messenger کنورسیشنز کا جواب 24 گھنٹے کی ونڈو کے اندر send_social_dm سے دیتا ہے، Claude، ChatGPT یا آپ کے اپنے کوڈ سے، اور نئے میسجز آتے ہی آپ کے endpoint پر آگے بھیجے جاتے ہیں۔

10 per 10 min

Messenger Profile API کالز کی وہ تعداد جو ہر Page کے لیے ہر 10 منٹ کے وقفے میں اجازت یافتہ ہے۔

4 questions

API کے ذریعے سیٹ کیے جانے والے آئس بریکرز کی زیادہ سے زیادہ تعداد؛ دونوں سیٹ ہوں تو API کے آئس بریکرز Get Started بٹن پر فوقیت رکھتے ہیں۔

20 items

پرسسٹنٹ مینو کے سب سے اوپر کے آئٹمز کی زیادہ سے زیادہ تعداد؛ ہر آئٹم کے عنوان کی حد 30 حروف ہے۔

24 hours

Page سطح کی پرسسٹنٹ مینو اپ ڈیٹ میں لگنے والا زیادہ سے زیادہ وقت؛ کسی ایک شخص کے لیے سیٹ کیا گیا مینو حقیقی وقت میں اپ ڈیٹ ہوتا ہے۔

Deprecated

گریٹنگ ٹیکسٹ، جو Meta کے گریٹنگ ریفرنس کے مطابق اب Messenger for Android اور iOS پر کام نہیں کرتا۔

Messenger profile میں کیا ہوتا ہے؟

وہ ترتیبات جن سے کسی Page کا Messenger تجربہ شروع ہوتا ہے۔ Meta کا Messenger Profile API یہ properties فہرست کرتا ہے، ہر ایک اسی اینڈ پوائنٹ پر سیٹ اور پڑھی جاتی ہے؛ Development Mode میں موجود ایپ کے لیے یہ ترتیبات صرف ان لوگوں کو نظر آتی ہیں جن کا ایپ پر کوئی رول ہو:

get_startedThe payload sent as a messaging_postbacks event when someone taps Get Started
greetingLocale-specific welcome screen text, which Meta marks deprecated as of November 2026
ice_breakersUp to 4 questions a person can tap to start the conversation
persistent_menuUp to 20 buttons kept in the conversation, per locale
commandsKeywords a person can tap or type, each with a description
whitelisted_domainsUp to 50 HTTPS domains for the Messenger Extensions SDK and the checkbox plugin
account_linking_urlThe HTTPS callback for linking a person's account with the business
subject_to_new_eu_privacy_rulesRead-only flag for Pages affected by Meta's Messenger API updates for Europe

properties کیسے پڑھی، سیٹ اور حذف کی جاتی ہیں؟

ایک اینڈ پوائنٹ پر تین methods سے، Page کے ٹوکن کے ساتھ۔ POST ایک JSON body لیتا ہے جس میں properties ہوتی ہیں اور صرف نام لی گئی properties کو اوور رائٹ کرتا ہے، GET fields کو کاما سے الگ فہرست کے طور پر لیتا ہے، اور DELETE ایک JSON body لیتا ہے جس کا fields array بتاتا ہے کہ کیا ہٹانا ہے؛ POST اور DELETE دونوں result success کے ساتھ جواب دیتے ہیں۔ ایک کال میں Get Started بٹن اور مینو سیٹ کرنا:

Get Started and a persistent menu in one POST
POST /{page-id}/messenger_profile
{
  "get_started": { "payload": "GET_STARTED" },
  "persistent_menu": [
    {
      "locale": "default",
      "composer_input_disabled": false,
      "call_to_actions": [
        { "type": "postback", "title": "Talk to an agent", "payload": "AGENT" },
        { "type": "web_url", "title": "Shop now", "url": "https://example.com/shop" }
      ]
    }
  ]
}

{ "result": "success" }

Get Started بٹن کیسے کام کرتا ہے؟

یہ ویلکم اسکرین پر ہوتا ہے، جو Page کا نام، پروفائل تصویر اور کور فوٹو دکھاتی ہے، اور یہ بھی کہ کاروبار عموماً جواب دینے میں کتنا وقت لیتا ہے۔ ٹیپ کرنے پر کنورسیشن میں Get Started بھیجا جاتا ہے، get_started.payload ایپ کو messaging_postbacks event کے طور پر بھیجا جاتا ہے اور معیاری messaging window کھل جاتی ہے۔ Meta بتاتا ہے کہ یہ بٹن اس وقت سپورٹ نہیں ہوتا جب Messenger، Facebook ایپ کے ان ایپ براؤزر میں چلتا ہو، اور پرسسٹنٹ مینو کے لیے پہلے اسی کا سیٹ ہونا ضروری ہے۔

کیا greeting text اب بھی کام کرتا ہے؟

فون پر نہیں۔ Meta کا ریفرنس اب [Deprecated] Greeting Text کے عنوان سے ہے: یہ فیچر Messenger for Android اور iOS پر کام نہیں کرتا، اور اگرچہ API greeting property قبول کر سکتا ہے، گاہک اسے نہیں دیکھیں گے، اس لیے Meta ڈیولپرز سے اسے استعمال نہ کرنے کو کہتا ہے۔ جیسا کہ دستاویز میں درج ہے، greeting ہر لوکیل کے لیے ایک متن رکھتا ہے، default لازمی ہے، 160 حروف تک، {{user_first_name}}، {{user_last_name}} یا {{user_full_name}} کے ساتھ ذاتی بنایا جا سکتا ہے، اور اسے سیٹ کرنے کے لیے Page پر Administrator رول درکار ہے۔

آئس بریکرز کیسے کام کرتے ہیں؟

یہ 4 تک سوالات کی فہرست دیتے ہیں جنہیں کوئی شخص ٹیپ کر کے کنورسیشن شروع کر سکتا ہے؛ سوال تھریڈ میں ایسے پوسٹ ہوتا ہے جیسے شخص نے خود پوچھا ہو، اور اس کا payload postback event کے طور پر واپس آتا ہے۔ اپریل 2022 سے یہ مقامی بنائے گئے ہیں: ice_breakers کا ہر object call_to_actions اور locale رکھتا ہے، default locale لازمی ہے، اور ice_breakers پر DELETE ان سب کو ہٹا دیتا ہے۔ Meta وہ عناصر درجہ بند کرتا ہے جو نئی کنورسیشن کے لیے آپس میں مقابلہ کرتے ہیں:

  • دونوں سیٹ ہوں تو API کے آئس بریکرز Get Started بٹن پر فوقیت رکھتے ہیں۔
  • دونوں Page inbox میں سیٹ کیے گئے حسبِ ضرورت سوالات سے پہلے آتے ہیں، جن کی ایڈیٹنگ API آئس بریکرز سیٹ ہونے پر بند ہو جاتی ہے۔

پرسسٹنٹ مینو کیسے بنایا جاتا ہے؟

menus کی ایک array کے طور پر، ہر لوکیل کے لیے ایک، default لازمی، جس میں زیادہ سے زیادہ 20 call_to_actions ہوں، جو web_url یا postback قسم کے ہوں۔ عنوان 30 حروف تک، postback payload 1,000 تک ہو سکتا ہے، اور composer_input_disabled کو true پر رکھنے سے مینو، بٹن اور ویب ویوز ہی تعامل کا واحد ذریعہ رہ جاتے ہیں۔ ظاہر ہونے سے پہلے Meta کی شرائط:

  • پہلے سے سیٹ شدہ Get Started بٹن اور pages_messaging پرمیشن۔
  • ایک شائع شدہ Page، اور ایپ کا public ہونا۔
  • جو اسے سیٹ کرے اس کے لیے Page پر Administrator رول۔
  • iOS یا Android پر Messenger v106 یا اس کے بعد کا ورژن، Facebook ایپ کے ان ایپ براؤزر سے باہر۔
  • Page سطح کی تبدیلیاں 24 گھنٹے تک لگ سکتی ہیں؛ کسی ایک شخص کا مینو، جو custom_user_settings کے ذریعے PSID کے ساتھ سیٹ ہو، حقیقی وقت میں اپ ڈیٹ ہوتا ہے۔

commands کیا ہیں؟

وہ keywords جنہیں کوئی شخص کسی بھی وقت کمپوزر کے ساتھ والے commands مینو سے، سلیش یا ایٹ کا نشان ٹائپ کر کے، یا ملتا جلتا لفظ ٹائپ کرنے پر پاپ اوور سے استعمال کر سکتا ہے۔ ہر لوکیل میں 1 سے 100 commands ہوتی ہیں، جن کا نام 1 سے 32 حروف کا ہو، بغیر لیڈنگ سلیش کے، اور تفصیل 1 سے 64 حروف کی؛ commands سیٹ ہوں تو پرسسٹنٹ مینو پر ان کو ترجیح ملتی ہے۔ استعمال کی گئی commands، message.commands میں messages event کے اندر ایپ تک پہنچتی ہیں۔

whitelisted_domains اور account_linking_url کیا کرتے ہیں؟

دونوں گفتگو سے باہر کے تجربات کے لیے ہیں۔ whitelisted_domains زیادہ سے زیادہ 50 domains کی فہرست دیتا ہے جنہیں Messenger webview، Messenger Extensions SDK اور checkbox plugin کے لیے کھول سکتا ہے، ہر ایک HTTPS پر مکمل نام کے ساتھ پیش کیا جائے، کبھی IP پتہ یا localhost نہیں، اور اسے سیٹ کرنے کے لیے Page پر Administrator رول درکار ہے۔ account_linking_url وہ HTTPS callback ہے جو کسی شخص کے Messenger اکاؤنٹ کو کاروبار کے ساتھ اس کے اکاؤنٹ سے جوڑتا ہے۔

easyCoexistence کسی Page کا Messenger پروفائل کیسے سیٹ کرتا ہے؟

ایسا نہیں ہوتا: کوئی ٹول {page-id}/messenger_profile کو کال نہیں کرتا، اور Page ٹوکن حوالے نہیں کیے جاتے، اس لیے پروفائل سیٹ کرنا اس کنکشن سے باہر ہے۔ جو commands لوگ استعمال کرتے ہیں وہ messages event میں آتی ہیں جسے easyCoexistence آگے بھیجتا ہے اور آٹومیشنز پڑھتی ہیں؛ وہ ٹیپ جنہیں Meta messaging_postbacks events کے طور پر رپورٹ کرتا ہے، یعنی Get Started، postback مینو آئٹمز اور آئس بریکرز سے، آگے نہیں بھیجے جاتے، کیونکہ Pages feed، messages اور mention کو سبسکرائب ہیں۔

عام غلطیاں

  • Get Started سے پہلے پرسسٹنٹ مینو سیٹ کرنا۔ Meta کی شرائط میں Get Started بٹن شامل ہے، اس لیے پہلے get_started سیٹ کریں۔
  • default locale چھوڑ دینا۔ آئس بریکرز، مینو اور commands میں ہر ایک کو fallback کے طور پر locale کو default پر سیٹ کرنے والا object چاہیے۔
  • لوپ میں profile API کو بار بار کال کرنا۔ Meta ہر Page کے لیے ہر 10 منٹ میں 10 کالز کی اجازت دیتا ہے، اس لیے کئی properties ایک POST میں ڈالیں۔
  • مینو کی تبدیلی فوراً نظر آنے کی توقع۔ Page سطح کی مینو اپ ڈیٹ لوگوں تک پہنچنے میں 24 گھنٹے تک لگ سکتی ہے۔
EasyCoexistence کے ساتھ یہ کام کرنا

Messenger پروفائل سیٹ کرنا اس کے ٹولز میں شامل نہیں۔ US$ 9 سے US$ 0.75 فی کنکشن فی مہینہ، کنکشنز بڑھنے کے ساتھ قیمت کم ہوتی ہے، اور پہلے 3 دن فری ٹرائل ہے۔

اکثر پوچھے جانے والے سوالات

کیا پرسسٹنٹ مینو ہر شخص کے لیے مختلف ہو سکتا ہے؟

ہاں۔ custom_user_settings کے ساتھ کسی شخص کا PSID اس کے لیے Page کے مینو کو اوور رائٹ کرتا ہے، حقیقی وقت میں اپ ڈیٹ ہوتا ہے، اور فی شخص 10 منٹ میں 10 کالز کی اجازت دیتا ہے۔

Messenger profile کون سے لوکیلز سپورٹ کرتا ہے؟

وہ جو Meta کی سپورٹڈ لوکیلز فہرست میں ہیں، جیسے en_GB، pt_BR یا ja_JP، اور default بھی، جو اس وقت استعمال ہوتا ہے جب شخص کے لوکیل سے کوئی مماثل نہ ہو۔

Messenger profile کون بدل سکتا ہے؟

pages_messaging کے ساتھ Page ٹوکن رکھنے والی ایپ۔ پرسسٹنٹ مینو، greeting اور ڈومین فہرست کے لیے Page پر Administrator رول بھی درکار ہے۔

Facebook Page کے لیے easyCoexistence کی قیمت کیا ہے؟

ہر Page ایک کنکشن ہے: US$ 9 سے US$ 0.75 فی کنکشن فی مہینہ، کنکشنز کی تعداد بڑھنے کے ساتھ قیمت کم ہوتی ہے، اور پہلے 3 دن فری ٹرائل ہیں۔

مزید پڑھیں

Messenger Send API: فیس بک پیج سے میسج بھیجنافیس بک پیج POST /{page-id}/messages سے Messenger میسج کیسے بھیجتا ہے: PSID، messaging_type، ٹیکسٹ، اٹیچمنٹ، ریٹ لمٹس اور خرابیاں۔Messenger ہینڈ اوور پروٹوکول: AI ایجنٹ اور لوگوں کے درمیان پیج کا ان باکس بانٹنافیس بک پیج کی Messenger گفتگو ایپس اور پیج کے ان باکس کے درمیان کیسے منتقل ہوتی ہے: Conversation Routing، pass_thread_control اور تھریڈ کے مالک۔Messenger میسج ٹیگز 2026 میں: 24 گھنٹے کی ونڈو کے بعد Facebook پیج کیا بھیج سکتا ہے2026 میں Messenger کی 24 گھنٹے کی ونڈو کے بعد Facebook پیج کیا بھیج سکتا ہے: HUMAN_AGENT، CUSTOMER_FEEDBACK، تین ختم شدہ ٹیگز اور ان کے متبادل۔Facebook Page ویب ہک فیلڈز: مکمل فہرستMeta کی دستاویز کردہ 64 Facebook Page ویب ہک فیلڈز: feed، mention، messages جیسے Messenger فیلڈز، پروفائل فیلڈز، اور ہر ایک کی درکار اجازت۔Facebook Page کے لیے Messenger ویب ہک: میسجز اور منشن ایونٹسFacebook Page کے لیے Messenger میسجز اور منشنز کی ویب ہک فیلڈز: پے لوڈ کا ڈھانچہ، سینڈر آئی ڈیز، اور ایونٹس آپ کے اینڈ پوائنٹ تک کیسے پہنچتے ہیں۔Facebook Page API اجازتیں اور ایپ ریویو کی ضروریاتنو فیس بک پیج اجازتیں، ان سے کیا کھلتا ہے، اور Meta کا ایپ ریویو ان کے لیے کیا مانگتا ہے: ایڈوانسڈ ایکسیس، کاروباری تصدیق، اور اسکرین ریکارڈنگ۔

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

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

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

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