messenger.inbound_message.updated

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

Desencadenadores

Se produce cuando un cliente edita un mensaje de texto entrante de Messenger guardado. Suscríbete a messenger.inbound_message.updated cuando configures tu endpoint de webhook. Una edición conserva los mismos ID de mensaje, sendTime y el createTime original del mensaje. El campo createTime del contenedor del evento corresponde a la hora de edición. Usa editCount y editTime para realizar un seguimiento de los datos acumulados de edición.

Sintaxis

YCloud envía una solicitud HTTP POST a tu URL de webhook configurada. La siguiente estructura muestra una variante de la 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.inbound_message.updated",
  "apiVersion": "<API_VERSION>",
  "createTime": "<CREATE_TIME>",
  "messengerInboundMessage": {
    "id": "<ID>",
    "metaMessageId": "<META_MESSAGE_ID>",
    "from": "<FROM>",
    "to": "<TO>",
    "type": "<TYPE>",
    "text": {
      "body": "<BODY>"
    },
    "sendTime": "<SEND_TIME>",
    "createTime": "<CREATE_TIME>",
    "editCount": "<EDIT_COUNT_VALUE>",
    "editTime": "<EDIT_TIME>"
  }
}

Parámetros

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

Contenedor 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.inbound_message.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, formateada en RFC 3339. P. ej., `2022-06-01T12:00:00.000Z`.

Carga útil del evento

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

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

messengerInboundMessage

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	Sí	ID de mensaje entrante de YCloud como una cadena decimal.
`metaMessageId`	string	Sí	ID del mensaje de Meta.
`from`	string	Sí	PSID del cliente asignado al ámbito de la página de Facebook.
`to`	string	Sí	ID de la página de Facebook.
`type`	string	Sí	Valores: `text`.
`text`	object	Sí	Los campos del objeto se enumeran a continuación.
`sendTime`	string (date-time)	Sí	Hora del evento de origen guardada en UTC RFC 3339 con precisión de milisegundos.
`createTime`	string (date-time)	Sí	Hora de persistencia local en UTC RFC 3339 con precisión de milisegundos.
`editCount`	integer	No	Recuento acumulado de ediciones proporcionado por Meta. Se omite antes de la primera edición.
`editTime`	string (date-time)	No	Hora de edición guardada en la plataforma en UTC RFC 3339 con precisión de milisegundos. Se omite antes de la primera edición.

messengerInboundMessage.text

Parámetro	Tipo	Obligatorio	Descripción
`body`	string	Sí	Texto no vacío. Los espacios iniciales y finales se conservan y se incluyen al comparar una solicitud repetida. Longitud mínima: `1`.

Ejemplo

El siguiente JSON corresponde al cuerpo entregado a tu receptor. Los ID, números de teléfono y otros valores de cuenta son meramente ilustrativos. El mismo mensaje guardado ahora incluye el texto más reciente y los datos acumulados de edición.

{
  "id": "evt_cdef0123456789abcdef0123",
  "type": "messenger.inbound_message.updated",
  "apiVersion": "v2",
  "createTime": "2026-10-20T02:01:00.000Z",
  "messengerInboundMessage": {
    "id": "1308528868252065793",
    "metaMessageId": "m_EXAMPLE_IN_001",
    "from": "100800000000000",
    "to": "422500000000000",
    "type": "text",
    "text": {
      "body": "  Hello, corrected  "
    },
    "sendTime": "2026-10-20T02:00:00.000Z",
    "createTime": "2026-10-20T02:00:00.100Z",
    "editCount": 2,
    "editTime": "2026-10-20T02:01:00.000Z"
  }
}

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

HTTP/1.1 200 OK

Primeros pasos

Guías

Endpoints

Webhook reference

messenger.inbound_message.updated

Desencadenadores

Sintaxis

Parámetros

Contenedor del evento

Carga útil del evento

messengerInboundMessage

Ejemplo

​Desencadenadores

​Sintaxis

​Parámetros

​Contenedor del evento

​Carga útil del evento

​messengerInboundMessage

​Ejemplo

Desencadenadores

Sintaxis

Parámetros

Contenedor del evento

Carga útil del evento

messengerInboundMessage

Ejemplo