> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# messenger.message_reaction.updated

> Se produce cuando un cliente reacciona a un mensaje de Messenger o elimina su reacción.

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](https://docs.ycloud.com/es/api-reference/guides/api-fundamentals/configure-webhooks.md).

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.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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](https://docs.ycloud.com/es/api-reference/guides/api-fundamentals/configure-webhooks.md).

### 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](https://datatracker.ietf.org/doc/html/rfc3339). 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.

> [accordion] Reacción a un mensaje de Messenger
>
> El mensaje de Meta de destino no necesita tener un registro de mensaje local de YCloud.
>
> ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
> {
>   "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": "❤️"
>   }
> }
> ```

> [accordion] Reacción a un mensaje de Messenger retirada
>
> Las retiradas pueden omitir el nombre y el emoji de la reacción.
>
> ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
> {
>   "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 theme={"theme":{"light":"github-light","dark":"github-dark"}}
HTTP/1.1 200 OK
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.