InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Messenger-profiel-API: begroeting, Get Started-knop, ice breakers en vast menu

Het Messenger-profiel van een Facebook-pagina stel je in via /{page-id}/messenger_profile met een Page-toegangstoken en pages_messaging: POST schrijft eigenschappen zoals get_started, greeting, ice_breakers, persistent_menu en commands, GET leest ze uit met fields, en DELETE verwijdert de eigenschappen die in een fields-array worden genoemd. Meta staat 10 aanroepen per 10 minuten per pagina toe, en alleen de meegestuurde eigenschappen worden overschreven.

easyCoexistence beantwoordt de Messenger-gesprekken van een pagina met send_social_dm binnen het venster van 24 uur, vanuit Claude, ChatGPT of je eigen code, terwijl nieuwe berichten naar je endpoint worden doorgestuurd zodra ze binnenkomen.

10 per 10 min

Toegestane aanroepen van de Messenger Profile API per pagina in elk interval van 10 minuten.

4 questions

Het maximum aantal ice breakers dat de API instelt; als beide zijn ingesteld, gaan API-ice breakers voor op de Get Started-knop.

20 items

Het maximum aantal items op het hoogste niveau van een vast menu; de titel van elk item is beperkt tot 30 tekens.

24 hours

Hoe lang een update van het vaste menu op paginaniveau kan duren; een menu dat voor één persoon is ingesteld, wordt in realtime bijgewerkt.

Deprecated

Begroetingstekst, waarvan Meta's referentie zegt dat die niet meer werkt op Messenger voor Android en iOS.

Wat bevat het Messenger-profiel?

De instellingen waarvan de Messenger-ervaring van een pagina uitgaat. De Messenger Profile API van Meta somt deze eigenschappen op; elk wordt ingesteld en gelezen via hetzelfde endpoint. Voor een app in Development Mode zijn de instellingen alleen zichtbaar voor mensen met een rol in de app:

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

Hoe worden eigenschappen gelezen, ingesteld en verwijderd?

Met drie methoden op één endpoint, aangeroepen met het token van de pagina. POST neemt een JSON-body met eigenschappen en overschrijft alleen die welke erin staan, GET neemt fields als kommagescheiden lijst, en DELETE neemt een JSON-body waarvan de fields-array aangeeft wat moet worden verwijderd; POST en DELETE antwoorden met result success. Een Get Started-knop en een menu in één aanroep instellen:

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

Hoe werkt de Get Started-knop?

De knop staat op het welkomstscherm, dat de naam van de pagina, de profielfoto en de omslagfoto toont, en hoe lang het bedrijf gewoonlijk over een antwoord doet. Een tik stuurt Get Started in het gesprek, stuurt get_started.payload als messaging_postbacks-event naar de app en opent het standaard berichtenvenster. Meta meldt dat de knop niet wordt ondersteund wanneer Messenger draait in de ingebouwde browser van de Facebook-app, en een vast menu vereist dat deze knop eerst is ingesteld.

Werkt de begroetingstekst nog?

Niet op telefoons. De referentie van Meta heet nu [Deprecated] Greeting Text: de functie werkt niet meer op Messenger voor Android en iOS. De API accepteert de eigenschap greeting misschien nog, maar klanten zien hem niet, dus Meta vraagt ontwikkelaars hem te vermijden. Zoals gedocumenteerd bevat greeting per locale één tekst, met default verplicht, tot 160 tekens, gepersonaliseerd met {{user_first_name}}, {{user_last_name}} of {{user_full_name}}, en voor instellen heb je de rol Administrator op de pagina nodig.

Hoe werken ice breakers?

Ze tonen tot 4 vragen waarop iemand kan tikken om een gesprek te openen; de vraag wordt in de thread geplaatst alsof de persoon haar stelde, en de payload komt terug als postback-event. Sinds april 2022 zijn ze gelokaliseerd: elk object in ice_breakers bevat call_to_actions en een locale, een default-locale is verplicht, en een DELETE van ice_breakers verwijdert ze allemaal. Meta rangschikt de elementen die strijden om een nieuw gesprek:

  • API-ice breakers gaan voor op de Get Started-knop wanneer beide zijn ingesteld.
  • Beide komen vóór de eigen vragen die in de inbox van de pagina zijn ingesteld, waarvan het bewerken is uitgeschakeld zolang API-ice breakers actief zijn.

Hoe is het vaste menu opgebouwd?

Als array van menu's, één per locale met default verplicht, elk met tot 20 call_to_actions van het type web_url of postback. Een titel telt tot 30 tekens en een postback-payload tot 1.000, en composer_input_disabled op true zetten laat het menu, de knoppen en de webviews als enige manier om te reageren. Meta's vereisten voordat het verschijnt:

  • Een al ingestelde Get Started-knop en de permissie pages_messaging.
  • Een gepubliceerde pagina, en de app op openbaar gezet.
  • De rol Administrator op de pagina voor wie het instelt.
  • Messenger v106 of later op iOS of Android, buiten de ingebouwde browser van de Facebook-app.
  • Wijzigingen op paginaniveau kunnen tot 24 uur duren; een menu voor één persoon, ingesteld via custom_user_settings met een PSID, wordt in realtime bijgewerkt.

Wat zijn commando's?

Trefwoorden die iemand op elk moment kan aanroepen, vanuit een commandomenu naast het invoerveld, door een schuine streep of een at-teken te typen, of vanuit een pop-up wanneer diegene een passend woord typt. Elke locale bevat 1 tot 100 commando's, met een naam van 1 tot 32 tekens zonder schuine streep vooraan en een beschrijving van 1 tot 64; wanneer commando's zijn ingesteld, gaan ze voor op het vaste menu. Aangeroepen commando's bereiken de app binnen het messages-event, in message.commands.

Wat doen whitelisted_domains en account_linking_url?

Beide dienen ervaringen buiten het gesprek zelf. whitelisted_domains somt tot 50 domeinen op die de Messenger-webview mag openen voor de Messenger Extensions SDK en de checkbox-plugin, elk geserveerd via HTTPS onder een volledig gekwalificeerde naam, nooit een IP-adres of localhost, en voor instellen heb je de rol Administrator op de pagina nodig. account_linking_url is de HTTPS-callback die het Messenger-account van iemand koppelt aan diens account bij het bedrijf.

Hoe stelt easyCoexistence het Messenger-profiel van een pagina in?

Het niet: geen enkele tool roept {page-id}/messenger_profile aan, en tokens van de pagina worden niet verstrekt, dus het instellen van het profiel valt buiten deze verbinding. Commando's die mensen aanroepen komen aan in het messages-event dat easyCoexistence doorstuurt en dat automatiseringen lezen; tikacties die Meta meldt als messaging_postbacks-events, van de Get Started-knop, postback-menu-items en ice breakers, worden niet doorgestuurd, omdat pagina's zijn geabonneerd op feed, messages en mention.

Veelgemaakte fouten

  • Een vast menu instellen vóór Get Started. De vereisten van Meta omvatten een Get Started-knop, dus stel eerst get_started in.
  • De standaardlocale weglaten. ice breakers, menu's en commando's hebben elk een object nodig met locale op default als terugval.
  • De profiel-API in een lus aanroepen. Meta staat 10 aanroepen per 10 minuten per pagina toe, dus zet meerdere eigenschappen in één POST.
  • Verwachten dat een wijziging in het menu direct zichtbaar is. Een update van het menu op paginaniveau kan tot 24 uur duren voordat mensen hem zien.
Dit doen met EasyCoexistence

Het instellen van het Messenger-profiel hoort niet bij de tools. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen gratis.

Veelgestelde vragen

Kan een vast menu per persoon verschillen?

Ja. custom_user_settings met de PSID van de persoon overschrijft het menu van de pagina voor die persoon, wordt in realtime bijgewerkt en staat 10 aanroepen per persoon binnen 10 minuten toe.

Welke locales ondersteunt het Messenger-profiel?

Die op de lijst met ondersteunde locales van Meta, zoals en_GB, pt_BR of ja_JP, plus default, de terugval die wordt gebruikt wanneer geen locale past bij die van de persoon.

Wie mag het Messenger-profiel van een pagina wijzigen?

Een app met een paginatoken met pages_messaging. Het vaste menu, de begroeting en de domeinlijst vereisen ook de rol Administrator op de pagina.

Hoeveel kost easyCoexistence voor een Facebook-pagina?

Elke pagina is één verbinding: US$ 9 tot US$ 0,75 per verbinding per maand, de prijs daalt naarmate je aantal verbindingen groeit, en de eerste 3 dagen zijn gratis.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op