Pular para o conteúdo principal

​
Status da Mensagem

GET https://pilotstatus.com.br/v1/messages/{messageId}
Após enviar uma mensagem e receber um id (por exemplo, msg_abc) de POST /v1/messages/send, consulte seu status atual.
{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

curl "https://pilotstatus.com.br/v1/messages/msg_abc" \
  -H "x-api-key: ps_your_key_here"

​
Resposta (200)

{
  "id": "msg_abc",
  "status": "SENT",
  "correlationId": "corr_123",
  "destinationNumber": "+5511999999999",
  "template": "welcome_message",
  "createdAt": "2026-02-24T15:00:00.000Z",
  "sentAt": "2026-02-24T15:00:05.000Z",
  "deliveredAt": "2026-02-24T15:00:07.000Z",
  "readAt": null,
  "externalMessageId": "wamid.HBgLNTUxMTk5OTk5OTk5",
  "errorMessage": null
}

​
Status

StatusSignificado
QUEUEDNa fila / aguardando processamento
SENTEnviada ao provedor/WhatsApp
DELIVEREDEntregue ao dispositivo
READMarcada como lida
FAILEDFalhou (verifique errorMessage quando disponível)
CANCELEDEnvio agendado cancelado via DELETE /v1/messages/cancel
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.