Référence sur les évènements webhook messages

Ce rappel se produit lorsqu’un message a été envoyé à votre Page. Les messages sont toujours envoyés dans l’ordre. Il est possible que vous receviez des textos ou des messages contenant des pièces jointes.

Voici les principaux types de pièces jointes pris en charge : image, audio, video, file, reel et ig_reel. Vous pouvez également recevoir des pièces jointes de type fallback. L’exemple le plus courant en serait la pièce jointe créée suite à un partage de lien, lorsqu’une personne partage une URL avec une Page. Si des partages non pris en charge sont effectués vers votre Page, une pièce jointe de type fallback sans charge utile peut être envoyée.

Pour vous abonner à ce rappel, sélectionnez le champ message lors de la configuration de votre webhook.

Exemples

Message texte

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp":1458692752478,
  "message":{
    "mid":"mid.1457764197618:41d102a3e1ae206a38",
    "text":"hello, world!",
    "quick_reply": {
      "payload": "<DEVELOPER_DEFINED_PAYLOAD>"
    }
  }
}    

Message de réponse

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp":1458692752478,
  "message":{
    "mid":"m_1457764197618:41d102a3e1ae206a38",
    "text":"hello, world!",
    "reply_to": {
      "mid":"m_1fTq8oLumEyIp3Q2MR-aY7IfLZDamVrALniheU"
    }
  }
}    

Message contenant une pièce jointe

{
  "id": "682498302938465",
  "time": 1518479195594,
  "messaging": [
    {
      "sender": {
        "id": "

Message contenant un modèle de produit

Ce webhook s’applique dans le contexte d’un scénario de partage de produits à partir d’autres conversations ou d’un autre flux de partage vers la Page. Il est réservé aux produits appartenant à la Page. Seules les applications disposant de l’autorisation catalog_management peuvent recevoir des webhooks contenant les informations détaillées du produit.

{
  "id": "682498302938465",
  "time": 1518479195594,
  "messaging": [
    {
      "sender": {
        "id": "

Message contenant une pièce jointe de type fallback

Exemple applicable à messages à partir de la version 6.0.

{
    "object": "page",
    "entry": [
        {
            "id": "<PAGE_ID>",
            "time": 1583173667623,
            "messaging": [
                {
                    "sender": {
                        "id": "<PSID>"
                    },
                    "recipient": {
                        "id": "<PAGE_ID>"
                    },
                    "timestamp": 1583173666767,
                    "message": {
                        "mid": "m_toDnmD...",
                        "text": "This is where I want to go: https:\/\/youtu.be\/bbo_fZAjIhg",
                        "attachments": [
                            {
                                "type": "fallback",
                                "payload": {
                                    "url": "<ATTACHMENT_URL >",
                                    "title": "TAHITI - Heaven on Earth"
                                }
                            }
                        ]
                    }
                }
            ]
        }
    ]
}

Message de la Page de détails de produit Boutiques

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp":1458692752478,
  "message":{
    "mid":"mid.1457764197618:41d102a3e1ae206a38",
    "text":"hello, world!",
    "referral": {
      "product": {
        "id":"<PRODUCT_ID>"
      }
    }
  }
}    

Message avec des informations sur les références publicitaires

Ce webhook s’applique quand un utilisateur ou une utilisatrice clique sur une publicité clic vers Messenger et envoie un message à une page Facebook. L’application recevra non seulement les détails du message, mais aussi des informations sur les références publicitaires.

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp":1458692752478,
  "message":{
    "mid":"mid.1457764197618:41d102a3e1ae206a38",
    "text":"hello, world!",
    "referral": {
      "ref": "<REF_DATA_IF_SPECIFIED_IN_THE_AD>",
      "ad_id": "<ID_OF_THE_AD>",
      "source": "ADS",
      "type": "OPEN_THREAD",
      "ads_context_data": {
        "ad_title": "<TITLE_OF_THE_AD>",
        "photo_url": "<URL_OF_THE_IMAGE_FROM_AD_THE_USER_IS_INTERESTED_IN>",
        "video_url": "<THUMBNAIL_URL_OF_THE_VIDEO_FROM_THE_AD>",
        "post_id": "<ID_OF_THE_POST>",
        "product_id": "<PRODUCT_ID>"
      }
    }
  }
}

Message contenant des commandes

{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1697643211842,
      "messaging": [
        {
          "sender": {
            "id": "<PSID>"
          },
          "recipient": {
            "id": "<PAGE_ID>"
          },
          "timestamp": 1697643027400,
          "message": {
            "mid": "m_3vs...",
            "text": "find flights from SFO to LAX next Thursday",
            "commands": [
              {
                "name": "flights"
              }
            ]
          }
        }
      ]
    }
  ]
}

Propriétés

sender

recipient

message

message.quick_reply

La charge utile quick_reply ne contient un texto que si l’utilisateur·ice appuie sur un bouton Réponses rapides.

message.reply_to

message.attachments

message.attachments.payload

message.attachments.payload.product.elements

message.referral

La charge utile referral n’est fournie que si l’utilisateur·ice envoie un message depuis la Page de détails de produit Boutiques.

message.referral.product

message.referral.ads_context_data

message.commands