Funcionalidades da AstraCalls
Lista de funcionalidades possíveis com a AstraCalls

IA que atende e faz ligações no WhatsApp com AstraCalls
Link: https://chatwoot.astraonline.com.br/blog/ia-atende-ligacao-whatsapp/
Vídeo Youtube: https://www.youtube.com/watch?v=8tilgREKqv8
Download dos códigos: https://astraonline.com.br/wp-content/uploads/2026/10/Disparador-de-Ligacoes-e-Atendimento-com-IA.zip
Por Raphael Popiolek · 
28 de outubro de 2026 · Atualizado em 
03 de novembro de 2026
Uma IA que atende ligação no WhatsApp recebe a chamada, escuta o cliente e responde por voz, e também pode ligar sozinha para uma lista de números, deixando cada chamada gravada e transcrita num painel.
Muita empresa ainda perde ligação no WhatsApp porque ninguém está livre para atender, ou gasta horas de alguém ligando para cobrar e confirmar horário. Uma IA que atende ligação no WhatsApp resolve as duas pontas.
No vídeo eu monto esse sistema do zero, numa VPS limpa, usando o AstraCalls para a parte de chamadas e o Google Gemini com voz em tempo real para a conversa. Quem escreveu o código foi o Claude Code, rodando direto no servidor. Aqui eu explico o que foi feito, o que você precisa ter em mãos e os cuidados que ninguém deveria pular.
O que esse sistema faz na prática
O sistema montado no vídeo é um painel web com login e senha, rodando no seu próprio subdomínio. Dentro dele:
Conexões: você conecta um ou mais números de WhatsApp lendo o QR Code;
Ligações: a lista de chamadas recebidas e feitas, com a gravação para ouvir e a transcrição da conversa;
Disparador: você cola uma lista de números e o sistema liga para cada um, podendo alternar entre as conexões;
Configurações: o prompt do agente, a mensagem inicial, a chave da API do Gemini, o modelo e a voz, além das opções de atender automaticamente e gravar as chamadas.
No teste do vídeo eu liguei para o número conectado e pedi um agendamento. A IA atendeu, perguntou o assunto, pediu meu nome e empresa e confirmou o horário. Depois disso a chamada já apareceu no painel, gravada e transcrita.
As peças por trás do painel
Vale entender o que cada parte faz, porque é isso que você vai ajustar depois:
Peça
Função
AstraCalls
API de WhatsApp open source e não oficial que faz as chamadas de áudio (WebRTC)
Google Gemini (modelo de voz em tempo real)
Escuta e responde durante a ligação
SQLite
Banco simples para guardar conexões, ligações e configurações
Docker, Docker Swarm, Traefik e Portainer
Sobem o projeto e cuidam do SSL e do subdomínio
Claude Code
Escreve e publica o projeto a partir de um prompt
Escolhi o SQLite de propósito. O projeto é para uso de uma empresa, não para revenda, então um banco leve deixa a VPS menor e mais barata. Se a ideia for vender como serviço para vários clientes, aí a conversa é outra.
Sobre o modelo de voz: eu uso o Gemini porque gosto da voz e o custo é bom. A OpenAI também flui muito bem, mas no meu uso sai mais caro. Se for trocar, confira se o modelo responde por voz em tempo real. Numa ligação não dá para converter texto em áudio com atraso, senão a conversa fica travada.
O que você precisa antes de começar
Uma VPS com 2 a 4 GB de RAM e Ubuntu 22. No vídeo usei uma de 4 GB na Hetzner, mas qualquer provedor serve.
Acesso SSH como root (IP, porta 22 e senha). Eu uso o Bitvise para conectar.
Uma conta paga do Claude. O projeto é pequeno, mas a conta gratuita provavelmente vai travar no meio pedindo upgrade.
Um domínio com acesso ao DNS (eu uso o Cloudflare) para criar um subdomínio apontando para o IP da VPS.
Uma chave de API do Gemini, criada no Google AI Studio.
Um número de WhatsApp de teste para conectar.
O prompt completo e o tutorial com os comandos estão na página de apoio do vídeo, para baixar.
Passo a passo resumido
Crie a VPS e acesse pelo SSH.
Instale o Claude Code com o comando do tutorial e faça a autenticação pelo navegador. Ao copiar o código, aperte Ctrl+C uma vez só; duas vezes fecha o programa.
Crie uma pasta para o projeto (eu chamei de 
atendimento) e entre nela.
Abra o Claude Code no modo que não pede confirmação a cada passo, para ele executar até o fim sem você ficar apertando enter.
No DNS, crie o subdomínio apontando para o IP da VPS.
Troque, dentro do prompt, o subdomínio de exemplo pelo seu. Se preferir acessar por IP e porta, peça isso no prompt.
Cole o prompt e espere. No vídeo levou por volta de 10 minutos.
Entre no endereço com o e-mail e a senha que o Claude Code gerou.
Em Configurações, cole a chave do Gemini, escolha modelo e voz e salve.
Em Conexões, crie uma conexão e leia o QR Code com o número de teste.
Ligue para esse número de outro celular e veja a IA atender.
O prompt que deixo é a estrutura. O texto do agente vem com um padrão genérico ("você é um atendente virtual simpático e objetivo"), e é você quem escreve o que ele deve fazer na sua empresa.
Por que rodar numa VPS e não no seu computador
Dá para rodar local, mas eu não recomendo. O AstraCalls é sensível a ambiente, e cada computador tem um sistema diferente, o que gera conflito. Na VPS o ambiente é padronizado e o sistema fica no ar 24 horas: se cair a luz ou a internet do escritório, as ligações continuam. E no mesmo servidor você ainda pode colocar outros projetos.
Um erro que apareceu no teste: o nono dígito
Quando fui disparar uma ligação, a chamada não tocou. O problema era o nono dígito do celular. Tirei o 9 do número e a ligação saiu na hora. O painel marcou certinho uma chamada de saída (do disparador) e uma de entrada (a que eu fiz antes).
A lição: peça no prompt que o sistema trate o nono dígito e limpe os números antes de disparar. Eu já deixei esse ajuste no prompt salvo.
Onde isso ajuda e onde exige cuidado
Os usos mais diretos são cobrança, confirmação e marcação de horário e prospecção ativa. A IA liga, conversa e deixa tudo gravado e transcrito para alguém conferir depois.
Agora o lado honesto:
Risco de bloqueio. Disparo em massa sempre pode levar a banimento. Use números separados para isso, nunca o número principal da empresa, e não coloque em risco o número de um cliente seu. Os cuidados para ligar para uma lista estão no artigo sobre disparo de ligações no WhatsApp com n8n. A Meta costuma ficar mais rigorosa em ano de eleição.
API não oficial. O AstraCalls não é a API oficial da Meta. Funciona bem, mas o risco de bloqueio do número existe.
O prompt é com você. Sem um prompt bem escrito, a IA vai atender de forma genérica. Ela não sabe seus preços, horários ou regras se você não contar.
Infraestrutura. Mesmo com o Claude Code fazendo o grosso, você precisa saber acessar uma VPS, mexer em DNS e conferir se o projeto subiu.
Se o que você precisa é que os atendentes da equipe façam e recebam ligações dentro do Chatwoot, sem IA no meio, veja o artigo sobre ligações do WhatsApp no Chatwoot com o AstraCalls. E se quiser um agente de IA que responda por texto, com memória e transferência para humano, o caminho é este: chatbot com IA no WhatsApp.
Checklist antes de colocar em produção
 Subdomínio apontado e com SSL funcionando
 Prompt do agente escrito para o seu negócio, com o que ele pode e não pode prometer
 Tratamento do nono dígito testado com um número real
 Gravação e transcrição conferidas em algumas chamadas
 Número usado no disparo separado do número principal
 Backup da VPS configurado
Perguntas frequentes
Existe IA que atende ligação no WhatsApp?
Sim. O painel montado no vídeo usa o AstraCalls para as chamadas e o Google Gemini com voz em tempo real para a conversa. A IA atende, escuta o cliente, responde por voz e a chamada fica gravada e transcrita no painel.
Como fazer uma IA ligar para clientes pelo WhatsApp?
No mesmo painel há um disparador: você cola uma lista de números e o sistema liga para cada um, podendo alternar entre as conexões. Os usos mais diretos são cobrança, confirmação de horário e prospecção ativa.
Qual VPS usar para uma IA de voz no WhatsApp?
Uma VPS com 2 a 4 GB de RAM e Ubuntu 22, com acesso SSH como root. No vídeo foi usada uma de 4 GB, e o projeto usa SQLite justamente para manter o servidor menor e mais barato.
Qual modelo de IA usar para atender ligações?
O vídeo usa o Gemini com voz em tempo real, pela voz e pelo custo. A OpenAI também flui bem, mas sai mais cara no uso mostrado. Se trocar, confira se o modelo responde por voz em tempo real, senão a conversa fica travada.
Posso rodar a IA de ligação no meu computador?
Dá, mas não é recomendado. O AstraCalls é sensível a ambiente e cada computador tem um sistema diferente, enquanto a VPS tem ambiente padronizado e fica no ar 24 horas, mesmo se cair a luz ou a internet do escritório.
Quer isso junto do seu atendimento?
Esse painel é um projeto à parte. Se você quer as ligações e a IA dentro do mesmo lugar onde a equipe atende, o AstraChat, a nossa versão do Chatwoot, já traz ligações pelo WhatsApp, agentes de IA, Kanban, disparador e flows, no seu servidor, com a sua marca e sem limite de atendentes.
Ele vem na Comunidade Astra Online, com código-fonte, atualizações, grupo VIP e a primeira instalação feita pelo especialista em Chatwoot Raphael Popiolek. Se quiser um projeto de voz sob medida, integrado ao seu sistema, chame a gente no WhatsApp e conte o que precisa automatizar.
Falar com um especialistaConhecer o AstraChat
Mais artigos de IA no atendimento e o Guia completo do Chatwoot, com todos os assuntos organizados.
Leia também
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.
28 de outubro de 2026
Ligação WhatsApp no Chatwoot: o atendente liga e atende na tela
Ligação WhatsApp no Chatwoot com o AstraCalls: instale a API gratuita e ative um widget para o atendente ligar e receber chamadas sem sair da conversa.
05 de novembro de 2026
n8n e WhatsApp: node grátis com botões, listas, ligações e IA
Conecte o WhatsApp ao n8n com o node do AstraCalls: instalação, credencial, gatilho, botões, listas, ligações, agente de IA e 10 fluxos prontos.

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

Tutorial: AstraCalls no n8n com fluxos para botões, listas e outros recursos
Link: https://github.com/AstraOnlineWeb/AstraCalls/blob/main/guias/n8n.md#-10-fluxos-de-exemplo-prontos
Neste tutorial você conecta o AstraCalls ao n8n e monta um robô que responde mensagens de WhatsApp. Leva uns 10 minutos e não precisa programar.
📦 Node: 
n8n-nodes-astracalls. A documentação completa, com as 55 operações e os 15 eventos, está na página do npm.
Configurações iniciais: N8N e WhatsApp: node g... | Portal de Conhecimento
O que você precisa
Um AstraCalls rodando, com pelo menos uma sessão conectada (número pareado pelo QR Code no painel).
A API Key do servidor, que é o valor de 
WACALLS_API_KEY.
Um n8n onde você seja o dono (owner) da instância, porque só o owner instala community nodes.
Passo 1: instalar o node
No n8n, abra Configurações (⚙️) → Community Nodes → Install a community node.
Digite 
n8n-nodes-astracalls, marque a ciência dos riscos e clique em Install.
Ao adicionar um node, procure AstraCalls. Aparecem dois:
AstraCalls: faz ações, como enviar mensagem, ligar ou criar grupo.
AstraCalls Trigger: inicia o fluxo quando algo acontece, como uma mensagem recebida.
n8n em Docker: se preferir, adicione 
N8N_COMMUNITY_PACKAGES=n8n-nodes-astracalls nas variáveis do serviço e reinicie.
Passo 2: criar a credencial
Credentials → Add credential → AstraCalls API.
Preencha os dois campos:
Campo
Exemplo
URL do Servidor
https://calls.seudominio.com, o endereço do painel, sem 
/api no final
API Key
o valor de 
WACALLS_API_KEY
Clique em Save. Se aparecer ✅, está conectado.
401: a API Key está errada.
Não conecta: a URL está errada ou o servidor está fora do ar.
Passo 3: enviar a primeira mensagem
Crie um fluxo com um Manual Trigger e adicione o node AstraCalls depois dele.
Configure o node:
Recurso 
Mensagem · Operação 
Enviar Texto
Sessão: escolha o número na lista
Para: 
5511999999999. Use DDI + DDD + número; com ou sem o 9º dígito funciona.
Texto: 
Olá! Primeira mensagem pelo n8n 🚀
Clique em Test step. A mensagem chega no WhatsApp, e a resposta do node traz o 
id dela.
Passo 4: responder mensagens automaticamente
⚡ Atalho: baixe 
n8n/responder-mensagem.json e importe no n8n pelo menu ⋯ → Import from File. Depois escolha a credencial e a sessão nos dois nodes.
Para montar na mão:
Adicione o AstraCalls Trigger:
Sessão: o número que vai receber
Eventos: 
Mensagem (Recebida ou Enviada)
Deixe Ignorar Mensagens Enviadas por Mim ligado, para o fluxo não responder a si mesmo em loop.
Depois do gatilho, adicione o node AstraCalls (
Mensagem → Enviar Texto):
Sessão: 
{{ $json.sessao }}
Para: 
{{ $json.responderPara }}. Esse campo já traz o contato certo, ou o grupo quando a mensagem veio de um.
Texto: 
Oi {{ $json.nome }}! Recebi: "{{ $json.texto }}"
Ative o fluxo e mande uma mensagem para o número para testar.
Para responder conforme o conteúdo, coloque um Switch entre os dois nodes, olhando o campo 
texto. Por exemplo: se contém "preço", envia a tabela.
Passo 5 (opcional): agente de IA
Para que uma IA atenda pelo WhatsApp:
Use o fluxo do passo 4, mas troque o envio por um node AI Agent, com o modelo de sua preferência e uma memória.
Ligue o AstraCalls como ferramenta (Tool) do agente, por exemplo com a operação "Enviar Texto". O agente decide sozinho quando enviar mensagens, consultar contatos etc.
Outra opção é a ferramenta MCP Client do n8n apontando para o 
/mcp do AstraCalls, que dá ao agente acesso a todas as ferramentas, sem instalar o node. Veja a seção "MCP para agentes de IA" no README.
📚 10 fluxos de exemplo prontos
Baixe o 
.json, importe no n8n 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 automaticamente a quem escreve fora do expediente
02
Menu com botões
Envia um menu com botões e segue um caminho para cada opção (Switch)
03
Lista de serviços e agendamento
Envia uma lista interativa, confirma a opção escolhida e reage com ✅
04
Atendente de IA com ferramentas
AI Agent com memória que usa o AstraCalls como ferramenta (requer credencial OpenAI)
05
Pesquisa de satisfação (enquete)
Envia uma enquete para os clientes, agradece cada voto e avisa o gestor se a nota for ruim
06
Boas-vindas no grupo
Dá boas-vindas a quem entra no grupo, 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
Todo dia, no horário marcado, envia um lembrete 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
Os fluxos com AstraCalls Trigger (01 a 06 e 10) trocam o webhook da sessão quando ativados. Ative um por sessão, ou junte os caminhos num só fluxo (veja o aviso abaixo).
⚠️ Antes de usar em produção
Cada sessão tem um único webhook. Ao ativar um fluxo com o AstraCalls Trigger, o node coloca o webhook do n8n no lugar do que estava configurado. Ao desativar, restaura o anterior. Use um só gatilho por sessão e separe os caminhos com o Switch. A integração nativa com o Chatwoot não é afetada.
Ligações e disparos em massa só para quem autorizou o contato. Envio não solicitado bloqueia o número e viola a LGPD e as regras da Anatel.
Problemas comuns
Sintoma
Solução
A sessão não aparece na lista
Confira a credencial e se a sessão está conectada no painel
A sessão aparece como 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 (URL pública ou mesma rede)
Outro fluxo parou de receber eventos
Dois gatilhos na mesma sessão: o último ativado vence (veja o aviso acima)
Arquivos do projeto: