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.

App-Links

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

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