Documentação do Visto Azul

Conecte um número de WhatsApp e integre ao seu sistema via API REST e webhooks: enviar mensagens, disparo em massa com anti-ban, grupos, cobrança PIX e atendente de IA. Tudo por trás de um contrato estável /v1.

Início rápido

Toda chamada usa a sua API key (uma por conta) no cabeçalho Authorization. Pegue a sua em dashboard.vistoazul.com.br → Instâncias.

1. Base URL

https://dashboard.vistoazul.com.br/api/v1

2. Liste suas instâncias

curl https://dashboard.vistoazul.com.br/api/v1/instances \
  -H "Authorization: Bearer SUA_API_KEY"

3. Envie sua primeira mensagem

curl -X POST https://dashboard.vistoazul.com.br/api/v1/messages/text \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"instance":"sua-instancia","number":"5511999999999","text":"Olá! 🚀"}'

O que dá pra fazer

Autenticação

Autentique enviando sua API key como Bearer token. Ela identifica sua conta e todas as instâncias dela.

Authorization: Bearer SUA_API_KEY

• A API key é por conta, não por instância. Se você tem mais de um número, indique qual usar (veja cada guia).
• Nunca exponha a key no front-end. Use-a só do seu servidor.
• O token do motor de WhatsApp nunca é exposto — você fala só com a API do Visto Azul.

Respostas de erro

Erros vêm com status HTTP e um corpo JSON { "error": "..." }.

Status	Significado
200/201	Sucesso.
400	Parâmetro obrigatório faltando ou inválido.
401	API key ausente ou inválida.
402	Assinatura inativa — regularize o pagamento pra voltar a usar.
403	Sem permissão (ex.: instância de outra conta, ou limite do plano atingido).
404	Recurso não encontrado.