Schnellantworten

Schnellantworten bieten die Möglichkeit, bis zu 13 Buttons in Unterhaltungen einzurichten, die einen Titel und ein optionales Bild enthalten und hauptsächlich über dem Composer angezeigt werden. Du kannst auch Schnellantworten verwenden, um den Standort, die E-Mail-Adresse und die Telefonnummer einer Person anzufordern.

Wenn auf eine Schnellantwort getippt wird, werden die Buttons geschlossen und der Titel des angetippten Buttons wird als Nachricht in die Unterhaltung eingefügt. Es wird ein messages-Event an deinen Webhook gesendet, das den Button-Titel und eine optionale Payload enthält.

Senden von Schnellantworten

Um eine Schnellantwort zu senden, füge das quick_replies-Array zu einer Nachricht hinzu und füge Objekte ein, die bis zu 13 Schnellantwort-Buttons definieren.

Die folgenden Schnellantworten werden unterstützt:

• Text
• Telefonnummer
• E-Mail

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

Text-Schnellantwort

Text-Schnellantworten können auch mit einem optionalen Bild gesendet werden, das als Symbol neben dem Titel angezeigt wird. Wenn content_type für eine Schnellantwort als text festgelegt ist, muss du einen nicht leeren title angeben.

Syntax

{
  "content_type":"text",
  "title":"<BUTTON_TEXT>",
  "image_url":"http://example.com/img/red.png",
  "payload":"<DEVELOPER_DEFINED_PAYLOAD>"
}

Webhook-Event

Wenn der*die Nutzer*in auf eine Schnellantwort tippt, wird eine Textnachricht an deinen Webhook Rückruf bei empfangenen Nachrichten gesendet.

Die text-Eigenschaft des Events entspricht dem Titel der Schnellantwort. Das Nachrichtenobjekt enthält darüber hinaus ein Feld namens quick_reply, das die payload-Daten zur Schnellantwort beinhaltet.

{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1502905976963,
      "messaging": [
        {
          "sender": {
            "id": "1254459154682919"
          },
          "recipient": {
            "id": "682498171943165"
          },
          "timestamp": 1502905976377,
          "message": {
            "quick_reply": {
              "payload": "DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_GREEN"
            },
            "mid": "m_AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P",
            "text": "Green"
          }
        }
      ]
    }
  ]
}

Schnellantwort an die Telefonnummer des*der Nutzer*in

Mit der Schnellantwort zur Telefonnummer eines*einer Nutzer*in kannst du den*die Nutzer*in nach seiner Telefonnummer fragen. Wenn die Telefonnummer-Schnellantwort gesendet wird, wird die angezeigte Schnellantwort von der Messenger-Plattform automatisch mit der Telefonnummer aus den Nutzerprofilinformationen vorausgefüllt.

Wenn im Nutzerprofil keine Telefonnummer angegeben ist, wird die Schnellantwort nicht angezeigt.

Der Bot erhält die Telefonnummer erst, wenn der*die Nutzer*in auf die Schnellantwort klickt.

Wenn die Schnellantwort ausgewählt wird, werden die Informationen einmalig übermittelt. Dies stellt keine Berechtigung für den künftigen Zugriff auf die Informationen dar.

Syntax

{
  "content_type":"user_phone_number"
}

Webhook-Event

Wenn der*die Nutzer*in auf die Schnellantwort tippt, wird die Telefonnummer im payload-Attribut des messages-Webhook-Events weitergegeben.

{
  "object": "page",
  "entry": [
    {
      "id": "

Schnellantwort an die E-Mail-Adresse des*der Nutzer*in

Mit der Schnellantwort zur E-Mail-Adresse eines*einer Nutzer*in kannst du den*der Nutzer*in nach seiner*ihrer Telefonnummer fragen. Wenn die E-Mail-Schnellantwort gesendet wird, wird die angezeigte Schnellantwort von der Messenger-Plattform automatisch mit der E-Mail-Adresse aus den Nutzerprofilinformationen vorausgefüllt.

Wenn im Nutzerprofil keine E-Mail-Adresse angegeben ist, wird die Schnellantwort nicht angezeigt.

Der Bot erhält die E-Mail-Adresse erst, wenn der*die Nutzer*in auf die Schnellantwort klickt.

Wenn die Schnellantwort ausgewählt wird, werden die Informationen einmalig übermittelt. Dies stellt keine Berechtigung für den künftigen Zugriff auf die Informationen dar.

Syntax

{
  "content_type":"user_email"
}

Webhook-Event

Wenn der*die Nutzer*in auf die Schnellantwort tippt, wird die E-Mail-Adresse im payload-Attribut des messages-Webhook-Events weitergegeben.

{
  "object": "page",
  "entry": [
    {
      "id": "

Best Practices