AstraChatn8n e WhatsApp: node grátis com botões, listas, ligações e IA
Para ligar o WhatsApp no n8n sem montar requisição HTTP, instale o community node n8n-nodes-astracalls, crie uma credencial com a URL e a API Key do seu AstraCalls e use os dois nodes que aparecem: o AstraCalls Trigger, que inicia o fluxo quando chega uma mensagem, e o AstraCalls, que envia texto, botões, listas, enquetes e faz ligações. O AstraCalls é a nossa API de WhatsApp open source, e o node é gratuito.
No vídeo eu instalo o node, mostro a credencial, o gatilho, os recursos e testo ao vivo uma lista interativa chegando no WhatsApp. Aqui está o passo a passo escrito, com os 10 fluxos prontos que deixamos para você importar.
O que você precisa
- Um AstraCalls instalado, com pelo menos um número conectado pelo QR Code no painel. A instalação está no artigo sobre ligações do WhatsApp no Chatwoot.
- A API Key do servidor, que é o valor da variável
WACALLS_API_KEYda stack. - Um n8n em que você seja o dono (owner) da instância. Só o owner instala community nodes.
O que o node faz
São dois nodes, os dois em português:
| Node | Função |
|---|---|
| AstraCalls | 55 operações em 8 recursos: Mensagem, Chamada, Grupo, Comunidade, Contato, Sessão, Formulário e Requisição Personalizada, que chama qualquer uma das 179 rotas da API |
| AstraCalls Trigger | Inicia o fluxo com 15 eventos, como mensagem recebida, leitura, reação, voto em enquete, formulário respondido, entrada e saída de grupo, gravação de chamada e desconexão da sessão |
A vantagem sobre o node HTTP Request é que você não monta URL, cabeçalho e corpo a cada chamada. A sessão é escolhida numa lista com nome e número, o destino aceita número com ou sem o nono dígito, e o gatilho já entrega os campos prontos para responder.
Passo 1: instalar o node no n8n
- No n8n, abra Settings e depois Community Nodes.
- Clique em Install, digite
n8n-nodes-astracalls, marque a ciência dos riscos e confirme. - Ao adicionar um node no fluxo, procure por AstraCalls. Os dois nodes aparecem.
Se o seu n8n roda em Docker, outra forma é colocar N8N_COMMUNITY_PACKAGES=n8n-nodes-astracalls nas variáveis do serviço e reiniciar. Quando sair versão nova, o próprio Community Nodes mostra o botão de atualizar.
Passo 2: criar a credencial
- Vá em Credentials, Add credential e escolha AstraCalls API.
- Em URL do Servidor, coloque o endereço do painel do AstraCalls, sem
/apino final. - Em API Key, cole o valor de
WACALLS_API_KEY. - Salve. Se der erro 401, a chave está errada. Se não conectar, confira a URL e se o servidor está no ar.
Passo 3: o gatilho e a primeira resposta automática
O fluxo mais simples responde quem manda mensagem:
- Adicione o AstraCalls Trigger, escolha a sessão e o evento Mensagem (Recebida ou Enviada).
- Deixe ligadas as opções Ignorar Mensagens Enviadas por Mim, para o fluxo não responder a si mesmo em loop, e Ignorar Mensagens de Grupos, se não quiser responder em grupo.
- Depois do gatilho, adicione o node AstraCalls com Recurso Mensagem e Operação Enviar Texto.
- Em Para, use
{{ $json.responderPara }}. Esse campo já traz o contato certo, ou o grupo quando a mensagem veio de um. - No texto, dá para usar
{{ $json.nome }}e{{ $json.texto }}para personalizar. - Ative o fluxo e mande uma mensagem para o número.
Para responder conforme o conteúdo, coloque um Switch entre o gatilho e o envio, olhando o campo texto. Se contém "preço", manda a tabela; se contém "horário", manda o expediente.
Uma dica do vídeo: antes de responder, use a operação Mostrar "Digitando..." e um node Wait de alguns segundos. A resposta parece mais humana.
Recursos e operações
Dentro do node AstraCalls, você escolhe um recurso e depois a operação:
- Mensagem: texto, imagem, vídeo, áudio, figurinha, localização, contato, botões, listas, enquetes, formulários nativos, reação, edição, apagar e mostrar digitando.
- Chamada: ligar, encerrar, ligação fantasma (o telefone do cliente toca e a chamada não completa, só para chamar a atenção) e disparo de ligações com áudio ou vídeo gravado, com status e histórico.
- Contato: verificar se um número tem WhatsApp, buscar foto e bloquear.
- Grupo e Comunidade: criar e administrar grupos e comunidades.
- Sessão: operações da conta de WhatsApp conectada.
- Formulário: formulários nativos do WhatsApp Business.
- Requisição Personalizada: qualquer rota da API que não tenha operação pronta.
A documentação completa, em Swagger, fica no próprio painel do AstraCalls, no ícone de livro no alto da tela.
Agente de IA no n8n que usa o WhatsApp como ferramenta
O node AstraCalls também pode ser ligado como ferramenta (Tool) do node AI Agent do n8n. O agente decide sozinho quando enviar mensagem, mandar localização, verificar se um número tem WhatsApp ou ligar para o cliente.
Para montar:
- Parta do fluxo do passo 3 e troque o envio direto por um node AI Agent, com o modelo de sua preferência e uma memória.
- No conector Tool do agente, adicione nodes AstraCalls com as operações que ele pode usar, por exemplo Enviar Texto, Enviar Localização e Ligar.
- Escreva na descrição de cada ferramenta quando o agente deve usá-la.
- Depois do agente, um node AstraCalls envia a resposta para
{{ $json.responderPara }}.
No n8n self-hosted, nodes da comunidade só funcionam como ferramenta com a variável N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true no serviço.
Outra opção é a ferramenta MCP Client do n8n apontando para o endereço /mcp do AstraCalls, com autenticação Bearer. Assim o agente acessa todas as ferramentas sem instalar o node. O mesmo MCP funciona fora do n8n, como mostro no artigo sobre WhatsApp no ChatGPT e no Claude com MCP. Para a parte de prompt, contexto e passagem para humano, veja como criar um agente de IA para WhatsApp.
Os 10 fluxos prontos para importar
Deixamos 10 fluxos de exemplo no guia do n8n no GitHub. Baixe o .json, importe pelo menu Import from File, escolha a credencial e a sessão em cada node AstraCalls e troque os números de exemplo (5511999999999). Cada fluxo tem uma nota amarela explicando como funciona.
| # | Fluxo | O que faz |
|---|---|---|
| 01 | Resposta fora do horário | Responde quem escreve fora do expediente |
| 02 | Menu com botões | Envia um menu e segue um caminho para cada botão |
| 03 | Lista de serviços e agendamento | Envia uma lista interativa, confirma a opção e reage à mensagem |
| 04 | Atendente de IA com ferramentas | AI Agent com memória que usa o AstraCalls como ferramenta |
| 05 | Pesquisa de satisfação | Envia uma enquete, agradece cada voto e avisa o gestor se a nota for ruim |
| 06 | Boas-vindas no grupo | Dá boas-vindas a quem entra, mencionando a pessoa |
| 07 | Disparo de ligações com áudio | Liga para uma lista tocando um áudio gravado e acompanha o status |
| 08 | Validar lista antes da campanha | Confere quais números têm WhatsApp e só envia para eles |
| 09 | Lembrete diário com toque | Envia um lembrete no horário marcado e faz o telefone tocar |
| 10 | Alerta de desconexão e restrição | Avisa quando a sessão cai ou recebe restrição do WhatsApp |
No teste do vídeo, disparei o fluxo 03 e a lista chegou assim no celular:
No vídeo eu destaco o fluxo 10 para quem dá suporte a clientes: você fica sabendo que o número caiu ou foi restringido antes do cliente reclamar. O fluxo 07 está detalhado no artigo sobre disparo de ligações no WhatsApp com n8n.
Antes de usar em produção
- Um gatilho por sessão. Cada sessão do AstraCalls tem um único webhook. Ao ativar um fluxo com o AstraCalls Trigger, ele assume o webhook da sessão e devolve o anterior quando é desativado. Se ativar dois fluxos com gatilho no mesmo número, o último vence. Junte os caminhos num fluxo só, com o Switch. A integração nativa com o Chatwoot não é afetada.
- Listas e botões dependem do aparelho. A nota do fluxo 03 avisa que a lista aparece no celular e pode não aparecer no WhatsApp Web. Teste no aparelho do cliente.
- Ligações e disparos só para quem autorizou. Envio em massa não solicitado bloqueia o número e viola a LGPD e as regras da Anatel. O AstraCalls é uma API não oficial, então use um número separado do principal para disparos.
Problemas comuns
| Sintoma | O que fazer |
|---|---|
| A sessão não aparece na lista | Confira a credencial e se o número está conectado no painel |
| A sessão aparece aguardando QR Code | Abra o painel do AstraCalls e pareie o número |
| O gatilho não dispara | O fluxo precisa estar ativo e o n8n precisa ser acessível pelo servidor do AstraCalls |
| Outro fluxo parou de receber eventos | Há dois gatilhos na mesma sessão; deixe só um |
| O agente não enxerga o AstraCalls como ferramenta | Falta a variável N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true |
Perguntas frequentes
Como conectar o WhatsApp no n8n?
Instale o community node n8n-nodes-astracalls em Settings, Community Nodes, crie uma credencial com a URL e a API Key do seu AstraCalls e use o AstraCalls Trigger para receber mensagens e o node AstraCalls para enviar. O número fica conectado no AstraCalls pelo QR Code.
O node do AstraCalls para n8n é grátis?
Sim. O node é gratuito e o AstraCalls é open source, sem cobrança por mensagem. Você paga só o servidor onde instala a API. Por ser uma API não oficial, existe risco de bloqueio do número em disparos em massa.
Dá para mandar botões e listas no WhatsApp pelo n8n?
Sim. O recurso Mensagem do node tem as operações de botões, listas, enquetes e formulários nativos, e o gatilho recebe a opção que o cliente escolheu. Os fluxos 02 e 03 do guia trazem exemplos prontos de menu com botões e de lista de serviços.
Como fazer um agente de IA no n8n responder pelo WhatsApp?
Use o AstraCalls Trigger para receber a mensagem, um node AI Agent com modelo e memória e ligue nodes AstraCalls no conector Tool do agente. No n8n self-hosted, ative a variável N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true. O fluxo 04 do guia já vem montado.
Dá para fazer ligação de WhatsApp pelo n8n?
Sim. O recurso Chamada do node liga, encerra, faz ligação fantasma e dispara ligações com áudio ou vídeo gravado para uma lista, com status e histórico de cada chamada.
Quer isso rodando sem montar servidor?
Instalamos o AstraCalls no seu servidor com tudo configurado e também fazemos projetos sob medida com a nossa API, para empresas que querem automatizar atendimento, cobrança ou agendamento pelo WhatsApp.
Se você atende com uma equipe, o AstraChat, a nossa versão do Chatwoot, junta multiatendimento, Kanban, agentes de IA e ligações pelo WhatsApp numa tela só. Ele vem na Comunidade Astra Online, com a primeira instalação feita pelo especialista em Chatwoot Raphael Popiolek. Chame no WhatsApp e conte o que você quer automatizar.
