Skip to main content

Status da Mensagem

Após enviar uma mensagem e receber um id (por exemplo, msg_abc) de POST /v1/messages/send, consulte seu status atual. Para listar e filtrar muitas mensagens (enviadas e recebidas), veja GET /v1/messages.
Modal Detalhes do Log mostrando o balão da mensagem renderizada com botões de resposta rápida, nome do template, status Lida, data e hora, ID da mensagem com botão de copiar, variáveis e as ações Reenviar e Trace completo

Detalhes do Log no painel — a mensagem renderizada, o template, o status ao vivo (Lida) e o mesmo messageId que você consulta pela API.

{messageId} aceita o id interno da mensagem retornado pelo endpoint de envio, o correlationId ou o ID de mensagem do WhatsApp do provedor (wamid).

Exemplo

Resposta (200)

Status

Confirmações de leitura: o status READ e readAt só estão disponíveis quando o contato que recebeu a mensagem tem as confirmações de leitura ativadas no WhatsApp (Configurações > Privacidade > Confirmações de leitura). Caso contrário, o ciclo de vida pode parar em DELIVERED. O mesmo se aplica aos Logs e ao webhook message.read.

Erros comuns

  • 401 — cabeçalho de chave de API ausente/inválido (x-api-key / x-api-key-id).
  • 404 — mensagem não encontrada dentro do escopo da chave.