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

CanalCompatívelObservação
WhatsApp (Web)Sim
WhatsApp (API oficial)Sim
InstagramSim
MessengerSim
TelegramEm parteSó sent: o Telegram não avisa entrega nem leitura.

Status das mensagens

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