Référence de modèle de bouton

Le modèle de bouton vous permet d’envoyer un message structuré incluant du texte et des boutons. Pour en savoir plus sur l’implémentation, consultez Modèle de bouton.

Table des matières

URI de demande
Exemple de demande
Exemple de réponse
Propriétés

URI de demande

https://graph.facebook.com/v19.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>

Exemple de demande

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"button",
        "text":"What do you want to do next?",
        "buttons":[
          {
            "type":"web_url",
            "url":"https://www.messenger.com",
            "title":"Visit Messenger"
          },
          {
            ...
          },
          {...}
        ]
      }
    }
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Exemple de réponse

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

Propriétés

`recipient`

Description du destinataire du message. Toutes les demandes doivent contenir l’un de ces éléments : id, phone_number ou user_ref.

Propriété	Type	Description
`recipient.id`	Chaîne	Soit le `PSID`, le `phone_number` ou la `user_ref` du destinataire du message.
`recipient.phone_number`	Chaîne	*Facultatif.* Numéro de téléphone du destinataire au format +1(212)555-2368. Pour envoyer des messages de cette manière, votre bot doit être approuvé pour la correspondance client.
`recipient.user_ref`	Chaîne	*Facultatif.*`user_ref` à partir du plugin Checkbox.
`recipient.name`	Objet	*Facultatif.* Utilisé uniquement si `phone_number` est défini. Spécifie le nom de la personne au format : `{"first_name":"John", "last_name":"Doe"}` Fournir un nom augmente les chances de trouver une correspondance.

`message`

Description of the message to be sent.

Property	Type	Description
`message.attachment`	Object	An object describing attachments to the message.

`message.attachment`

Property	Type	Description
`type`	String	Value must be `template`
`payload`	Object	`payload` du modèle.

`message.attachment.payload`

Propriété	Type	Description
`template_type`	Chaîne	La valeur doit être `button`
`text`	Chaîne	Texte encodé en UTF-8 contenant jusqu’à 640 caractères. Le texte apparaîtra au-dessus des boutons.
`buttons`	Tableau<button>	Ensemble de 1 à 3 boutons qui apparaissent sous forme de bouton call-to-action.