messenger.inbound_message.received

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

Disparadores

Se produce cuando se recibe un mensaje de texto ordinario de Messenger de un cliente. Suscríbete a messenger.inbound_message.received cuando configures tu endpoint de webhook. from es el Page-scoped ID (PSID) del cliente y to es el ID de la página de Facebook. Estos identificadores no son números de teléfono. Conserva los espacios en blanco iniciales y finales en text.body.

Sintaxis

YCloud envía una solicitud HTTP POST a la URL de tu webhook configurada. La siguiente estructura muestra una variante del payload. Los valores entre corchetes angulares son marcadores de posición; sus tipos se indican en Parámetros. A continuación se describen los campos opcionales y otras variantes.

{
  "id": "<ID>",
  "type": "messenger.inbound_message.received",
  "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>"
  }
}

Parámetros

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

Envoltorio del evento

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

Carga útil del evento

Parámetro	Tipo	Obligatorio	Descripción
`messengerInboundMessage`	object	No	Payload de `messengerInboundMessage` específico del evento.

Los cuatro campos comunes del envoltorio son obligatorios. Los campos del payload dependen de la variante del evento. En la tabla de cada objeto, Obligatorio se aplica cuando su objeto principal está presente. Los campos opcionales se pueden omitir; la presencia en un ejemplo no hace que un campo sea obligatorio.

messengerInboundMessage

Parámetro	Tipo	Obligatorio	Descripción
`id`	string	Sí	ID del mensaje entrante de YCloud como cadena decimal.
`metaMessageId`	string	Sí	ID de mensaje de Meta.
`from`	string	Sí	PSID del cliente asignado a 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 indican 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 es el cuerpo entregado a tu receptor. Los ID, números de teléfono y otros valores de cuenta son ilustrativos. Usa messengerInboundMessage.id para correlacionar mensajes repetidos de clientes; conserva los espacios en blanco del texto.

{
  "id": "evt_0123456789abcdef01234567",
  "type": "messenger.inbound_message.received",
  "apiVersion": "v2",
  "createTime": "2026-10-20T02:00:00.000Z",
  "messengerInboundMessage": {
    "id": "1308528868252065793",
    "metaMessageId": "m_EXAMPLE_IN_001",
    "from": "100800000000000",
    "to": "422500000000000",
    "type": "text",
    "text": {
      "body": "  Hello  "
    },
    "sendTime": "2026-10-20T02:00:00.000Z",
    "createTime": "2026-10-20T02:00:00.100Z"
  }
}

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

HTTP/1.1 200 OK

Primeros pasos

Guías

Endpoints

Webhook reference

messenger.inbound_message.received

Disparadores

Sintaxis

Parámetros

Envoltorio del evento

Carga útil del evento

messengerInboundMessage

Ejemplo

​Disparadores

​Sintaxis

​Parámetros

​Envoltorio del evento

​Carga útil del evento

​messengerInboundMessage

​Ejemplo

Disparadores

Sintaxis

Parámetros

Envoltorio del evento

Carga útil del evento

messengerInboundMessage

Ejemplo