> ## 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.inbound_message.updated

> Ocorre quando um cliente edita uma mensagem de texto recebida e salva do Messenger.

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

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.

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

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

> [accordion] 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.

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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 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.