# Status das mensagens

**Evento:** `message.status` · **Transporte:** POST para o seu receptor

Mudança de status das mensagens que a inbox enviou. Um evento por recibo do canal: um status, uma hora e a lista das mensagens (o WhatsApp junta no mesmo recibo várias mensagens da conversa; na API oficial costuma vir uma). Assine `message.status` num webhook (`POST /webhooks`) ou no `GET /events`.

`sent` sai logo depois do `message.sent`, quando o servidor aceitou (na API oficial, quando a Meta avisa). Em grupo, só `sent` e `failed` da mensagem; quem recebeu e leu vem em `group.receipts`.

**O status só sobe** (`sent` → `delivered` → `read` → `played`): os recibos podem chegar fora de ordem, então ignore um status menor que o que você já tem.

**Estado:** Disponível

## Compatibilidade de canais

| Canal | Compatível | Observação |
|---|---|---|
| WhatsApp (Web) | Sim |  |
| WhatsApp (API oficial) | Sim |  |
| Instagram | Sim |  |
| Messenger | Sim |  |
| Telegram | Em parte | Só `sent`: o Telegram não avisa entrega nem leitura. |

### Status das mensagens

```json
{
  "id": "evt_01JAB3K9ZQ7V0M4T8R2X6WYD5H",
  "type": "message.status",
  "created_at": "2026-10-17T12:00:00.000Z",
  "inbox": {
    "id": "r0269625d29bfbd",
    "name": "loja",
    "phone": "5511888888888",
    "channel": "whatsapp_web"
  },
  "data": {
    "chat": {
      "id": "5511999999999@s.whatsapp.net",
      "lid": "123456789012345@lid",
      "type": "direct"
    },
    "status": "read",
    "at": "2026-10-17T12:00:00.000Z",
    "messages": [
      {
        "id": "3EB05DCE1D4036FCE241C6"
      },
      {
        "id": "3EB0A7F2C91D"
      }
    ]
  }
}
```

## Referências

- [Eventos e webhooks](/docs/webhook)
- [Contrato OpenAPI completo](/openapi-bundled.json)