curl --request GET \
--url https://api.superlead.app/v1/whatsapp/messages/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.superlead.app/v1/whatsapp/messages/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.superlead.app/v1/whatsapp/messages/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "msg_9f8e7d6c-1a2b-3c4d-5e6f-7a8b9c0d1e2f",
"wamid": "wamid.HBgNNTUxMTk5OTk5OTk5ORUCABEYEjVGQjA3RDIzRkU3QzYxRjM5NQA=",
"external_id": "pedido-8734",
"to": "+5511999999999",
"type": "text",
"status": "delivered",
"created_at": "2026-07-08T12:34:56.000Z",
"status_updated_at": "2026-07-08T12:35:10.000Z",
"error": null
}Consultar Mensagem
Consulta uma mensagem enviada pela API e o seu status de entrega atual.
Use o id (msg_...) retornado no envio. Ciclo de vida: accepted → sent → delivered → read, com desvio para failed a qualquer momento — inclusive depois de um 201 (falha assíncrona da Meta: janela de 24h, mídia inválida…). Mensagens failed trazem o motivo em error, com o código estável do catálogo de erros e o código numérico original da Meta em upstream_code.
Para acompanhar transições em tempo real sem polling, prefira o webhook whatsapp.message.updated — veja Webhooks. Use esta consulta para reconciliação e verificações pontuais.
curl --request GET \
--url https://api.superlead.app/v1/whatsapp/messages/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.superlead.app/v1/whatsapp/messages/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.superlead.app/v1/whatsapp/messages/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "msg_9f8e7d6c-1a2b-3c4d-5e6f-7a8b9c0d1e2f",
"wamid": "wamid.HBgNNTUxMTk5OTk5OTk5ORUCABEYEjVGQjA3RDIzRkU3QzYxRjM5NQA=",
"external_id": "pedido-8734",
"to": "+5511999999999",
"type": "text",
"status": "delivered",
"created_at": "2026-07-08T12:34:56.000Z",
"status_updated_at": "2026-07-08T12:35:10.000Z",
"error": null
}Authorizations
Chave de API da sua empresa (sk_...). Crie no painel Superlead em Integrações → API e envie em toda chamada como Authorization: Bearer sk_.... Veja Autenticação.
Path Parameters
Id da mensagem no Superlead (msg_...), retornado por POST /v1/whatsapp/messages.
Response
Mensagem encontrada, com o status mais recente.
Id da mensagem no Superlead (msg_...).
"msg_9f8e7d6c-1a2b-3c4d-5e6f-7a8b9c0d1e2f"
Id da mensagem na Meta, referenciado pelos webhooks de status.
O external_id informado no envio, para reconciliação com o seu sistema.
"pedido-8734"
Destinatário da mensagem.
"+5511999999999"
Tipo da mensagem.
text, template, image, video, audio, document, sticker, location, contacts, interactive, reaction Status atual da mensagem:
accepted— aceita pelo canal; entrega ainda não confirmada.held_for_quality_assessment— retida pela Meta para avaliação de qualidade.paused— envio pausado pela Meta.sent— entregue ao servidor do WhatsApp.delivered— entregue ao aparelho do lead.read— lida pelo lead.failed— falhou; o motivo fica emerror.
accepted, held_for_quality_assessment, paused, sent, delivered, read, failed Data de criação (ISO 8601, UTC).
"2026-07-08T12:34:56.000Z"
Data da última transição de status. null se ainda não houve transição.
"2026-07-08T12:35:10.000Z"
Motivo da falha, presente quando status: "failed". null nos demais status.
Show child attributes
Show child attributes
Was this page helpful?