Réponses rapides

Les réponses rapides sont un nouveau moyen de présenter des boutons à une personne. Elles apparaissent en évidence au-dessus du Composer, le clavier étant moins en vue. Lorsque la personne appuie sur une réponse rapide, le message est envoyé dans la conversation avec les métadonnées définies par le développeur dans le rappel. De plus, les boutons disparaissent pour éviter que la personne n’appuie sur des boutons correspondant à d’anciens messages d’une conversation.

Les réponses rapides contiennent du texte. Vous pouvez ajouter une image en option.

Vous pouvez également utiliser les réponses rapides pour demander l’emplacement d’une personne.

Exemple

Texte uniquement

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"    

Texte et image

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"    

Lieu

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"

Champs

Objet message

• quick_replies est limité à 11

Objet attachment

Les réponses rapides sont compatibles avec tous les types de message, notamment les messages texte et les pièces jointes de type image et modèle. Consultez la documentation de l’API Send pour en savoir plus sur l’utilisation de l’objet attachment.

Objet quick_reply

• title est limité à 20 caractères, il est tronqué au-delà
• payload est limité à 1 000 caractères
• Si content_type correspond à location, title et payload ne sont pas utilisés
• L’image image_url doit faire au moins 24 x 24, et sera rognée et redimensionnée

Rappel

Lorsqu’une personne appuie sur une réponse rapide, un message texte est envoyé au rappel de message reçu de votre webhook. Le texte du message correspond au titre de la réponse rapide. L’objet du message contient également un champ intitulé quick_reply comportant les données payload concernant la réponse rapide.

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

Lorsque la personne partage sa position, le rappel ressemble à ce qui suit :

{
  "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
                  }
                }
              }
            ]
          }
        }
      ]
    }
  ]
}