Referencia del evento de webhook messages

Esta devolución de llamada se producirá cuando se envíe un mensaje a tu página. Los mensajes siempre se envían en orden. Puedes recibir mensajes de texto o mensajes con archivos adjuntos.

Los principales tipos de adjuntos admitidos son image, audio, video, file, reel y ig_reel. También es posible que recibas archivos adjuntos de fallback. Un ejemplo común de este tipo de archivo adjunto se da cuando un usuario comparte una URL con una página y se crea un archivo adjunto en función del uso compartido del enlace. Cuando los usuarios comparten elementos no admitidos con tu página, es posible que se envíe un archivo adjunto de fallback sin carga.

Para suscribirte a esta devolución de llamada, selecciona el campo message durante la configuración de tu webhook.

Ejemplos

Mensaje de texto

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

Mensaje de respuesta

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

Mensaje con adjunto

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

Mensaje con plantilla de producto

Este webhook se aplica a una situación en la que el usuario comparte productos de otros hilos o cuando se comparte un proceso con la página. Este webhook está limitado solo a los productos que son propiedad de la página. La app deberá tener el permiso catalog_management aprobado para recibir detalles del producto en los webhooks.

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

Mensaje con archivo adjunto de "fallback"

Ejemplo aplicable a messages en las versiones 6.0 y posteriores

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

Mensaje de la página de detalles del producto de las tiendas

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

Mensaje con información de referencia de anuncios

Este webhook se aplica al caso en que un usuario hace clic en un anuncio de CTM (clic a Messenger) y envía un mensaje a una página de Facebook. Además de los detalles del mensaje incluidos, la aplicación recibirá información de referencia de anuncios.

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

Mensajes con comandos

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

Propiedades

sender

recipient

message

message.quick_reply

Solo se proporciona una carga quick_reply con un mensaje de texto cuando el usuario toca el botón Respuestas rápidas.

message.reply_to

message.attachments

message.attachments.payload

message.attachments.payload.product.elements

message.referral

Solo se proporciona la carga referral cuando el usuario envía un mensaje desde la página de detalles del producto de las tiendas.

message.referral.product

message.referral.ads_context_data

message.commands