Schnellantworten

Schnellantworten bieten eine neue Möglichkeit, Nutzern Buttons zu präsentieren. Schnellantworten werden gut sichtbar über dem Eingabefeld angezeigt, während die Tastatur weniger hervorsteht. Tippt eine Person auf eine Schnellantwort, wird die Nachricht in der Unterhaltung mit vom Entwickler definierten Metadaten im Rückruf gesendet. Außerdem werden die Buttons ausgeblendet. So wird verhindert, dass Nutzer auf an alte Nachrichten angehängte Buttons in einer Unterhaltung tippen.

Schnellantworten enthalten Text. Optional kannst du auch ein Bild hinzufügen.

Du kannst Schnellantworten auch dazu verwenden, eine Person nach ihrem Standort zu fragen.

Beispiel

Nur Text

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"USER_ID"
  },
  "message":{
    "text":"Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED"
      },
      {
        "content_type":"text",
        "title":"Green",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_GREEN"
      }
    ]
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=PAGE_ACCESS_TOKEN"    

Text und Bild

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"USER_ID"
  },
  "message":{
    "text":"Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED",
        "image_url":"http://petersfantastichats.com/img/red.png"
      },
      {
        "content_type":"text",
        "title":"Green",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_GREEN",
        "image_url":"http://petersfantastichats.com/img/green.png"
      }
    ]
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=PAGE_ACCESS_TOKEN"    

Standort

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"USER_ID"
  },
  "message":{
    "text":"Please share your location:",
    "quick_replies":[
      {
        "content_type":"location",
      }
    ]
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=PAGE_ACCESS_TOKEN"

Felder

message-Objekt

• quick_replies ist auf 11 beschränkt

attachment-Objekt

Schnellantworten funktionieren mit allen Nachrichtentypen, einschließlich Textnachricht-, Bild- und Vorlagenanhängen. Weitere Informationen zur Verwendung des attachment-Objekts findest du in der Send API-Dokumentation.

quick_reply-Objekt

• title ist auf 20 Zeichen beschränkt, längerer Text wird abgeschnitten.
• payload ist auf 1000 Zeichen begrenzt.
• Wenn content_typelocation lautet, werden title und payload nicht verwendet.
• Das Bild für image_url sollte mindestens 24 x 24 groß sein, es wird zugeschnitten und skaliert.

Rückruf

Wenn der Nutzer auf eine Schnellantwort tippt, wird eine Textnachricht an deinen Webhook Rückruf bei empfangenen Nachrichten gesendet. Der Text der Nachricht entspricht dem Titel der Schnellantwort. Das Nachrichtenobjekt enthält darüber hinaus ein Feld namens quick_reply, das die payload-Daten zur Schnellantwort beinhaltet.

{
  "sender": {
    "id": "USER_ID"
  },
  "recipient": {
    "id": "PAGE_ID"
  },
  "timestamp": 1464990849275,
  "message": {
    "mid": "mid.1464990849238:b9a22a2bcb1de31773",
    "seq": 69,
    "text": "Red",
    "quick_reply": {
      "payload": "DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED"
    }
  }
}    

Wenn eine Person ihren Standort teilt, sieht der Rückruf wie folgt aus:

{
  "object": "page",
  "entry": [
    {
      "id": "PAGE_ID",
      "time": 1472672934319,
      "messaging": [
        {
          "sender": {
            "id": "USER_ID"
          },
          "recipient": {
            "id": "PAGE_ID"
          },
          "timestamp": 1472672934259,
          "message": {
            "mid": "mid.1472672934017:db566db5104b5b5c08",
            "seq": 297,
            "attachments": [
              {
                "title": "Facebook HQ",
                "url": "https://www.facebook.com/l.php?u=https%....5-7Ocxrmg",
                "type": "location",
                "payload": {
                  "coordinates": {
                    "lat": 37.483872693672,
                    "long": -122.14900441942
                  }
                }
              }
            ]
          }
        }
      ]
    }
  ]
}