Skip to main content
GET
/
v1
/
whatsapp
/
messages
/
{id}
Consultar Mensagem
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

​
Authorization
string
header
required

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
string
required

Id da mensagem no Superlead (msg_...), retornado por POST /v1/whatsapp/messages.

Response

Mensagem encontrada, com o status mais recente.

​
id
string

Id da mensagem no Superlead (msg_...).

Example:

"msg_9f8e7d6c-1a2b-3c4d-5e6f-7a8b9c0d1e2f"

​
wamid
string | null

Id da mensagem na Meta, referenciado pelos webhooks de status.

​
external_id
string | null

O external_id informado no envio, para reconciliação com o seu sistema.

Example:

"pedido-8734"

​
to
string | null

Destinatário da mensagem.

Example:

"+5511999999999"

​
type
enum<string>

Tipo da mensagem.

Available options:
text,
template,
image,
video,
audio,
document,
sticker,
location,
contacts,
interactive,
reaction
​
status
enum<string>

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 em error.
Available options:
accepted,
held_for_quality_assessment,
paused,
sent,
delivered,
read,
failed
​
created_at
string<date-time>

Data de criação (ISO 8601, UTC).

Example:

"2026-07-08T12:34:56.000Z"

​
status_updated_at
string<date-time> | null

Data da última transição de status. null se ainda não houve transição.

Example:

"2026-07-08T12:35:10.000Z"

​
error
object | null

Motivo da falha, presente quando status: "failed". null nos demais status.