Pular para o conteúdo principal
GET
Consultar uma mensagem

Autorizações

Authorization
string
header
obrigatório

Autentique com uma chave secreta (sk_live_…) ou uma chave restrita (rk_live_…) criada no painel. Chaves restritas só têm as permissões escolhidas na criação, como messages:send, chats:read ou broadcasts:send.

Cabeçalhos

Blu-Version
string

A versão da API a usar. Por padrão, é a versão fixada na sua conta.

Exemplo:

"2026-10-11"

Parâmetros de caminho

chat
string
obrigatório
Pattern: ^chat_
message
string
obrigatório
Pattern: ^msg_

Parâmetros de consulta

expand[]
string[]

Campos a expandir em objetos completos, como contact, ou data.contact em listas.

Resposta

A mensagem.

O conteúdo da mensagem. type indica o objeto que guarda o conteúdo, como na API do WhatsApp Cloud.

type
string
obrigatório
Allowed value: "text"
text
object
obrigatório
id
string
obrigatório
Pattern: ^msg_
Exemplo:

"msg_Zt4b"

object
string
obrigatório
Allowed value: "message"
chat
obrigatório

Expansível.

Pattern: ^chat_
direction
enum<string>
obrigatório
Opções disponíveis:
inbound,
outbound
status
enum<string>
obrigatório

Mensagens enviadas passam de accepted para sent, delivered e read, ou terminam como failed. Mensagens recebidas ficam como received.

Opções disponíveis:
accepted,
sent,
delivered,
read,
failed,
received
errors
object[]
obrigatório

Por que a mensagem ficou como failed. Vazio nos outros casos.

context
object | null
obrigatório
broadcast
obrigatório

A campanha que enviou esta mensagem, se houver. Expansível.

Pattern: ^bcast_
pricing
object | null
obrigatório

Como a Meta cobra a mensagem. Preenchido em mensagens enviadas; nulo nas recebidas.

whatsapp_message_id
string | null
obrigatório

O id da mensagem no próprio WhatsApp.

created
integer
obrigatório

Horário Unix em segundos.

Exemplo:

1760190012

metadata
object
obrigatório

Até 50 pares de chave e valor seus. Chaves com até 40 caracteres e valores com até 500.