Referencia de eventos del webhook messages

Esta devolución de llamada se producirá cuando se haya enviado un mensaje a tu página. Los mensajes siempre se envían en orden. Es posible que recibas mensajes de texto o mensajes con archivos adjuntos.

Los archivos adjuntos de tipo image, audio, video, file, reel e ig_reel son los tipos admitidos principales. También puedes recibir archivos adjuntos de tipo fallback. Un ejemplo habitual de un archivo adjunto de este tipo es una situación en que un usuario comparte una URL con una página y se crea un archivo adjunto basado en el uso compartido de enlaces. Si los usuarios comparten contenido con la página de un modo que no se admite, es posible que se envíe un archivo adjunto de tipo fallback sin ninguna carga útil.

Para suscribirte a esta devolución de llamada, selecciona message al configurar 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 un archivo adjunto

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

Mensaje con una plantilla de producto

Este webhook se aplica al escenario en el cual un usuario comparte productos de otras conversaciones o procesos de uso compartido en la página. Este webhook se limita únicamente a los productos que pertenecen a la página. La aplicación necesitará tener aprobado el permiso catalog_management para recibir los detalles del producto en los webhooks.

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

Mensaje con un archivo adjunto de tipo fallback

Ejemplo aplicable a messages para la versión 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 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 a la situación en la que un usuario hace clic en un anuncio de clic a Messenger (CTM) 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>"
      }
    }
  }
}

Mensaje 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

Una carga útil de quick_reply solo se proporciona con un mensaje de texto cuando el usuario toca un botón de respuestas rápidas.

message.reply_to

message.attachments

message.attachments.payload

message.attachments.payload.product.elements

message.referral

La carga útil de referral solo se proporciona cuando el usuario envía un mensaje desde la página de detalles del producto de tiendas.

message.referral.product

message.referral.ads_context_data

message.commands