Documentação / Enviar mensagens

Enviar mensagens

Texto simples tem um atalho próprio. Para mídia, enquete e PIX, use o proxy /v1/wa, que repassa ao motor de WhatsApp com o seu token injetado no servidor.

Texto

POST/v1/messages/text

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":"vendas","number":"5511999999999","text":"Olá! 🚀"}'

Campo	Tipo	Descrição
`instance`	string	Nome da instância (campo `name` de `GET /v1/instances`).
`number`	string	Número com DDI+DDD, só dígitos. Ex.: `5511999999999`.
`text`	string	O texto da mensagem.

O proxy `/v1/wa`

Para os demais tipos, chame /v1/wa/<recurso>. Indique a instância no cabeçalho x-instance (se você só tem um número, pode omitir).

Como funciona: você fala só com a API do Visto Azul (sua API key). O token do motor é injetado no servidor e as respostas são limpas — o motor nunca é exposto.

Mídia (imagem, vídeo, documento)

POST/v1/wa/send/media

curl -X POST https://dashboard.vistoazul.com.br/api/v1/wa/send/media \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "x-instance: vendas" \
  -H "Content-Type: application/json" \
  -d '{"number":"5511999999999","type":"image","file":"https://site.com/foto.jpg","text":"Olha a novidade!"}'

Campo	Descrição
`type`	`image`, `video` ou `document`.
`file`	URL pública do arquivo (ou base64).
`text`	Legenda (opcional).

Enquete (poll)

POST/v1/wa/send/menu

curl -X POST https://dashboard.vistoazul.com.br/api/v1/wa/send/menu \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "x-instance: vendas" \
  -H "Content-Type: application/json" \
  -d '{"number":"5511999999999","type":"poll","text":"Qual horário prefere?","choices":["Manhã","Tarde","Noite"],"selectableCount":1}'

Cobrança PIX

POST/v1/wa/send/request-payment

curl -X POST https://dashboard.vistoazul.com.br/api/v1/wa/send/request-payment \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "x-instance: vendas" \
  -H "Content-Type: application/json" \
  -d '{"number":"5511999999999","amount":97.00,"pixKey":"sua-chave@email.com","pixType":"email","title":"Pedido #1234","text":"Segue seu PIX 💙","itemName":"Pedido #1234"}'

Campo	Descrição
`amount`	Valor em reais (ex.: `97.00`).
`pixKey`	Sua chave PIX.
`pixType`	Tipo da chave: `email`, `cpf`, `cnpj`, `phone` ou `random`.
`title` / `itemName`	Título do pagamento.
`text`	Mensagem que acompanha a cobrança.

Régua automática: no painel, a cobrança já agenda lembretes D+1/D+3/D+7. Veja como agendar em lote no guia de Campanhas.

Anterior← Primeiros passos PróximoCampanhas →