Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

API-ul profilului Messenger: text de salut, butonul Get Started, ice breakers și meniul persistent

Profilul Messenger al unei Pagini Facebook se setează la /{page-id}/messenger_profile cu un token de acces al Paginii și pages_messaging: POST scrie proprietăți precum get_started, greeting, ice_breakers, persistent_menu și commands, GET le citește cu fields, iar DELETE șterge pe cele numite într-un array-ul fields. Meta permite 10 apeluri la fiecare 10 minute pe Pagină, iar doar proprietățile trimise sunt suprascrise.

easyCoexistence răspunde conversațiilor Messenger ale unei Pagini cu send_social_dm în fereastra de 24 de ore, din Claude, ChatGPT sau din propriul cod, cu mesajele noi transmise endpoint-ului dumneavoastră pe măsură ce sosesc.

10 per 10 min

Apeluri permise ale API-ului Messenger Profile per Pagină, în fiecare interval de 10 minute.

4 questions

Numărul maxim de ice breakers setate prin API; când sunt setate ambele, cele din API au prioritate față de butonul Get Started.

20 items

Numărul maxim de elemente de nivel superior dintr-un meniu persistent; titlul fiecărui element este limitat la 30 de caractere.

24 hours

Cât poate dura o actualizare a meniului persistent la nivel de Pagină; un meniu setat pentru o persoană se actualizează în timp real.

Deprecated

Textul de salut, despre care ghidul Meta spune că nu mai funcționează pe Messenger pentru Android și iOS.

Ce conține profilul Messenger?

Setările de la care pornește experiența Messenger a unei Pagini. API-ul Messenger Profile listează aceste proprietăți, fiecare setată și citită pe același endpoint; pentru o aplicație în modul Development, setările sunt vizibile doar persoanelor cu un rol în aplicație:

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

Cum se citesc, se setează și se șterg proprietățile?

Prin trei metode pe același endpoint, apelate cu token-ul Paginii. POST primește un corp JSON cu proprietăți și suprascrie doar pe cele numite, GET primește fields ca listă separată prin virgulă, iar DELETE primește un corp JSON al cărui array fields numește ce se șterge; POST și DELETE răspund cu result success. Setarea unui buton Get Started și a unui meniu într-un singur apel:

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

Cum funcționează butonul Get Started?

Apare pe ecranul de bun venit, care afișează numele Paginii, fotografia de profil, fotografia de copertă și cât timp îi ia de obicei firmei să răspundă. O atingere trimite Get Started în conversație, transmite get_started.payload către aplicație ca eveniment messaging_postbacks și deschide fereastra standard de mesagerie. Meta notează că butonul nu este acceptat când Messenger rulează în browserul din aplicația Facebook, iar meniul persistent necesită ca el să fie setat mai întâi.

Textul de salut mai funcționează?

Nu pe telefoane. Referința Meta are acum titlul [Deprecated] Greeting Text: funcția nu mai funcționează pe Messenger pentru Android și iOS, iar API-ul poate accepta în continuare proprietatea greeting, dar clienții nu o vor vedea, așa că Meta cere dezvoltatorilor să o evite. Conform documentației, greeting conține un text per limbă, cu default obligatoriu, de până la 160 de caractere, personalizat cu {{user_first_name}}, {{user_last_name}} sau {{user_full_name}}, iar setarea lui necesită rolul de Administrator al Paginii.

Cum funcționează ice breakers?

Acestea listează până la 4 întrebări pe care o persoană le poate apăsa pentru a deschide o conversație; întrebarea apare în conversație ca și cum ar fi întrebat-o persoana, iar payload-ul ei revine ca eveniment postback. Din aprilie 2022 sunt localizate: fiecare obiect din ice_breakers conține call_to_actions și un locale, o limbă implicită este obligatorie, iar un DELETE al ice_breakers le șterge pe toate. Meta ierarhizează elementele care concurează pentru o conversație nouă:

  • Ice breakers din API au prioritate față de butonul Get Started când sunt setate ambele.
  • Ambele sunt înaintea întrebărilor personalizate setate în inbox-ul Paginii, a cărui editare este dezactivată cât timp sunt setate ice breakers din API.

Cum este construit meniul persistent?

Ca array de meniuri, câte unul pe limbă, cu default obligatoriu, fiecare conținând până la 20 de call_to_actions de tipul web_url sau postback. Un titlu are până la 30 de caractere, iar payload-ul unui postback până la 1,000, iar composer_input_disabled setat pe true lasă meniul, butoanele și webview-urile ca singurul mod de interacțiune. Cerințele Meta înainte ca meniul să apară:

  • Un buton Get Started deja setat și permisiunea pages_messaging.
  • O Pagină publicată și aplicația setată ca publică.
  • Rolul de Administrator al Paginii pentru cel care o setează.
  • Messenger v106 sau mai nou pe iOS sau Android, în afara browserului din aplicația Facebook.
  • Modificările la nivel de Pagină pot dura până la 24 de ore; un meniu pentru o persoană, setat prin custom_user_settings cu un PSID, se actualizează în timp real.

Ce sunt comenzile?

Cuvinte-cheie pe care o persoană le poate invoca oricând, dintr-un meniu de comenzi lângă câmpul de scriere, tastând o bară oblică (/) sau un simbol @, ori dintr-o fereastră pop-up când scrie un cuvânt potrivit. Fiecare limbă are între 1 și 100 de comenzi, cu un name de 1 până la 32 de caractere, fără slash inițial, și o description de 1 până la 64; când sunt setate comenzi, ele au prioritate față de meniul persistent. Comenzile invocate ajung în aplicație în evenimentul messages, în message.commands.

Ce fac whitelisted_domains și account_linking_url?

Ambele servesc experiențe din afara conversației propriu-zise. whitelisted_domains listează până la 50 de domenii pe care webview-ul Messenger le poate deschide pentru Messenger Extensions SDK și pentru pluginul checkbox, fiecare servit prin HTTPS sub un nume complet calificat, niciodată o adresă IP sau localhost, iar setarea lui necesită rolul de Administrator al Paginii. account_linking_url este callback-ul HTTPS care leagă contul Messenger al unei persoane de contul ei la firmă.

Cum setează easyCoexistence profilul Messenger al unei Pagini?

Nu: niciun instrument nu apelează {page-id}/messenger_profile, iar token-urile Paginii nu sunt predate, deci setarea profilului este în afara acestei conexiuni. Comenzile invocate de persoane ajung în evenimentul messages pe care easyCoexistence îl transmite și pe care le procesează automatizările; atingerile pe care Meta le raportează ca evenimente messaging_postbacks, din Get Started, elementele de meniu postback și ice breakers, nu sunt transmise, deoarece Paginile sunt abonate la feed, messages și mention.

Greșeli frecvente

  • Setarea unui meniu persistent înainte de Get Started. Cerințele Meta includ un buton Get Started, deci setați mai întâi get_started.
  • Lipsa limbii implicite. Ice breakers, meniurile și comenzile au nevoie fiecare de un obiect cu locale setat pe default, ca rezervă.
  • Apelarea în buclă a API-ului de profil. Meta permite 10 apeluri la 10 minute pe Pagină, deci puneți mai multe proprietăți într-un singur POST.
  • Așteptarea unei modificări imediate a meniului. O actualizare a meniului la nivel de Pagină poate dura până la 24 de ore să ajungă la persoane.
Faceți acest lucru cu EasyCoexistence

Setarea profilului Messenger nu se numără printre instrumentele sale. US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.

Întrebări frecvente

Un meniu persistent poate fi diferit pentru fiecare persoană?

Da. custom_user_settings cu PSID-ul persoanei suprascrie meniul Paginii pentru acea persoană, se actualizează în timp real și permite 10 apeluri la 10 minute pentru fiecare persoană.

Ce limbi acceptă profilul Messenger?

Cele din lista Meta cu limbile acceptate, precum en_GB, pt_BR sau ja_JP, plus default, varianta de rezervă folosită când nicio limbă nu se potrivește cu cea a persoanei.

Cine poate modifica profilul Messenger al unei Pagini?

O aplicație cu un token al Paginii care are pages_messaging. Meniul persistent, textul de salut și lista de domenii necesită și rolul de Administrator al Paginii.

Cât costă easyCoexistence pentru o Pagină Facebook?

Fiecare Pagină este o conexiune: US$ 9 până la US$ 0,75 pe conexiune pe lună, prețul scăzând pe măsură ce crește numărul conexiunilor, iar primele 3 zile sunt gratuite.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la