Referência da API

Todos os endpoints em um só lugar. Base: https://dashboard.vistoazul.com.br/api/v1 · Auth: Authorization: Bearer SUA_API_KEY.

Instâncias

Lista as instâncias da conta com status (connected/connecting/disconnected), número e perfil.

Cria uma instância. Corpo: { "name": "vendas", "settings"?: {…} }. Retorna a instância e o qrcode. 403 se o limite do plano foi atingido.

Gera um novo QR para reconectar.

Código de pareamento. Corpo: { "phone": "5511999999999" }.

Status detalhado da conexão.

Toggles: groupsIgnore, alwaysOnline, readMessages, rejectCall, msgCall, etc.

Define o endpoint de webhook. Veja Webhooks.

Remove a instância (204).

Mensagens

Corpo: { "instance", "number", "text" }.

Motor (proxy) — /v1/wa/*

Repassa ao motor de WhatsApp. Cabeçalho x-instance escolhe o número (omita se houver só um). Veja Enviar mensagens.

Método	Rota	Para quê
POST	/v1/wa/send/text	Texto. { number, text, mentions? }
POST	/v1/wa/send/media	Mídia. { number, type, file, text? }
POST	/v1/wa/send/menu	Enquete. { number, type:"poll", text, choices, selectableCount }
POST	/v1/wa/send/request-payment	Cobrança PIX. { number, amount, pixKey, pixType, title, text, itemName }
POST	/v1/wa/sender/simple	Envio/agendamento em lote. { numbers, type, text, delayMin, delayMax, scheduled_for?, folder? }
POST	/v1/wa/chat/check	Quem tem WhatsApp. { numbers }
POST	/v1/wa/group/create	Criar grupo. { name, participants }
GET	/v1/wa/group/list	Listar grupos.

Campanhas

Corpo: { instances[], template, recipients[], minDelayMs?, maxDelayMs? } → { campaignId }.

Status: { state, sent, failed, total }.

Funil de grupos

Corpo: { name, instance, jids[], slug?, capacity?, welcomeMsg?, fullMessage? }.

Link público de entrada (sem API key). Veja Grupos & Funil.

Códigos de status

Código	Significado
200/201	Sucesso.
400	Parâmetro faltando/inválido.
401	API key ausente ou inválida.
402	Assinatura inativa.
403	Sem permissão / limite do plano.
404	Não encontrado.