Référence des réponses rapides

Les réponses rapides sont des boutons que vous pouvez inclure dans un message pour obtenir une réponse du destinataire. Si l’utilisateur·ice clique sur une réponse rapide, la valeur du bouton est envoyée dans la conversation, et la plateforme Messenger envoie un évènement messages à votre webhook. Les réponses rapides sont un type de message qui est envoyé avec l’API Send. Pour connaître tous les détails relatifs à l’envoi de messages, consultez la page Messages.

Pour des détails complets sur l’utilisation, consultez la page Réponses rapides.

Exemple de requête

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/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Exemple de réponse

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

Propriétés

Propriété	Type	Description
`text`	Chaîne	Texte de message non vide à envoyer avec les réponses rapides. `text` ou `attachment` doit être défini.
`attachment`	Objet	Une pièce jointe à envoyer avec les réponses rapides. `text` ou `attachment` doit être défini.
`quick_replies`	Tableau<`quick_reply`>	Tableau d’objets décrivant les boutons de réponse rapide à envoyer. 13 réponses rapides maximum.

`quick_reply`

Propriété	Type	Description
`content_type`	Chaîne	Valeurs possibles : `text` : envoie un bouton texte `user_phone_number` : envoie un bouton permettant au destinataire ou à la destinataire d’envoyer le numéro de téléphone associé à son compte. `user_email` : envoie un bouton permettant au destinataire ou à la destinataire d’envoyer l’adresse e-mail associée à son compte.
`title`	Chaîne	Obligatoire si `content_type` est text. Texte à afficher sur le bouton de réponse rapide. 20 caractères maximum.
`payload`	Chaîne, nombre	Obligatoire si `content_type` est text. Données personnalisées qui vous seront renvoyées via l’évènement webhook `messaging_postbacks`. 1 000 caractères maximum. Peut être défini sur une chaîne vide si `image_url` est défini.
`image_url`	Chaîne	*Facultatif.* URL de l’image à afficher sur le bouton des réponses rapides de type texte. L’image doit mesurer au moins 24 x 24 px. Les images plus grandes seront rognées et redimensionnées automatiquement. Obligatoire si `title` est une chaîne vide.