messenger.message_reaction.updated

Usa messenger.message_reaction.updated para gestionar este evento en tu endpoint de webhook.

Desencadenadores

Se produce cuando un cliente reacciona a un mensaje de Messenger o elimina su reacción. Suscríbete a messenger.message_reaction.updated cuando configures tu endpoint de webhook. Usa action para distinguir una reacción de su retirada. Una retirada puede omitir reaction y emoji. El mensaje de Meta de destino no necesita un registro de mensaje local de YCloud. El createTime del sobre del evento corresponde a la hora de interacción de origen.

Sintaxis

YCloud envía una solicitud HTTP POST a la URL de webhook que hayas configurado. La siguiente estructura muestra una variante de carga útil. Los valores entre corchetes angulares son marcadores de posición; sus tipos se indican en Parámetros. Los campos opcionales y otras variantes se describen a continuación.

{
  "id": "<ID>",
  "type": "messenger.message_reaction.updated",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "messengerMessageReaction": {
    "pageId": "<PAGE_ID>",
    "psid": "<PSID>",
    "metaMessageId": "<META_MESSAGE_ID>",
    "action": "<ACTION>",
    "reaction": "<REACTION>",
    "emoji": "<EMOJI>"
  }
}

Parámetros

Valida el encabezado HTTP YCloud-Signature antes de procesar el cuerpo JSON. Consulta la validación de firmas.

Sobre del evento

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	Sí	ID único para el evento. Longitud mínima: `6`. Longitud máxima: `128`.
`type`	string	Sí	Siempre `messenger.message_reaction.updated`.
`apiVersion`	string	Sí	La versión de la API utilizada para procesar este evento.
`createTime`	string (date-time)	Sí	La hora a la que se creó este evento, en formato RFC 3339. Por ejemplo, `2022-06-01T12:00:00.000Z`.

Carga útil del evento

Parámetro	Tipo	Obligatorio	Descripción
`messengerMessageReaction`	object	No	Carga útil de `messengerMessageReaction` específica del evento.

Los cuatro campos comunes del sobre son obligatorios. Los campos de la carga útil dependen de la variante del evento. En cada tabla de objetos, Obligatorio se aplica cuando el objeto principal está presente. Los campos opcionales se pueden omitir; la presencia de un campo en un ejemplo no lo convierte en obligatorio.

messengerMessageReaction

Parámetro	Tipo	Obligatorio	Descripción
`pageId`	string	Sí	ID de la página de Facebook que delimita esta conversación.
`psid`	string	Sí	ID delimitado por la página del cliente que reaccionó.
`metaMessageId`	string	Sí	ID de Meta del mensaje al que se reacciona.
`action`	string	Sí	Use react to apply a reaction and unreact to withdraw it.
`reaction`	string	No	Nombre de la reacción cuando lo proporciona Meta. Puede omitirse, incluso al retirarla.
`emoji`	string	No	Emoji de la reacción cuando lo proporciona Meta. Puede omitirse, incluso al retirarla.

Ejemplo

El siguiente JSON es el cuerpo entregado a tu receptor. Los ID, números de teléfono y otros valores de cuenta son meramente ilustrativos.

Reacción a un mensaje de Messenger

El mensaje de Meta de destino no necesita tener un registro de mensaje local de YCloud.

{
  "id": "evt_abcdef0123456789abcdef01",
  "type": "messenger.message_reaction.updated",
  "apiVersion": "v2",
  "createTime": "2026-10-20T02:00:04.000Z",
  "messengerMessageReaction": {
    "pageId": "422500000000000",
    "psid": "100800000000000",
    "metaMessageId": "m_EXAMPLE_OUT_001",
    "action": "react",
    "reaction": "love",
    "emoji": "❤️"
  }
}

Reacción a un mensaje de Messenger retirada

Las retiradas pueden omitir el nombre y el emoji de la reacción.

{
  "id": "evt_bcdef0123456789abcdef012",
  "type": "messenger.message_reaction.updated",
  "apiVersion": "v2",
  "createTime": "2026-10-20T02:00:05.000Z",
  "messengerMessageReaction": {
    "pageId": "422500000000000",
    "psid": "100800000000000",
    "metaMessageId": "m_EXAMPLE_OUT_001",
    "action": "unreact"
  }
}

Tras verificar la firma y aceptar el evento de forma duradera, devuelve una respuesta 2xx. Procesa las tareas lentas de forma asíncrona.

HTTP/1.1 200 OK

Primeros pasos

Guías

Endpoints

Webhook reference

messenger.message_reaction.updated

Desencadenadores

Sintaxis

Parámetros

Sobre del evento

Carga útil del evento

messengerMessageReaction

Ejemplo

​Desencadenadores

​Sintaxis

​Parámetros

​Sobre del evento

​Carga útil del evento

​messengerMessageReaction

​Ejemplo

Desencadenadores

Sintaxis

Parámetros

Sobre del evento

Carga útil del evento

messengerMessageReaction

Ejemplo