Réponses rapides

Les réponses rapides permettent d’afficher jusqu’à 13 boutons dans les conversations. Ils sont accompagnés d’un titre, ainsi que d’une image facultative, et s’affichent de manière bien visible au-dessus de l’éditeur. Vous pouvez également utiliser les réponses rapides pour demander l’adresse d’une personne, son adresse e-mail et son numéro de téléphone.

Lorsqu’une personne appuie sur une réponse rapide, les boutons disparaissent et le titre du bouton pressé s’affiche dans la conversation en tant que message. Un évènement messages sera envoyé à votre webhook, avec le titre du bouton et une charge utile facultative.

Envoi de réponses rapides

Pour envoyer une réponse rapide, ajoutez le tableau quick_replies à un message texte et incluez des objets pour définir jusqu’à 13 boutons de réponse rapide.

Les types de réponses rapides suivants sont pris en charge :

• Texte
• Numéro de téléphone
• Adresse 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>"    

Réponse rapide au format texte

Il est également possible d’envoyer des réponses rapides au format texte avec une image facultative s’affichant sous forme d’icône à côté du titre. Si le content_type d’une réponse rapide est spécifié en tant que text, l’attribut title doit être spécifié.

Syntaxe

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

Évènement webhook

Lorsqu’une personne appuie sur une réponse rapide, un message texte est envoyé au rappel de message reçu de votre webhook.

La propriété text de l’évènement correspond au titre de la réponse rapide. L’objet du message contient également un champ intitulé quick_reply comportant les données payload associées à la réponse rapide.

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

Réponse rapide sous forme de numéro de téléphone d’utilisateur·ice

Ce type de réponse rapide vous permet de demander son numéro de téléphone à un·e utilisateur·ice. Lorsqu’elle envoie ce type de réponse rapide, la plateforme Messenger préremplit automatiquement la réponse rapide à afficher avec le numéro de téléphone indiqué dans les données du profil de l’utilisateur·ice.

Si le profil de l’utilisateur·ice ne contient pas de numéro de téléphone, la réponse rapide n’est pas affichée.

Le bot ne reçoit le numéro de téléphone que lorsque l’utilisateur·ice clique sur la réponse rapide.

La sélection de la réponse rapide transmet les informations une fois et ne constitue pas une autorisation d’accéder aux informations à l’avenir.

Syntaxe

{
  "content_type":"user_phone_number"
}

Évènement webhook

Lorsque l’utilisateur·ice appuie sur la réponse rapide, le numéro de téléphone est transmis à l’attribut payload de l’évènement webhook messages.

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

Réponse rapide sous forme d’adresse e-mail d’utilisateur·ice

Ce type de réponse rapide vous permet de demander son adresse e-mail à un·e utilisateur·ice. Lorsqu’elle envoie ce type de réponse rapide, la plateforme Messenger préremplit automatiquement la réponse rapide à afficher avec l’adresse e-mail indiquée dans les données du profil de l’utilisateur·ice.

Si le profil de l’utilisateur·ice ne contient pas d’adresse e-mail, la réponse rapide n’est pas affichée.

Le bot ne reçoit l’adresse e-mail que lorsque l’utilisateur·ice clique sur la réponse rapide.

La sélection de la réponse rapide transmet les informations une fois et ne constitue pas une autorisation d’accéder aux informations à l’avenir.

Syntaxe

{
  "content_type":"user_email"
}

Évènement webhook

Lorsque l’utilisateur·ice appuie sur la réponse rapide, l’adresse e-mail est transmise à l’attribut payload de l’évènement webhook messages.

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

Recommandations