Description
n8n-nodes-vistoazul
> Node community do n8n para a API de WhatsApp da Visto Azul. Envie texto, mídia, cobrança PIX, dispare campanhas com anti-ban, gerencie contatos e receba mensagens por webhook para acionar seus fluxos e agentes de IA.
Sem taxa por mensagem da Meta, com PIX nativo e anti-ban de fábrica. A API REST é o core: plugue no n8n em minutos.
Palavras-chave: WhatsApp API, n8n, automação de WhatsApp, chatbot WhatsApp, PIX no WhatsApp, webhook WhatsApp, API WhatsApp Brasil.
—
Instalação
No n8n (self-hosted), vá em Settings → Community Nodes → Install e informe:
n8n-nodes-vistoazul
Ou via npm, na pasta de custom nodes do n8n:
npm install n8n-nodes-vistoazul
Credencial
Crie uma credencial Visto Azul API:
1. Crie sua conta em https://dashboard.vistoazul.com.br
2. Conecte seu número lendo o QR code (em Instâncias)
3. Copie sua API key e cole no campo API Key da credencial
O node usa Authorization: Bearer SUAAPIKEY. O campo Base URL já vem preenchido (https://dashboard.vistoazul.com.br/api/v1).
Nós incluídos
Visto Azul (ação)
| Recurso | Operações |
|—|—|
| Mensagem | Enviar Texto · Enviar Mídia · Enviar PIX · Enviar Enquete |
| Contato | Criar/Atualizar · Listar (por tag) · Importar |
| Campanha | Criar (disparo em massa com anti-ban) · Status |
| Instância | Listar · Criar (devolve QR code) |
| Chat | Checar Números (quem tem WhatsApp) |
| Grupo | Criar |
Visto Azul Trigger (gatilho)
Recebe cada mensagem do WhatsApp como um evento no n8n. Ao ativar o workflow, o node registra o webhook automaticamente na sua instância; ao desativar, ele limpa. Basta informar o nome da Instância. Ideal para chatbots e agentes de IA (ex.: responder com um modelo de linguagem).
Exemplo de uso
1. Visto Azul Trigger → recebe a mensagem
2. Um nó de IA (ex.: um modelo de linguagem) gera a resposta
3. Visto Azul → Mensagem → Enviar Texto → responde no WhatsApp
Boas práticas (anti-ban)
- Aguarde de 3 a 5 segundos entre chamadas sequenciais.
- Personalize e varie o texto. Para volume, use Campanha (já traz rotação e delays).
- Valide números com Chat → Checar Números antes de disparar.
- 🌐 Site: https://vistoazul.com.br
- 📚 Documentação: https://vistoazul.com.br/docs
- 🧩 Skill para Claude / agentes: https://github.com/vistoazul/claude-whatsapp-skill
