IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

API ya wasifu wa Messenger: salamu, kitufe cha Get Started, vianzishi vya mazungumzo na menyu ya kudumu

Wasifu wa Messenger wa Ukurasa wa Facebook huwekwa kupitia /{page-id}/messenger_profile kwa token ya Ukurasa na ruhusa ya pages_messaging: POST huandika sifa kama get_started, greeting, ice_breakers, persistent_menu na commands, GET husoma sifa kwa kutumia fields, na DELETE huondoa zile zilizotajwa katika orodha ya fields. Meta inaruhusu miito 10 kwa kila dakika 10 kwa kila Ukurasa, na sifa zilizotumwa pekee ndizo zinazoandikwa upya.

easyCoexistence hujibu mazungumzo ya Messenger ya Ukurasa kwa send_social_dm ndani ya dirisha la saa 24, kutoka kwa Claude, ChatGPT au msimbo wako mwenyewe.

10 per 10 min

Idadi ya miito ya API ya Messenger Profile inayoruhusiwa kwa kila Ukurasa katika kila muda wa dakika 10.

4 questions

Idadi kubwa zaidi ya vianzishi vya mazungumzo ambavyo API inaweza kuweka; vikiwa vyote viwili vimewekwa, vya API vina kipaumbele kuliko kitufe cha Get Started.

20 items

Idadi kubwa zaidi ya vipengee vya juu katika menyu ya kudumu; jina la kila kipengee linaruhusu herufi 30 pekee.

24 hours

Muda ambao sasisho la menyu ya kudumu kwa kiwango cha Ukurasa linaweza kuchukua; menyu iliyowekwa kwa mtu mmoja husasishwa papo hapo.

Deprecated

Maandishi ya salamu, ambayo mwongozo wa salamu wa Meta unasema hayafanyi kazi tena kwenye Messenger ya Android na iOS.

Wasifu wa Messenger una nini?

Mipangilio ambayo uzoefu wa Messenger wa Ukurasa unaanzia nayo. API ya Messenger Profile ya Meta inaorodhesha sifa hizi, kila moja ikiwekwa na kusomwa kwenye endpoint ile ile. Kwa programu iliyo katika Development Mode, mipangilio hiyo inaonekana tu kwa watu wenye jukumu kwenye programu:

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

Sifa zinasomwa, kuwekwa na kufutwa vipi?

Kwa mbinu tatu kwenye endpoint moja, zikitumiwa na token ya Ukurasa. POST hupokea maudhui ya JSON yenye sifa na kuandika juu ya zile tu inazozitaja, GET hupokea fields kama orodha iliyotenganishwa kwa koma, na DELETE hupokea maudhui ya JSON ambayo orodha ya fields inataja kile cha kuondoa. POST na DELETE hujibu kwa result success. Kuweka kitufe cha Get Started na menyu kwa mwito mmoja:

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" }

Kitufe cha Get Started kinafanyaje kazi?

Kinakaa kwenye skrini ya kukaribisha, inayoonyesha jina la Ukurasa, picha ya wasifu na picha ya jalada, pamoja na muda ambao biashara kwa kawaida huchukua kujibu. Mtu akikigusa, Get Started huingizwa kwenye mazungumzo, get_started.payload hutumwa kwenye programu kama tukio la messaging_postbacks, na dirisha la kawaida la ujumbe hufunguka. Meta inaeleza kwamba kitufe hakiungwi mkono Messenger inapoendeshwa ndani ya kivinjari cha ndani cha programu ya Facebook, na menyu ya kudumu inahitaji kitufe hicho kuwekwa kwanza.

Je, maandishi ya salamu bado yanafanya kazi?

Si kwenye simu. Mwongozo wa Meta sasa unaitwa [Deprecated] Greeting Text: kipengele hakifanyi kazi tena kwenye Messenger ya Android na iOS. Ingawa API inaweza bado kukubali sifa ya greeting, wateja hawataiona, hivyo Meta inawaomba wasanidi waepuke kuitumia. Kama ilivyoandikwa, greeting huwa na maandishi moja kwa kila locale, default ikiwa ni lazima, yenye hadi herufi 160, na inabinafsishwa kwa {{user_first_name}}, {{user_last_name}} au {{user_full_name}}. Kuiweka kunahitaji jukumu la Msimamizi kwenye Ukurasa.

Vianzishi vya mazungumzo vinafanyaje kazi?

Vinaorodhesha maswali hadi 4 ambayo mtu anaweza kugusa ili kufungua mazungumzo. Swali huingizwa kwenye uzi kana kwamba mtu ndiye aliyeuliza, na payload yake hurudi kama tukio la postback. Tangu Aprili 2022 vinaweza kuwa katika lugha tofauti: kila kipengee katika ice_breakers kina call_to_actions na locale, locale ya default ni lazima, na DELETE ya ice_breakers huondoa vyote. Meta inapanga vipengele vinavyoshindania mazungumzo mapya:

  • Vianzishi vya API vina kipaumbele kuliko kitufe cha Get Started vikiwekwa vyote viwili.
  • Vyote viwili vinatangulia maswali maalum yaliyowekwa kwenye kikasha cha Ukurasa, ambacho kuhariri kwake kumezimwa wakati vianzishi vya API vimewekwa.

Menyu ya kudumu imejengwaje?

Kama safu ya menyu, moja kwa kila locale, default ikiwa ni lazima. Kila moja ina call_to_actions hadi 20 za aina web_url au postback. Jina linaruhusu herufi 30, na postback payload hadi 1,000. composer_input_disabled ikiwekwa kuwa true, menyu, vitufe na webviews ndivyo njia pekee ya kuingiliana. Mahitaji ya Meta kabla haijaonekana:

  • Kitufe cha Get Started kiwe tayari kimewekwa, na ruhusa ya pages_messaging.
  • Ukurasa uliochapishwa, na programu iwekwe kuwa ya umma.
  • Jukumu la Msimamizi kwenye Ukurasa kwa yeyote anayeiweka.
  • Messenger v106 au mpya zaidi kwenye iOS au Android, nje ya kivinjari cha ndani cha programu ya Facebook.
  • Mabadiliko ya ngazi ya Ukurasa yanaweza kuchukua hadi saa 24. Menyu ya mtu mmoja, iliyowekwa kupitia custom_user_settings kwa PSID, husasishwa papo hapo.

Amri ni nini?

Maneno muhimu ambayo mtu anaweza kuyaita wakati wowote, kutoka kwenye menyu ya amri karibu na sehemu ya kuandika ujumbe, kwa kuandika alama ya / au @, au kutoka kwenye dirisha ibukizi anapoandika neno linalolingana. Kila locale ina amri 1 hadi 100, zenye jina la herufi 1 hadi 32 bila / mwanzoni, na maelezo ya herufi 1 hadi 64. Amri zikiwekwa, zinatangulia menyu ya kudumu. Amri zinapoitwa hufika kwenye programu ndani ya tukio la messages, katika message.commands.

whitelisted_domains na account_linking_url hufanya nini?

Zote mbili zinahudumia uzoefu nje ya mazungumzo yenyewe. whitelisted_domains huorodhesha hadi domeni 50 ambazo webview ya Messenger inaweza kufungua kwa Messenger Extensions SDK na plugin ya checkbox. Kila moja hutolewa kupitia HTTPS chini ya jina kamili la kikoa, kamwe si anwani ya IP wala localhost. Kuiweka kunahitaji jukumu la Msimamizi kwenye Ukurasa. account_linking_url ni callback ya HTTPS inayounganisha akaunti ya Messenger ya mtu na akaunti yake na biashara.

easyCoexistence huweka wasifu wa Messenger wa Ukurasa vipi?

Hapana: hakuna zana inayoita {page-id}/messenger_profile, na token za Page hazitolewi, kwa hiyo kuweka wasifu ni nje ya muunganisho huu. Amri ambazo watu wanazitumia hufika kwenye tukio la messages ambalo easyCoexistence inalipeleka mbele na ambalo otomatiki husoma. Mibonyezo ambayo Meta inaripoti kama matukio ya messaging_postbacks, kutoka Get Started, vipengee vya menyu ya postback na vianzishi vya mazungumzo, haisambazwi, kwa kuwa Kurasa zimejiandikisha kwa feed, messages na mention.

Makosa ya kawaida

  • Kuweka menyu ya kudumu kabla ya Get Started. Mahitaji ya Meta yanajumuisha kitufe cha Get Started, kwa hiyo weka get_started kwanza.
  • Kuacha locale ya default. Vianzishi vya mazungumzo, menyu na amri kila kimoja kinahitaji kipengee chenye locale iliyowekwa kuwa default kama mbadala.
  • Kuita API ya wasifu kwenye kitanzi. Meta inaruhusu miito 10 kwa dakika 10 kwa kila Ukurasa, kwa hiyo weka sifa kadhaa katika POST moja.
  • Kutarajia mabadiliko ya menyu papo hapo. Sasisho la menyu ya ngazi ya Ukurasa linaweza kuchukua hadi saa 24 kuwafikia watu.
Kufanya hili ukitumia EasyCoexistence

Ujumbe mpya husambazwa kwenye endpoint yako unapowasili. Kuweka wasifu wa Messenger hakumo miongoni mwa zana zake. Kuanzia US$ 9 kwa kila muunganisho kwa mwezi hadi US$ 0.75 kadri unavyoongeza muunganisho, na siku 3 za kwanza ni bila malipo.

Maswali yanayoulizwa mara kwa mara

Je, menyu ya kudumu inaweza kutofautiana kwa kila mtu?

Ndiyo. custom_user_settings yenye PSID ya mtu huibatilisha menyu ya Ukurasa kwa mtu huyo, husasishwa papo hapo, na huruhusu miito 10 kwa kila mtu ndani ya dakika 10.

Ni lugha zipi wasifu wa Messenger unazoziunga mkono?

Zile zilizo kwenye orodha ya lugha zinazoungwa mkono na Meta, kama en_GB, pt_BR au ja_JP, pamoja na default, mbadala inayotumika pale ambapo hakuna locale inayolingana na ya mtu.

Nani anaweza kubadilisha wasifu wa Messenger wa Ukurasa?

Programu yenye token ya Ukurasa inayobeba pages_messaging. Menyu ya kudumu, maandishi ya salamu na orodha ya domeni pia zinahitaji jukumu la Msimamizi kwenye Ukurasa.

easyCoexistence inagharimu kiasi gani kwa Ukurasa wa Facebook?

Kila Ukurasa ni muunganisho mmoja: kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, bei ikishuka idadi ya miunganisho yako inapoongezeka, na siku 3 za kwanza ni bila malipo.

Endelea kusoma

Unganisha chaneli yako ya kwanza ndani ya dakika mbili.

Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.

  • Siku 3 bila malipo
  • Ghairi wakati wowote
  • API rasmi pekee
  • Hufuatiliwa saa 24/7

Imethibitishwa kwenye