Schnellantworten – Referenz

Mithilfe von Schnellantworten kannst du Rückmeldung von dem*der Nachrichtenempfänger*in erhalten, indem du Buttons in einer Nachricht versendest. Wenn auf eine Schnellantwort getippt wird, wird der Wert des Buttons in der Unterhaltung versendet und die Messenger-Plattform sendet ein messages-Event an deinen Webhook. Bei Schnellantworten handelt es sich um eine Art von Nachrichten, die mit der Send API versendet wird. Ausführliche Informationen zum Versenden von Nachrichten findest du unter Nachrichten.

Ausführliche Informationen zur Verwendung findest du unter Schnellantworten.

Beispielanfrage

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "messaging_type": "RESPONSE",
  "message":{
    "text": "Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"<POSTBACK_PAYLOAD>",
        "image_url":"http://example.com/img/red.png"
      },{
        "content_type":"text",
        "title":"Green",
        "payload":"<POSTBACK_PAYLOAD>",
        "image_url":"http://example.com/img/green.png"
      }
    ]
  }
}' "https://graph.facebook.com/v19.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Beispielantwort

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}

Eigenschaften

Eigenschaft	Typ	Beschreibung
`text`	String	Nicht leerer Nachrichtentext zum Senden über Schnellantworten. `text` oder `attachment` muss festgelegt sein.
`attachment`	Objekt	Ein Anhang, der mit Schnellantworten gesendet wird. `text` oder `attachment` muss festgelegt sein.
`quick_replies`	Array<`quick_reply`>	Ein Array von Objekten zur Beschreibung der zu versendenden Schnellantwort-Buttons. Es werden höchstens 13 Schnellantworten unterstützt.

`quick_reply`

Eigenschaft	Typ	Beschreibung
`content_type`	String	Muss einer der folgenden sein `text`: Zum Versenden eines Text-Buttons `user_phone_number`: Zum Versenden eines Buttons, über den derdie Empfängerin die mit seinem*ihrem Konto verknüpfte Telefonnummer übermitteln kann. `user_email`: Zum Versenden eines Buttons, über den der Empfänger die mit seinem Konto verknüpfte E-Mail-Adresse übermitteln kann
`title`	String	Erforderlich, wenn `content_type` „text“ ist. Der auf dem Schnellantwort-Button anzuzeigende Text. Max. 20 Zeichen.
`payload`	String, Nummer	Erforderlich, wenn `content_type` „text“ ist. Benutzerdefinierte Daten, die mithilfe des Webhook-Events `messaging_postbacks` zurückgesendet werden. Max. 1.000 Zeichen. Ist möglicherweise auf einen leeren String festgelegt, wenn `image_url` festgelegt ist.
`image_url`	String	*Optional.* URL des auf dem Schnellantwort-Button für Text-Schnellantworten anzuzeigenden Bilds. Bild sollte mindestens 24 Pixel x 24 Pixel groß sein. Größere Bilder werden automatisch zugeschnitten und verkleinert. Erforderlich, wenn `title` ein leerer String ist.