Buttons

Die meisten Nachrichtenvorlagen sowie das beständige Menü unterstützen Buttons für verschiedene Handlungen. Mit diesen Buttons kannst du den Nachrichtenempfänger*innen ganz einfach Handlungen anbieten, die sie als Antwort auf die Vorlage ausführen können, z. B. die Messenger-Webansicht öffnen, einen Zahlungsvorgang starten, eine Postback-Nachricht an deinen Webhook senden und mehr.

Für Nachrichtenvorlagen werden Buttons durch Objekte im buttons-Array definiert. Für das beständige Menü werden Buttons durch Objekte im call_to_actions-Array definiert.

URL-Button

Der URL-Button öffnet eine Webseite in der Messenger-Webansicht. So kannst du die Unterhaltung durch ein webbasiertes Erlebnis ergänzen und dabei die komplette Flexibilität der Web-Entwicklung nutzen. Du kannst beispielsweise eine Produktübersicht in der Unterhaltung anzeigen und dann den URL-Button verwenden, um die vollständige Produktseite auf deiner Webseite zu öffnen.

Wenn die Website App-Links enthält, startet der Button die angegebene native App.

Der Facebook-Crawler muss die App-Link-Metatags lesen, damit die Weiterleitung funktioniert. Wenn du nur die Tags auf deiner Website implementiert hast, kannst du einen neuen Auslesevorgang mit dem Sharing Debugger anfordern. Nachdem der Crawler die Website ausgelesen hat, sollten neue gesendete URL-Buttons das Weiterleitungsverhalten befolgen.

Unterstützte Nutzung

Der URL-Button wird für Folgendes unterstützt:

  • Beständiges Menü
  • Generische Vorlage
  • Listenvorlage
  • Button-Vorlage
  • Medienvorlage

SDK für Messenger-Erweiterungen – Erforderliches Domain-Whitelisting

Um eine Webseite mit aktiviertem SDK für Messenger-Erweiterungen in der Messenger-Webansicht anzuzeigen, musst du in der whitelisted_domains-Eigenschaft des Messenger-Profils deines Bots Domain-Whitelisting nutzen, einschließlich für die Subdomain. Dies sorgt dafür, dass nur vertrauenswürdige Domains Zugriff auf Nutzerinformationen haben, die über SDK-Funktionen verfügbar sind.

Weitere Informationen zu Domain-Whitelisting findest du in der whitelisted_domains-Referenz.

Button-Format

Eine vollständige Liste der Button-Eigenschaften findest du in der URL-Button-Referenz.

{
  "type": "web_url",
  "url": "

Postback-Button

Der Postback-Button sendet ein messaging_postbacks-Event an deinen Webhook mit dem String, der in der payload-Eigenschaft festgelegt ist. So kannst du frei wählbare Handlungen ausführen, wenn jemand auf den Button tippt. Du kannst beispielsweise eine Liste mit Produkten anzeigen und dann die Produkt-ID im Postback an deinen Webhook senden. Damit kannst du dann deine Datenbank abfragen und die Produktdetails als strukturierte Nachricht zurückgeben.

Unterstützte Nutzung

Der Postback-Button wird für Folgendes unterstützt:

  • Beständiges Menü
  • Generische Vorlage
  • Listenvorlage
  • Button-Vorlage
  • Medienvorlage

Button-Format

Eine vollständige Liste der Button-Eigenschaften findest du in der Postback-Button-Referenz.

{
  "type": "postback",
  "title": "

Anrufen-Button

Der Button „Anrufen“ wählt eine Telefonnummer beim Antippen. Die Telefonnummer muss das Format +<COUNTRY_CODE><PHONE_NUMBER> aufweisen, z. B. +15105559999.

Unterstützte Nutzung

Der „Anrufen“-Button wird für Folgendes unterstützt:

  • Generische Vorlage
  • Listenvorlage
  • Button-Vorlage
  • Medienvorlage

Button-Format

Eine vollständige Liste der Button-Eigenschaften findest du in der Referenz zum „Anrufen“-Button.

{
  "type":"phone_number",
  "title":"

Login-Button

Der Login-Button wird im Kontoverknüpfungsvorgang verwendet. Damit kannst du die Identität des*der Nachrichtenempfänger*in im Messenger mit seinem*ihrem Konto auf deiner Website verknüpfen, indem du ihn*sie zu deinem webbasierten Anmeldevorgang zur Authentifizierung weiterleitest.

Weitere Informationen zum Login-Button für die Kontoverknüpfung findest du unter Kontoverknüpfung.

Unterstützte Nutzung

Der Login-Button wird für Folgendes unterstützt:

  • Generische Vorlage
  • Listenvorlage
  • Button-Vorlage
  • Medienvorlage

Button-Format

Eine vollständige Liste der Button-Eigenschaften findest du in der Referenz zum Login-Button.

{
  "type": "account_link",
  "url": "

Logout-Button

Der Logout-Button wird im Kontoverknüpfungsvorgang verwendet, um die Identität des*der Nachrichtenempfänger*in im Messenger von dessen*deren Konto auf deiner Website zu trennen.

Weitere Informationen zur Nutzung des Logout-Buttons zum Aufheben der Kontoverknüpfung findest du unter Kontoverknüpfung.

Unterstützte Nutzung

Der Logout-Button wird für Folgendes unterstützt:

  • Generische Vorlage
  • Listenvorlage
  • Button-Vorlage
  • Medienvorlage

Button-Format

Eine vollständige Liste der Button-Eigenschaften findest du in der Referenz zum Logout-Button.

{
  "type": "account_unlink"
}

Spiel-Button

Der Spiel-Button startet ein Instant Game, das mit deiner Facebook-Seite verknüpft ist. Um anzupassen, wie dein Spiel geöffnet wird, kannst du eine payload-Eigenschaft in der Anfrage festlegen, die beim Launch an das Spiel gesendet wird. Außerdem kannst du eine optionale game_metadata.player_id- oder game_metadata.context_id-Eigenschaft festlegen, über die dein Bot das Spiel in einem speziellen Kontext für eine*n einzelne*n Spieler*in oder eine vorhandene Gruppe starten kann.

Button-Format

Die payload-Eigenschaft sollte als JSON serialisiert sein. Sie wird durch das Instant Games-SDK deserialisiert.

Eine vollständige Liste der Button-Eigenschaften findest du in der Referenz zum Spiel-Button.

{
  "type":"game_play",
  "title":"Play",
  "payload":"{<SERIALIZED_JSON_PAYLOAD>}",
  "game_metadata": { // Only one of the below
    "player_id": "<PLAYER_ID>",
    "context_id": "<CONTEXT_ID>"
  }
}

Unter Spiel-Webhook-Event findest du das Event, das an den Bot gesendet wird, wenn ein*e Nutzer*in eine Runde zu Ende spielt.

Best Practices

Verwende Buttons, um weitere Infos anzufragen oder Nutzer*innen zur weiteren Interaktion mit einer Nachricht aufzufordern.

Beginne mit einem Verb, um ganz deutlich zu machen, welche Handlung ausgeführt wird.

Verwende URL-Buttons für Aufgaben, die auf deiner Webseite ausgeführt werden sollen (z. B. Käufe, Kontoverknüpfung usw.). Mache deutlich, dass der*die Nutzer*in durch Antippen des Buttons den Messenger verlässt.

Sende eine Antwort, wenn jemand auf einen Rückruf-Button tippt. So bestätigst du, dass du die Nutzer*innen-Handlung verarbeitet oder abgeschlossen hast (z. B. Stornierung einer Reservierung, Beantworten einer Frage).

Verwende keine Buttons, wenn die jeweilige Handlung von dem aktuellen Status des Bots abhängt, da diese dauerhaft im Thread verfügbar sind.

Verwende nicht mehr als 1 bis 3 Wörter und füge keine Satzzeichen hinzu. Versuche, höchstens 20 Zeichen in deinem Text zu verwenden, einschließlich Leerzeichen.

Verlasse dich nicht für jeden Button auf URLs. Je mehr Interaktionen du innerhalb von Messenger erstellen kannst, desto nahtloser wird dein Erlebnis.

Verwende nicht nur einen einzelnen Rückruf-Button. Wenn nur ein Button zur Verfügung steht, denken Nutzer*innen oft, dass es sich um eine Fortführung des Nachrichtentexts handelt, und erkennen nicht, dass er für eine Handlung steht, die sie ausführen sollen.