Referencia de eventos de webhook

Los eventos de webhook son la forma en que la plataforma de Messenger notifica a un bot cuando tienen lugar diferentes interacciones o eventos, incluido cuando un usuario envía un mensaje. La plataforma de Messenger envía los eventos de webhook como solicitudes POST a tu webhook.

Nota: Deberás suscribir todas las aplicaciones de mensajes para tu empresa a los webhooks de mensajes.

Lista de eventos de webhook

A continuación, figura una lista de eventos que se pueden enviar a tu webhook desde la plataforma de Messenger.

Nota: Te recomendamos que uses la versión más reciente de la API para recibir toda la información disponible para cada webhook.

Evento del webhook	Descripción
`messages`	Suscribe a eventos de mensaje recibido.
`messaging_account_linking`	Suscribe a eventos de vinculación de cuentas.
`messaging_checkout_updates` (beta)	Suscribe a eventos de actualización de pago.
`message_deliveries`	Suscribe a eventos de mensaje entregado.
`message_echoes`	Suscribe a eventos de eco de mensaje.
`messaging_game_plays`	Suscribe a eventos de juego instantáneo.
`messaging_handovers` (beta)	Suscribe a eventos del protocolo de entrega
`messaging_optins`	Suscribe a eventos de consentimiento de plugin.
`messaging_payments` (beta)	Suscribe a eventos de pago.
`messaging_policy_enforcement`	Suscribe a eventos de aplicación de políticas.
`messaging_postbacks`	Suscribe a eventos de postback recibido.
`messaging_pre_checkouts` (beta)	Suscribe a eventos anteriores al pago
`message_reads`	Suscribe a eventos de mensaje leído.
`messaging_referrals`	Suscribe a eventos de referencia.
`standby` (beta)	Suscribe a eventos del canal de espera del protocolo de entrega

Formato de los eventos

Todas las devoluciones de llamadas de la plataforma de Messenger comparten un conjunto de propiedades que proporcionan información que necesitarás para procesar los comentarios de los usuarios que utilizan el bot y para responder a ellos. Además de las propiedades que figuran a continuación, cada evento tiene también un conjunto de propiedades específicas que lo detallan.

{
  "object":"page",
  "entry":[
    {
      "id":"<PAGE_ID>",
      "time":1458692752478,
      "messaging":[
        {
          "sender":{
            "id":"<PSID>"
          },
          "recipient":{
            "id":"<PAGE_ID>"
          },

          ...
        }
      ]
    }
  ]
}

Propiedades

Propiedad	Tipo	Descripción
`object`	Cadena	El valor será `page`.
`entry`	Matriz de `entry`	Matriz con datos de eventos.

`entry`

Propiedad	Tipo	Descripción
`id`	Cadena	Identificador de la página.
`time`	Número	Hora de actualización (tiempo Unix en milisegundos).
`messaging`	Matriz <`messaging`>	Matriz que contiene un objeto `messaging`. Ten en cuenta que, pese a tratarse de una matriz, no contiene más que un objeto `messaging`.

`entry.messaging`

Propiedad	Tipo	Descripción
`sender.id`	Cadena	Identificador de usuario del remitente.
`recipient.id`	Cadena	Identificador de usuario del destinatario.

Más información

Si los mensajes se gestionan mediante más de una aplicación (por ejemplo, una aplicación gestiona las respuestas automáticas y otra gestiona las remisiones a un agente humano), tendrás que implementar el protocolo de traspaso para pasar la conversación de una aplicación a otra. Protocolo de traspaso