messenger.inbound_message.updated

Use messenger.inbound_message.updated para manipular este evento em seu endpoint de webhook.

Gatilhos

Ocorre quando um cliente edita uma mensagem de texto recebida e salva do Messenger. Inscreva-se em messenger.inbound_message.updated ao configurar seu endpoint de webhook. Uma edição mantém os mesmos IDs de mensagem, sendTime e createTime original da mensagem. O createTime do envelope do evento é a hora da edição. Use editCount e editTime para acompanhar dados cumulativos de edição.

Sintaxe

A YCloud envia uma solicitação HTTP POST para a URL de webhook configurada. A estrutura a seguir mostra uma variante de payload. Os valores entre colchetes angulares são marcadores de posição; seus tipos estão listados em Parâmetros. Campos opcionais e outras variantes são descritos abaixo.

{
  "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

Valide o cabeçalho HTTP YCloud-Signature antes de processar o corpo JSON. Consulte a validação de assinatura.

Envelope do evento

Parâmetro	Tipo	Obrigatório	Descrição
`id`	string	Sim	ID exclusivo do evento. Tamanho mínimo: `6`. Tamanho máximo: `128`.
`type`	string	Sim	Sempre `messenger.inbound_message.updated`.
`apiVersion`	string	Sim	A versão da API usada para renderizar este evento.
`createTime`	string (date-time)	Sim	A hora em que este evento foi criado, formatada em RFC 3339. Por exemplo, `2022-06-01T12:00:00.000Z`.

Payload do evento

Parâmetro	Tipo	Obrigatório	Descrição
`messengerInboundMessage`	object	Não	Payload de `messengerInboundMessage` específico do evento.

Os quatro campos comuns do envelope são obrigatórios. Os campos do payload dependem da variante do evento. Em cada tabela de objetos, Obrigatório se aplica quando o objeto pai está presente. Campos opcionais podem ser omitidos; um exemplo não torna um campo obrigatório.

messengerInboundMessage

Parâmetro	Tipo	Obrigatório	Descrição
`id`	string	Sim	ID da mensagem recebida da YCloud como uma string decimal.
`metaMessageId`	string	Sim	ID da mensagem da Meta.
`from`	string	Sim	PSID do cliente com escopo para a Página do Facebook.
`to`	string	Sim	ID da Página do Facebook.
`type`	string	Sim	Valores: `text`.
`text`	object	Sim	Os campos do objeto estão listados abaixo.
`sendTime`	string (date-time)	Sim	Hora do evento de origem salva em UTC RFC 3339 com precisão de milissegundos.
`createTime`	string (date-time)	Sim	Hora de persistência local em UTC RFC 3339 com precisão de milissegundos.
`editCount`	integer	Não	Contagem cumulativa de edições fornecida pela Meta. Omitida antes da primeira edição.
`editTime`	string (date-time)	Não	Hora da edição salva na plataforma em UTC RFC 3339 com precisão de milissegundos. Omitida antes da primeira edição.

messengerInboundMessage.text

Parâmetro	Tipo	Obrigatório	Descrição
`body`	string	Sim	Texto não vazio. Espaços no início e no final são preservados e incluídos ao comparar uma solicitação repetida. Tamanho mínimo: `1`.

Exemplo

O JSON a seguir é o corpo entregue ao seu receptor. IDs, números de telefone e outros valores de conta são ilustrativos. A mesma mensagem salva agora contém o texto mais recente e dados cumulativos de edição.

{
  "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"
  }
}

Após verificar a assinatura e aceitar o evento de forma duradoura, retorne uma resposta 2xx. Processe tarefas lentas de forma assíncrona.

HTTP/1.1 200 OK

Primeiros passos

Guias

Endpoints

Webhook reference

messenger.inbound_message.updated

Gatilhos

Sintaxe

Parâmetros

Envelope do evento

Payload do evento

messengerInboundMessage

Exemplo

​Gatilhos

​Sintaxe

​Parâmetros

​Envelope do evento

​Payload do evento

​messengerInboundMessage

​Exemplo

Gatilhos

Sintaxe

Parâmetros

Envelope do evento

Payload do evento

messengerInboundMessage

Exemplo