Messages

POST /v1/messages (envia template/texto/mídia) e GET /v1/messages/{id} (consulta status).

POST /v1/messages

Envia uma mensagem: template, text ou mídia (image/video/document/audio).

POST /v1/messages 201400401402403404409422429

Headers: Idempotency-Key (opcional, recomendado).

Body (JSON):

{
  "to": "+5511999990000",
  "type": "template",
  "account_id": "ckv...",
  "template": { "name": "boas_vindas", "language": "pt_BR", "components": [] }
}

Campo	Tipo	Obrigatório	Regras
`to`	string	Sim	E.164. Regex ^\+?[1-9]\d{7,14}$. Normalizado internamente
`type`	enum	Sim	template \| text \| image \| video \| document \| audio
`account_id`	string	Não	Conexão; default = conexão padrão do usuário
`template`	object	Não	Obrigatório se type=template. { name (≥1), language (≥1), components? }
`text`	object	Não	Obrigatório se type=text. { body } — 1 a 4096 chars
`media`	object	Não	Obrigatório para tipos de mídia. { id (≥1), caption? (≤1024), filename? (≤255, só document) }

media.id é o media_id obtido em POST /v1/media.

Checagens pré-envio (nesta ordem)

Conta existe e pertence ao dono da chave → senão 404 ACCOUNT_NOT_FOUND.
Assinatura ACTIVE ou GRACE válida → senão 402 SUBSCRIPTION_REQUIRED.
Cap diário do tier não atingido → senão 429 TIER_DAILY_CAP_REACHED.
Contato não optou por sair → senão 403 CONTACT_OPTED_OUT.
Para não-template: houve inbound do contato nas últimas 24h → senão 409 WINDOW_CLOSED.

Templates aprovados ignoram a janela de 24h. Texto e mídia exigem janela aberta.

Resposta 201

{
"id": "msg_ckv...",
"meta_message_id": "wamid.HBgM...",
"to": "+5511999990000",
"status": "sent"
}

Campo	Descrição
`id`	ID interno (consultar em `GET /v1/messages/{id}`)
`meta_message_id`	ID da mensagem na Meta (casa com os webhooks)
`to`	Telefone normalizado (E.164)
`status`	Sempre `"sent"`. Mudanças de status chegam via webhook.

Exemplo

curl -X POST https://api.wablastmessage.com/v1/messages \
-H "Authorization: Bearer wak_sua_chave" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 9f1c-7b22-aa01" \
-d '{
  "to": "+5511999990000",
  "type": "text",
  "text": { "body": "Olá! Sua entrega chegou." }
}'

import crypto from 'node:crypto';
import fetch from 'node-fetch';

const res = await fetch('https://api.wablastmessage.com/v1/messages', {
method: 'POST',
headers: {
  'Authorization': 'Bearer ' + process.env.WABLAST_API_KEY,
  'Content-Type': 'application/json',
  'Idempotency-Key': crypto.randomUUID(),
},
body: JSON.stringify({
  to: '+5511999990000',
  type: 'text',
  text: { body: 'Olá! Sua entrega chegou.' },
}),
});
console.log(res.status, await res.json());

import os, uuid, requests

res = requests.post(
  'https://api.wablastmessage.com/v1/messages',
  headers={
      'Authorization': 'Bearer ' + os.environ['WABLAST_API_KEY'],
      'Idempotency-Key': str(uuid.uuid4()),
  },
  json={
      'to': '+5511999990000',
      'type': 'text',
      'text': {'body': 'Olá! Sua entrega chegou.'},
  },
)
print(res.status_code, res.json())

<?php
$ch = curl_init('https://api.wablastmessage.com/v1/messages');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ' . getenv('WABLAST_API_KEY'),
'Content-Type: application/json',
'Idempotency-Key: ' . bin2hex(random_bytes(8)),
]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
'to' => '+5511999990000',
'type' => 'text',
'text' => ['body' => 'Olá! Sua entrega chegou.'],
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$res = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE) . " " . $res;

GET /v1/messages/{id}

Consulta o status de uma mensagem.

GET /v1/messages/{id} 200401404429

Path: id (string, obrig.) — ID interno da mensagem.

Resposta 200

{
"id": "msg_ckv...",
"status": "DELIVERED",
"meta_message_id": "wamid.HBgM...",
"sent_at": "2026-06-22T14:03:11.000Z",
"error_code": null,
"error_message": null,
"created_at": "2026-06-22T14:03:10.000Z"
}

status ∈ SENT | DELIVERED | READ | FAILED. error_code/error_message preenchidos só em falha.