vistoazul

n8n community node para a API de WhatsApp da Visto Azul: texto, midia (imagem/video/documento/audio/nota de voz), PIX, enquete, convite de calendario (.ics + Google Agenda), campanhas, contatos, grupos, checar numeros e webhook.

Package Information

Released: 2 mo ago
Downloads: 140 weekly / 140 monthly
Latest Version: 0.3.0

Documentation

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 SUA_API_KEY. 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.

Links

Licença

MIT

Discussion