API de Mensagens
A API de Mensagens permite que outros sistemas enviem mensagens pelo WhatsBlast de forma programática — sem intervenção manual. Ideal para integrar com sistemas de agendamento, ERPs, e-commerce ou qualquer plataforma que precise enviar notificações via WhatsApp.
Onde encontrar sua chave de API
Autenticação
Todas as requisições devem incluir o token no header:
Authorization: Bearer SEU_TOKEN_AQUI
Endpoints disponíveis
Enviar mensagem de texto
POST /api/messages/send
{
"number": "5518999991234",
"body": "Olá! Sua consulta foi confirmada para amanhã às 14h."
} Parâmetros opcionais:
| Campo | Tipo | O que faz |
|---|---|---|
msdelay | number | Atraso em milissegundos antes de enviar a mensagem |
quotedMsg | string | ID de uma mensagem para responder/citar |
userId | number | ID do atendente a quem o ticket gerado deve ser atribuído |
queueId | number | ID da fila para onde o ticket gerado deve ir |
sendSignature | boolean | Se true, inclui a assinatura do atendente/sistema na mensagem |
closeTicket | boolean | Se true, encerra o ticket automaticamente após o envio |
noRegister | boolean | Se true, envia a mensagem sem criar/registrar um ticket no sistema |
Enviar mensagem com arquivo (upload direto)
Para enviar imagem, PDF, áudio ou outro arquivo direto do seu sistema (sem precisar hospedar a URL),
envie como multipart/form-data no mesmo endpoint /api/messages/send,
incluindo o campo medias com o(s) arquivo(s):
POST /api/messages/send Content-Type: multipart/form-data number=5518999991234 body=Segue o documento solicitado medias=@arquivo.pdf
Enviar mensagem com imagem (via URL)
POST /api/messages/send/linkImage
{
"number": "5518999991234",
"body": "Segue o comprovante:",
"mediaUrl": "https://seusite.com.br/arquivo.jpg"
} Verificar se o número existe no WhatsApp
POST /api/messages/checkNumber
{
"number": "5518999991234"
} Enviar template oficial (conexão API Oficial / WABA)
Para conexões via API Oficial, mensagens iniciadas pela empresa fora da janela de 24h
devem usar um template aprovado pela Meta. Veja a documentação completa em
Templates Oficiais, incluindo o endpoint
POST /messages/template/:ticketId e os formatos de variáveis e componentes.
Formato de resposta
Em caso de sucesso, a API retorna 200 com os dados da mensagem criada:
{
"id": "3EB0...",
"ticket": { "id": 142, "status": "open" },
"number": "5518999991234",
"body": "Olá! Sua consulta foi confirmada..."
} Erros comuns
| Código | Causa | Solução |
|---|---|---|
401 | Token ausente, inválido ou de conexão desconectada | Confira o header Authorization e se a conexão correspondente está ativa |
400 | Campo number ou body ausente, ou formato de número inválido | Use o formato internacional: 55 + DDD + número, sem espaços ou símbolos |
404 | Conexão referente ao token não foi encontrada | Verifique se o token foi copiado corretamente, sem espaços extras |
500 | Erro ao enviar via conexão (ex: WhatsApp desconectado no momento do envio) | Verifique o status da conexão em Conexões antes de reenviar |
Formato do número
Use sempre o formato internacional sem espaços ou caracteres especiais:
55 (Brasil) + DDD + número. Exemplo: 5518999991234.
Casos de uso comuns
- Sistema de agendamento — envia lembrete automático quando uma consulta é marcada
- E-commerce — notifica o cliente quando o pedido é aprovado ou enviado
- ERP/CRM — dispara mensagem quando um boleto vence ou uma proposta é aprovada
- Formulários — confirma o recebimento de um cadastro ou inscrição