Como conectar o WhatsApp ao n8n (enviar e receber mensagens)

O n8n é uma ferramenta de automação de código aberto. Com a API REST do Visto Azul, você pluga o WhatsApp em qualquer fluxo do n8n sem escrever um sistema do zero. Veja o passo a passo para enviar e receber mensagens.

Por que WhatsApp + n8n

O n8n conecta centenas de aplicativos em fluxos visuais (quando acontece X, faça Y). Ligando o WhatsApp a ele, você automatiza tarefas repetidas sem depender de um programador para cada integração. Exemplos comuns:

• Novo lead numa planilha ou formulário, envia uma mensagem de boas-vindas no WhatsApp.
• Pedido pago na sua loja, dispara a confirmação e o código de rastreio.
• Mensagem recebida no WhatsApp, cria um card no seu CRM ou notifica a equipe.
• Agenda cheia, manda o lembrete da consulta um dia antes.

A vantagem do Visto Azul aqui é o custo: você não paga taxa por mensagem para a Meta, e o anti-ban já vem ativado. Tudo pela nossa API REST.

O que você vai precisar

• Uma conta no Visto Azul com um número conectado (veja primeiros passos).
• A sua API key, que fica no painel, em Instâncias.
• O n8n (na nuvem ou self-hosted). Vamos usar dois nós nativos dele: HTTP Request e Webhook.

Base da API: https://dashboard.vistoazul.com.br/api/v1. Toda chamada leva o cabeçalho Authorization: Bearer SUA_API_KEY.

Enviar uma mensagem do n8n (HTTP Request)

Adicione um nó HTTP Request ao seu fluxo e configure assim:

• Method: POST
• URL: https://dashboard.vistoazul.com.br/api/v1/messages/text
• Authentication: Header, com Authorization = Bearer SUA_API_KEY
• Body (JSON): os campos instance, number e text

O corpo fica assim (o instance é o nome que aparece em GET /v1/instances):

{
  "instance": "vendas",
  "number": "5511999999999",
  "text": "Olá! Recebemos seu cadastro."
}

No n8n, você pode usar variáveis do passo anterior, por exemplo o número e o nome vindos de uma planilha, montando o texto dinamicamente. Para mandar imagem, vídeo ou PIX, use o proxy /v1/wa descrito na documentação de envio.

Receber mensagens no n8n (Webhook)

Para o fluxo começar quando chega uma mensagem, o caminho é o contrário: o Visto Azul avisa o n8n.

1. No n8n, crie um fluxo iniciado por um nó Webhook e copie a URL de teste/produção que ele gera.
2. No painel do Visto Azul, abra as configurações da instância (o ícone de engrenagem no card do número), vá na aba Webhook e cole essa URL.
3. Salve. A partir daí, cada mensagem recebida chega como um POST no seu fluxo do n8n, e você trata como quiser (responder, salvar no CRM, notificar a equipe).

Configuramos o webhook para postar na URL exata, sem pegadinhas de caminho, e por padrão ignoramos as mensagens que a própria automação envia, para não criar loop. Detalhes em Webhooks.

Exemplo de fluxo completo

Um caso clássico: dar boas-vindas a todo novo lead.

1. Gatilho: nova linha numa Google Sheet (ou resposta de um formulário).
2. Ação: nó HTTP Request para /v1/messages/text, com o número e o nome da linha.
3. Resultado: a pessoa recebe na hora uma mensagem personalizada no WhatsApp.

Depois é só evoluir: adicionar um IF para segmentar por origem, um Wait para espaçar os envios, ou um segundo passo que cria o contato no seu CRM.

Boas práticas para não ser bloqueado

• Espace os disparos em massa (adicione um Wait aleatório entre as mensagens).
• Varie o texto e personalize com o nome, evite mensagem idêntica para todo mundo.
• Use listas com opt-in e mensagens relevantes. Para volume alto, use nossas campanhas, que já trazem anti-ban e rotação de número.