Skip to main content
GET
Consultar Mensagem

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.