Messenger Profile API: Begrüßung, Get Started-Button, Ice Breakers und persistentes Menü
Das Messenger-Profil einer Facebook-Seite wird über /{page-id}/messenger_profile mit einem Page-Token und der Berechtigung pages_messaging gesetzt: POST schreibt Eigenschaften wie get_started, greeting, ice_breakers, persistent_menu und commands, GET liest sie mit fields, und DELETE entfernt die im fields-Array genannten. Meta erlaubt pro Seite 10 Aufrufe in 10 Minuten, und nur die gesendeten Eigenschaften werden überschrieben.
easyCoexistence antwortet mit send_social_dm innerhalb des 24-Stunden-Fensters auf die Messenger-Unterhaltungen einer Seite, aus Claude, ChatGPT oder Ihrem eigenen Code, und neue Nachrichten werden an Ihren Endpoint weitergeleitet, sobald sie eintreffen.
Anzahl der Aufrufe der Messenger Profile API pro Seite in jedem 10-Minuten-Intervall.
Höchstzahl an Ice Breakers, die die API setzt; sind beide gesetzt, haben die über die API gesetzten Ice Breakers Vorrang vor dem Get Started-Button.
Höchstzahl der Einträge oberster Ebene in einem persistenten Menü; der Titel jedes Eintrags ist auf 30 Zeichen begrenzt.
Dauer, bis ein seitenweites Update des persistenten Menüs wirksam wird; ein für eine Person gesetztes Menü aktualisiert sich in Echtzeit.
Begrüßungstext, der laut Metas Referenz auf Messenger für Android und iOS nicht mehr funktioniert.
Was enthält das Messenger-Profil?
Die Einstellungen, von denen das Messenger-Erlebnis einer Seite ausgeht. Die Messenger Profile API von Meta listet diese Eigenschaften auf, die alle über denselben Endpoint gesetzt und gelesen werden. Bei einer App im Entwicklungsmodus sind die Einstellungen nur für Personen sichtbar, die eine Rolle in der App haben:
Wie werden Eigenschaften gelesen, gesetzt und gelöscht?
Mit drei Methoden auf einem Endpoint, aufgerufen mit dem Token der Seite. POST nimmt einen JSON-Body mit Eigenschaften entgegen und überschreibt nur die genannten. GET nimmt fields als kommagetrennte Liste, und DELETE nimmt einen JSON-Body, dessen fields-Array angibt, was entfernt werden soll. POST und DELETE antworten mit result success. Get Started-Button und Menü in einem Aufruf setzen:
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" }Wie funktioniert der Get Started-Button?
Er erscheint auf dem Begrüßungsbildschirm, der den Namen der Seite, das Profilbild, das Titelbild und die übliche Antwortzeit des Unternehmens zeigt. Ein Tipp sendet Get Started in die Unterhaltung, schickt get_started.payload als messaging_postbacks-Ereignis an die App und öffnet das Standard-Nachrichtenfenster. Meta weist darauf hin, dass der Button im In-App-Browser der Facebook-App nicht unterstützt wird, und ein persistentes Menü setzt ihn voraus.
Funktioniert der Begrüßungstext noch?
Auf Telefonen nicht mehr. Metas Referenz trägt jetzt den Titel [Deprecated] Greeting Text: Die Funktion funktioniert auf Messenger für Android und iOS nicht mehr. Die API akzeptiert die Eigenschaft greeting womöglich weiterhin, Kunden sehen sie aber nicht, weshalb Meta Entwicklern rät, sie zu vermeiden. Laut Dokumentation hält greeting einen Text pro Sprache, mit verpflichtendem default, bis zu 160 Zeichen, personalisierbar mit {{user_first_name}}, {{user_last_name}} oder {{user_full_name}}. Zum Setzen braucht man die Rolle Administrator auf der Seite.
Wie funktionieren Ice Breakers?
Sie listen bis zu 4 Fragen auf, die eine Person antippen kann, um eine Unterhaltung zu beginnen. Die Frage wird im Verlauf so gepostet, als hätte die Person sie gestellt, und ihr payload kommt als Postback-Ereignis zurück. Seit April 2022 sind sie lokalisiert: Jedes Objekt in ice_breakers enthält call_to_actions und ein locale, ein Standard-locale ist Pflicht, und ein DELETE auf ice_breakers entfernt alle. Meta reiht die Elemente, die um eine neue Unterhaltung konkurrieren:
- Ice Breakers über die API haben Vorrang vor dem Get Started-Button, wenn beide gesetzt sind.
- Beide stehen vor benutzerdefinierten Fragen, die im Seiten-Posteingang gesetzt werden. Deren Bearbeitung ist deaktiviert, solange API-Ice-Breakers gesetzt sind.
Wie ist das persistente Menü aufgebaut?
Als Array von Menüs, eines pro Sprache mit verpflichtendem default, das jeweils bis zu 20 call_to_actions vom Typ web_url oder postback enthält. Ein Titel darf bis zu 30 Zeichen haben, ein Postback-payload bis zu 1,000, und composer_input_disabled auf true lässt Menü, Schaltflächen und Webviews als einzige Interaktionsmöglichkeit. Metas Voraussetzungen, bevor es erscheint:
- Ein bereits gesetzter Get Started-Button und die Berechtigung
pages_messaging. - Eine veröffentlichte Seite und eine App, die auf öffentlich eingestellt ist.
- Die Rolle Administrator auf der Seite für die Person, die es setzt.
- Messenger v106 oder neuer auf iOS oder Android, außerhalb des In-App-Browsers der Facebook-App.
- Änderungen auf Seitenebene können bis zu 24 Stunden dauern. Ein Menü für eine Person, über
custom_user_settingsmit einer PSID gesetzt, aktualisiert sich in Echtzeit.
Was sind Befehle?
Stichwörter, die eine Person jederzeit aufrufen kann: aus einem Befehlsmenü neben dem Eingabefeld, durch Eingabe eines Schrägstrichs oder At-Zeichens oder aus einem Hinweisfenster, wenn sie ein passendes Wort tippt. Jede Sprache enthält 1 bis 100 Befehle, mit einem Namen von 1 bis 32 Zeichen ohne führenden Schrägstrich und einer Beschreibung von 1 bis 64 Zeichen. Sind Befehle gesetzt, haben sie Vorrang vor dem persistenten Menü. Aufgerufene Befehle erreichen die App im messages-Ereignis unter message.commands.
Was bewirken whitelisted_domains und account_linking_url?
Beide betreffen Erlebnisse außerhalb der Unterhaltung selbst. whitelisted_domains listet bis zu 50 Domains auf, die die Messenger-Webview für das Messenger Extensions SDK und das Checkbox-Plugin öffnen darf. Jede muss über HTTPS unter einem vollständig qualifizierten Namen bereitgestellt werden, nie als IP-Adresse oder localhost, und zum Setzen braucht man die Rolle Administrator auf der Seite. account_linking_url ist der HTTPS-Callback, der das Messenger-Konto einer Person mit ihrem Konto beim Unternehmen verknüpft.
Wie setzt easyCoexistence das Messenger-Profil einer Seite?
Das tut es nicht: Kein Tool ruft {page-id}/messenger_profile auf, und Seiten-Tokens werden nicht herausgegeben, daher liegt das Setzen des Profils außerhalb dieser Verbindung. Befehle, die Personen aufrufen, kommen im messages-Ereignis an, das easyCoexistence weiterleitet und das Automatisierungen auswerten. Tipps, die Meta als messaging_postbacks-Ereignisse meldet, etwa von Get Started, Postback-Menüpunkten und Ice Breakers, werden nicht weitergeleitet, da Seiten für feed, messages und mention abonniert sind.
Häufige Fehler
- Ein persistentes Menü vor Get Started setzen. Metas Voraussetzungen umfassen einen Get Started-Button, also setzen Sie zuerst get_started.
- Die Standard-locale auslassen. Ice Breakers, Menüs und Befehle brauchen jeweils ein Objekt mit locale auf default als Ausweichwert.
- Die Profil-API in einer Schleife aufrufen. Meta erlaubt 10 Aufrufe pro 10 Minuten und Seite, also fassen Sie mehrere Eigenschaften in einem POST zusammen.
- Eine sofortige Wirkung einer Menüänderung erwarten. Ein Update auf Seitenebene kann bis zu 24 Stunden brauchen, bis es Personen erreicht.
Das Setzen des Messenger-Profils gehört nicht zu den Tools. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, mit einer kostenlosen Testphase von 3 Tagen.
Häufig gestellte Fragen
Kann ein persistentes Menü pro Person unterschiedlich sein?
Ja. custom_user_settings mit der PSID der Person überschreibt das Menü der Seite für diese Person, aktualisiert sich in Echtzeit und erlaubt 10 Aufrufe pro Person in 10 Minuten.
Welche Sprachen unterstützt das Messenger-Profil?
Die Locales auf Metas Liste unterstützter Locales, etwa en_GB, pt_BR oder ja_JP, dazu default, der Ausweichwert, wenn keine Locale zur Person passt.
Wer darf das Messenger-Profil einer Seite ändern?
Eine App mit einem Page-Token, das pages_messaging enthält. Das persistente Menü, der Begrüßungstext und die Domainliste brauchen zusätzlich die Rolle Administrator auf der Seite.
Was kostet easyCoexistence für eine Facebook-Seite?
Jede Seite ist eine Verbindung: US$ 9 bis US$ 0.75 pro Verbindung und Monat, wobei der Preis mit wachsender Anzahl an Verbindungen sinkt. Es gibt eine kostenlose Testphase von 3 Tagen.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am