N8N e WhatsApp: node grátis com botões, listas, ligações e IA no AstraCalls

Link: https://chatwoot.astraonline.com.br/blog/n8n-whatsapp-node-astracalls/
Vídeo Youtube: https://youtu.be/Hs-xV2V-i1g
Fluxos download: https://github.com/AstraOnlineWeb/AstraCalls/blob/main/guias/n8n.md#-10-fluxos-de-exemplo-prontos
Tutorial: AstraCalls n... | Portal de Conhecimento
Por Raphael Popiolek · 
05 de novembro de 2026
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_KEY da 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.
 
Instalação pelo Community Nodes. Ao fundo, o pacote já instalado com os dois nodes.
 
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 
/api no 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.
 
A credencial pede só duas coisas: a URL do servidor e a API Key.
 
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.
 
Eventos do gatilho: além de mensagem, ele escuta voto em enquete, formulário, grupo e mais.
 
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:
 
Recursos do node. Cada um abre a sua lista de operações.
 
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.
 
Fluxo 04: o AI Agent com memória e as ferramentas do AstraCalls penduradas no conector Tool.
 
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:
 
Lista interativa enviada pelo fluxo 03: o cliente escolhe e a opção volta para o n8n.
 
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.
Falar com um especialistaConhecer o AstraChat
Mais artigos de API do WhatsApp e o Guia completo do Chatwoot, com todos os assuntos organizados.
Leia também
02 de novembro de 2026
Agente de IA do WhatsApp Business: é grátis, como ligar e limites
Agente de IA do WhatsApp Business (Meta Business Agent): o que faz, se é gratuito, como ativar e desativar e quando vale ter um agente próprio.
02 de novembro de 2026
Como criar um agente de IA para WhatsApp: método e 3 caminhos
Como criar um agente de IA para WhatsApp: função, tom, base de conhecimento, regra de passar para humano e testes. Sem programar, com n8n ou com código.
28 de outubro de 2026
Disparo de ligações WhatsApp com n8n: áudio e vídeo gravados
Disparo de ligações WhatsApp com n8n e AstraCalls: o sistema liga, toca seu áudio ou vídeo gravado e marca quem atendeu. Veja o fluxo e os cuidados.
© 2026 Astra Online · AstraChat · Blog · Canal no YouTube