Estado de entrega

GET 
/messages/status/:messageId

Último estado conhecido de uma mensagem enviada, pelo WAMID.

O 201 do envio diz apenas que o WhatsApp aceitou a mensagem — o resultado chega depois, pelo webhook messages. Fora da janela de 24 horas, por exemplo, um texto livre é aceito e reprovado segundos depois com o código 131047: quem trata o 201 como sucesso final acha que enviou algo que nunca chegou.

A resposta sai do mesmo espelho de GET /events, então não custa chamada na Meta nem cota de envio. status: null significa que nenhum status chegou ainda (costuma levar segundos) ou que os webhooks da conta não estão sendo entregues.

Request

Responses

200

Estado conhecido da mensagem.

401

Token ausente, malformado, desconhecido ou revogado (authentication), ou conta suspensa (tenant_inactive).

422

Payload reprovado na validação (invalid_request, com o detalhamento em issues) ou recusado pela Meta (meta_error, com o corpo original em meta).

429

Limite de requisições excedido (rate_limit).

Response Headers

Retry-After

Segundos a aguardar antes de tentar de novo.

X-RateLimit-Category

Categoria do limite aplicada — send, media ou default.

X-RateLimit-Scope

Qual balde os outros headers descrevem — key (a API key), session (o painel) ou account (o teto da conta).

X-RateLimit-Limit

Teto de requisições da categoria na janela atual.

X-RateLimit-Remaining

Requisições restantes na janela atual.