Obter Status de Entrega de Mensagem via WhatChimp API

Rastreie se suas mensagens foram enviadas, entregues, lidas ou falharam.

Updated 5 February 2026

Rastreie se suas mensagens foram enviadas, entregues, lidas ou falharam, e descubra por que uma mensagem não passou.

Antes de começar: Certifique-se de ter sua chave API e ID do número de telefone. Consulte Primeiros Passos com WhatChimp Developer API para instruções de configuração.

Endpoint

GET/POST /api/v1/whatsapp/get/message-status

https://app.whatchimp.com/api/v1/whatsapp/get/message-status

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
`apiToken`	String	Sim	Sua chave API do WhatChimp
`wa_message_id`	String	Sim	O ID da mensagem do WhatsApp (retornado quando você enviou a mensagem)
`whatsapp_bot_id`	Number	Sim	Seu ID de bot do WhatsApp

Onde obtenho o wa_message_id? Cada envio bem-sucedido via a API WhatChimp retorna um wa_message_id na resposta. Salve este valor para verificar o status de entrega mais tarde.

Onde obtenho o whatsapp_bot_id? Chame o endpoint User Info (GET /user/myInfo): ele retorna seu array whatsapp_bots_details com IDs de bot.

Exemplos de Requisição

GET:

https://app.whatchimp.com/api/v1/whatsapp/get/message-status?apiToken=API-KEY&wa_message_id=wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=&whatsapp_bot_id=123

POST (cURL):

curl -X POST \
  'https://app.whatchimp.com/api/v1/whatsapp/get/message-status' \
  -d 'apiToken=API-KEY' \
  -d 'wa_message_id=wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=' \
  -d 'whatsapp_bot_id=123'

Message Delivery Status endpoint showing parameters and response in the API console

Resposta

{
  "status": "1",
  "message": {
    "message_status": "delivered",
    "delivery_status_updated_at": "2024-07-28 13:21:03",
    "read_time": null,
    "failed_time": null,
    "failed_reason": ""
  }
}

Valores de Status de Entrega

Status	Significado
`sent`	Mensagem enviada para servidores WhatsApp — aguardando entrega
`delivered`	Mensagem entregue no dispositivo do destinatário
`read`	Mensagem lida pelo destinatário (tiques azuis)
`failed`	Mensagem falhou ao entregar — verifique `failed_reason` para detalhes

Campos da Resposta

Campo	Descrição
`message_status`	Status de entrega atual (veja tabela acima)
`delivery_status_updated_at`	Carimbo de data/hora da última atualização de status
`read_time`	Quando a mensagem foi lida (null se ainda não foi lida)
`failed_time`	Quando a falha ocorreu (null se não falhou)
`failed_reason`	Descrição do erro se a mensagem falhou

Razões Comuns de Falha

Razão	O Que Significa	Solução
Phone number not on WhatsApp	O número do destinatário não está registrado no WhatsApp	Verifique se o número está correto e ativo no WhatsApp
Template not approved	Template foi rejeitado ou ainda está pendente	Verifique o status do template em Bot Manager > Message Template
Rate limit exceeded	Muitas mensagens enviadas em pouco tempo	Reduza sua taxa de envio, verifique seu nível de mensagens
Invalid phone number format	Formato do número está incorreto	Use código do país sem sinal `+` (ex., `919999999999`)

Casos de Uso

Recibos de entrega: confirme que as mensagens foram entregues antes de tomar a próxima ação em seu workflow
Rastreamento de leitura: saiba quando um cliente viu sua mensagem
Tratamento de erros: detecte mensagens falhadas e acione retentativas ou alertas
Monitoramento de SLA: rastreie tempos de entrega para mensagens sensíveis ao tempo como OTPs