Automação WhatsApp com Claude: Crie disparos em massa com IA
Aprenda a criar uma automação WhatsApp com Claude e n8n em menos de 10 minutos. Veja como usar o Claude Opus e o MCP para disparar mensagens em massa sem programar.
Resposta rápida: Você descreve o disparo que quer no Claude Code, com o modelo Opus, e ele monta o fluxo dentro do n8n pelo MCP: leitura da base de contatos, mensagem personalizada e intervalo entre os envios. O que decide o resultado não é o prompt, e sim a API do WhatsApp escolhida e a qualidade da lista: número frio e base sem opt-in derrubam a conta.
O que você vai ver aqui?
Introdução à automação de WhatsApp com Claude
Imagina descrever numa frase o que você quer construir e, em menos de 10 minutos, ter um sistema de automação de WhatsApp com Claude pronto, conectado a uma base de contatos e disparando mensagens em sequência, com delay automático entre elas. Sem contratar desenvolvedor. Sem arrastar um bloco sequer. Essa é a proposta do Claude Opus integrado ao n8n via MCP, e é exatamente o que você vai aprender a fazer aqui.
Neste artigo você vai entender como a combinação de Claude Code, n8n e uma API do WhatsApp forma uma stack de automação acessível e poderosa, inclusive para quem nunca criou um fluxo de automação antes. Vai ver também quais são as três opções de API disponíveis, quais os riscos reais de banimento e como fugir deles, e vai acompanhar o passo a passo completo para montar o fluxo do zero.
Para fazer o download dos arquivos utilizados na aula, preencha com o seu e-mail:
Não vamos te encaminhar nenhum tipo de SPAM! A Hashtag Treinamentos é uma empresa preocupada com a proteção de seus dados e realiza o tratamento de acordo com a Lei Geral de Proteção de Dados (Lei n. 13.709/18). Qualquer dúvida, nos contate.
Por que usar Claude e n8n juntos para automatizar o WhatsApp
Ferramentas de automação não são novidade. O que mudou nos últimos meses é a capacidade de descrever um fluxo em linguagem natural e deixar que um modelo de IA construa esse fluxo por você, dentro da ferramenta, sem que você precise entender cada nó ou configuração técnica. É exatamente isso que acontece quando você une Claude Code com o n8n.
O n8n já é uma referência em automações no-code. Se você ainda não conhece a plataforma, vale dar uma olhada no artigo o que é o n8n e como usar no dia a dia, que explica os conceitos básicos de workflows, nós e gatilhos. Agora, com o MCP configurado, o Claude Code passa a se comunicar diretamente com sua instância do n8n e cria fluxos inteiros a partir de um único prompt.
O que o n8n faz nessa automação
O n8n é o orquestrador do processo. Ele recebe a lista de contatos de uma Data Table, monta a mensagem para cada pessoa, chama a API do WhatsApp com os dados corretos e aplica um delay entre os envios para reduzir o risco de banimento. Toda essa lógica, que normalmente exigiria horas de configuração manual, foi montada pelo Claude em menos de 5 minutos.
Se quiser ver outros exemplos do que dá para construir com o n8n, o artigo sobre como criar um agente de IA com n8n e Telegram mostra uma aplicação parecida, mas voltada para atendimento automático via Telegram.
O que o Claude Opus faz que outros modelos não fazem
Quando você digita o prompt dentro do Claude Code, ele não só interpreta a instrução como também consulta a documentação da API do WhatsApp, lê as Data Tables disponíveis no n8n, monta o JSON do fluxo e publica tudo dentro da sua instância. Ele age como um desenvolvedor que lê a documentação, planeja a arquitetura e escreve o código, tudo em sequência, sem precisar de orientação intermediária.
O Claude Opus 4.8, lançado em maio de 2026, foi projetado especificamente para esse tipo de tarefa agêntica. O modelo avançou no score de coding agêntico do benchmark SWE-Bench Pro, subindo de 64,3% para 69,2%, o que significa que ele resolve mais problemas reais de código com menos tentativas. Para uma tarefa como criar um fluxo no n8n via MCP, esse diferencial se traduz diretamente em velocidade e precisão.
As 3 opções de API do WhatsApp: qual escolher antes de automatizar
Antes de mandar o primeiro prompt para o Claude Code, você precisa decidir por qual caminho vai conectar o WhatsApp à sua automação. Existem três opções bem distintas, e a escolha errada pode custar o número que você vai usar.
| Critério | Oficial Meta | Não Oficial Grátis | Não Oficial Paga | Indicada para |
|---|---|---|---|---|
| Custo | R$ 0,03–0,40/conv. | Só o servidor | ~R$ 90/mês | Volume alto |
| Facilidade | Média | Difícil | Fácil | Iniciantes |
| Texto livre | Não | Sim | Sim | Mensagens personalizadas |
| Risco banimento | Baixo | Alto | Alto | Bases opt-in |
API Oficial da Meta: mais segura, mas com burocracia
A API oficial é a única autorizada diretamente pela Meta, dona do WhatsApp. O modelo de cobrança funciona por conversa com janela de 24 horas, não por mensagem individual. No Brasil, os valores giram em torno de R$ 0,03 a R$ 0,40 por conversa dependendo do tipo de iniciação.
O ponto negativo está no processo de cadastro: você precisa ter uma empresa verificada, criar uma conta no Meta Business Manager e ter modelos de mensagem aprovados antes de poder disparar qualquer texto proativo. Para quem está só testando ou quer agilidade, isso pode ser um bloqueio. Para operações maiores com base quente e foco em conformidade, é a opção certa.
APIs não oficiais gratuitas (Evolution API): liberdade com risco
A Evolution API é um projeto open-source brasileiro que se conecta ao WhatsApp via QR Code, exatamente como o WhatsApp Web. Você instala no seu próprio servidor, não paga por mensagem e pode enviar texto livre sem precisar de modelo aprovado.
A contrapartida é o risco elevado de banimento. O risco não está no volume absoluto de mensagens, mas na relação entre qualidade e volume. Uma taxa de bloqueio acima de 2% já é suficiente para comprometer a conta. Para quem está testando com uma base pequena e controlada, a Evolution API é um ponto de partida válido.
No nosso projeto agentes de IA no WhatsApp com n8n usa exatamente a Evolution API e mostra como configurar o webhook para receber mensagens no fluxo.
APIs não oficiais pagas (UAZAPI, Z-API): meio-termo acessível
UAZAPI e Z-API funcionam da mesma forma que a Evolution, com conexão por QR Code, mas alguém cuida do servidor por você. Você paga uma mensalidade em torno de R$ 90 por número e ganha suporte em português.
É importante entender que, por serem não oficiais, o risco de banimento é igual ao da versão gratuita. O que você compra é conveniência operacional: sem precisar gerenciar servidor, com suporte para resolver problemas quando a automação parar. Para quem não quer mexer com Docker ou VPS mas também não quer passar pela burocracia da Meta, é um caminho razoável.
ComunidadeImpressionadora
Aprenda, em um só lugar, as habilidades mais importantes do mercado — do básico ao avançado. Desenvolva projetos práticos e se torne um profissional pronto para se destacar.
Começar agora
O que você precisa antes de começar a automação
Para replicar a automação de disparo em massa, você vai precisar de cinco elementos funcionando antes de abrir o terminal:
- Claude Code instalado no seu VS Code: a ferramenta da Anthropic que roda diretamente no terminal ou dentro de uma IDE. Você pode consultar o guia completo de instalação e configuração no nosso artigo sobre Claude Code, que explica desde a instalação até o uso de MCPs e Skills.
- n8n na versão 2.14.1 ou superior: essa versão é a que trouxe o suporte ao Instance Level MCP, que permite que o Claude Code crie e execute workflows diretamente dentro da instância. Como detalhado no artigo sobre Claude Code e n8n, versões anteriores não suportam essa integração.
- MCP do n8n configurado dentro do Claude Code: sem o MCP, o Claude não tem como se comunicar com o n8n. O processo de configuração é mostrado em detalhes no mesmo artigo mencionado acima.
- Uma conta ativa em alguma API do WhatsApp: Evolution API, UAZAPI, Z-API ou a API oficial da Meta. Você vai precisar da chave de API e da documentação da ferramenta escolhida para passar ao Claude no prompt.
- Um número de WhatsApp separado para testes: nunca use o número pessoal que você usa no dia a dia. O risco de banimento durante testes é real, e perder o número principal é um problema que não se desfaz.
Como criar o disparo em massa com Claude Code e n8n, passo a passo
Com tudo configurado, o fluxo de criação é surpreendentemente direto. O Claude Code faz a parte pesada enquanto você acompanha cada etapa sendo executada em tempo real no terminal.
Abra o Claude Code no VS Code e selecione o modelo Opus
Com o VS Code aberto, clique no ícone do Claude que aparece na barra lateral direita para abrir a janela do Claude Code. Dentro dela, localize o seletor de modelo, clique na barra de modelos disponíveis e selecione o Opus. É com esse modelo que a tarefa de criar o fluxo vai ser executada, pois ele tem o melhor desempenho em tarefas agênticas que exigem consulta a documentações externas e criação de código estruturado.
Você também pode configurar o modo de execução. O automode, que deixa o Claude agir sequencialmente sem pedir confirmação a cada etapa, é o mais indicado para essa tarefa. Se preferir revisar cada ação antes que ela aconteça, o modo de planejamento permite isso.
Escreva o prompt certo para gerar o fluxo no n8n
O prompt não precisa ser técnico. O que ele precisa ter é clareza sobre o objetivo e, de preferência, a documentação da API que você vai usar colada junto. Um exemplo funcional:
"Utilize o MCP do n8n para criar uma automação que faça disparo de mensagens em massa no WhatsApp. A automação deve ler uma base que está nas Data Tables do n8n e usar a API da [nome da sua API] seguindo essa documentação: [cole aqui a documentação]."
Com esse prompt, o Claude vai consultar o MCP para entender a estrutura do n8n, ler a documentação da API do WhatsApp que você passou, verificar as Data Tables disponíveis na sua instância e construir o fluxo completo, incluindo o nó de loop por contatos, o nó de envio via API e o nó de delay entre mensagens.
Importe a base de contatos via Data Table no n8n
Dentro do n8n, vá até a seção Overview e clique em Data Tables. Crie uma nova tabela arrastando o arquivo CSV de contatos para dentro da interface. O n8n vai reconhecer automaticamente as colunas e criar a tabela com os cabeçalhos correspondentes.
O CSV de contatos precisa ter pelo menos duas colunas: o nome do contato e o número de telefone no formato internacional (com código do país e DDD, sem espaços ou caracteres especiais). O arquivo de exemplo está disponível para download no início deste artigo.
Ajuste o nó de contatos e ative o fluxo
Quando o Claude terminar de criar o fluxo, ele vai gerar um link direto para abrir dentro da sua instância do n8n. Clique nesse link e localize o nó de busca de contatos. Abra as configurações do nó e selecione a Data Table que você acabou de criar.
Antes de ativar, verifique se a API key da sua conta no WhatsApp está configurada corretamente no nó de envio. Com tudo ajustado, clique em Activate no canto superior direito do n8n. O fluxo vai começar a iterar pela lista de contatos e enviar as mensagens com o delay configurado entre cada envio.
Cuidados obrigatórios para não ser banido no WhatsApp
Automação de WhatsApp é uma faca de dois gumes. Bem usada, escala a comunicação sem esforço. Usada sem critério, queima o número em questão de dias. Antes de disparar qualquer campanha, entenda os dois conceitos que definem se sua conta vai sobreviver ou não.
O que é número frio e por que ele queima sua conta
Número frio é qualquer contato com quem você nunca trocou uma mensagem manual. O WhatsApp, seja pela API oficial ou pelas não oficiais, monitora padrões de comportamento. Quando um número começa a receber mensagens de um remetente com quem nunca interagiu, a tendência é que marque como spam ou bloqueie.
Uma taxa de bloqueio acima de 2% já é suficiente para degradar o Quality Rating da conta e, dependendo do volume, acionar o banimento. O erro mais comum é começar com um volume alto de disparos para uma base que nunca teve contato anterior com o número da automação.
O caminho seguro é aquecer o número gradualmente: comece com 50 a 100 mensagens por dia para uma base quente e aumente em torno de 20% por semana. Nunca pule etapas.
A regra do opt-in que ninguém pode ignorar em 2026
Opt-in significa que o contato autorizou explicitamente receber suas mensagens. Lista comprada, número aleatório ou base antiga sem contato nos últimos seis meses são todas fontes de número frio, independente da API que você usa.
Em 2026, isso deixou de ser só uma boa prática e passou a ter implicação legal direta. Disparar sem opt-in válido gera risco duplo: banimento pela Meta e autuação pela ANPD por violação da LGPD. O cuidado não é opcional.
Para bases antigas com mais de seis meses sem contato, a prática recomendada é o double opt-in: enviar primeiro uma mensagem pedindo confirmação e só adicionar ao fluxo de disparo quem confirmar interesse.
Conclusão
Criar um sistema de disparo em massa no WhatsApp costumava exigir conhecimento técnico, horas de configuração e, muitas vezes, um desenvolvedor envolvido. Com a combinação de Claude Code, n8n e MCP, esse processo se resume a descrever o que você quer e deixar o modelo mais avançado da Anthropic montar o fluxo por você em menos de 10 minutos. O resultado é o mesmo, mas o caminho é completamente diferente.
Se você quer dominar Claude Code, MCPs, integrações com n8n e muito mais, conheça o Claude Impressionador, o curso completo da Hashtag Treinamentos sobre o ecossistema Claude. Você vai aprender a usar Claude Chat, Claude Cowork e Claude Code na prática, com projetos reais e suporte em cada etapa.
Caso prefira esse conteúdo no formato de vídeo-aula, assista ao vídeo abaixo ou acesse o nosso canal do YouTube!
O que você aprende neste vídeo
Resposta rápida: Compara as três formas de ligar o WhatsApp ao n8n: a API oficial da Meta, que cobra por mensagem e tem risco menor de banimento, a não oficial gratuita, como a Evolution, e a não oficial paga, escolhida pelo suporte. O limite vale para as três: nenhuma é livre de banimento.
Neste vídeo (15 min):
- 2:45 - Apresenta as três formas de ligar o WhatsApp ao n8n: API oficial da Meta, API não oficial gratuita e API não oficial paga.
- 3:22 - Explica o que é uma API com a analogia do garçom.
- 5:04 - Explica o que é número frio e por que disparo automático para ele aumenta o risco de banimento.
- 6:53 - Recomenda nunca testar automação no número de WhatsApp pessoal, e sim num número comprado só para isso.
- 7:28 - Passa a construir a automação no Claude Code, dentro do VS Code, com o modelo Opus 4.8.
- 8:26 - O prompt pede para o MCP do n8n ler a base nas data tables e usar a API paga escolhida, seguindo a documentação dela anexada.
- 9:15 - Justifica a API paga em vez da gratuita Evolution, usada num vídeo anterior, pela diferença no suporte quando dá problema.
- 9:53 - Coloca o Claude Code no auto mode para ele executar as etapas sozinho, sem pedir confirmação a cada uma.
- 11:15 - O fluxo fica pronto em menos de 5 minutos, com link de acesso e descrição escrita pelo próprio Claude Code.
- 12:10 - Cria a base de contatos arrastando um arquivo CSV para dentro das data tables do n8n.
Trechos do vídeo:
- API é o garçom da internet: leva a informação de um lado para o outro, do cliente para a cozinha.
- Número frio é aquele com quem você nunca trocou mensagem, e disparar mensagens automáticas para muitos números assim é o que nenhum humano faria, por isso aproxima a conta do banimento.
- Não existe forma 100% livre de banimento, nem pela API oficial da Meta: sem aquecer o número e sem o aceite de quem recebe, o risco continua.
- A diferença entre API de WhatsApp paga e gratuita está no suporte: pagando, alguém tem a obrigação de responder quando a automação quebra; de graça, a ajuda existe, mas sem esse compromisso.
Perguntas frequentes sobre automação de WhatsApp
1. Preciso saber programar para criar essa automação com Claude e n8n?
Não. O Claude Code recebe um prompt em linguagem natural e monta o fluxo inteiro dentro do n8n por você. Você precisa saber configurar o ambiente (VS Code, Claude Code e MCP do n8n), mas não precisa escrever nenhuma linha de código. O artigo sobre Claude Code e n8n mostra o passo a passo da configuração inicial.
2. Qual API do WhatsApp é mais segura para usar com essa automação?
Para quem prioriza segurança e conformidade, a API oficial da Meta é a indicada. O risco de banimento é menor, especialmente se você usar modelos de mensagem aprovados e uma base com opt-in claro. Para testes e volumes menores, a Evolution API (gratuita) é uma alternativa funcional, mas exige atenção redobrada ao volume diário e à qualidade da base.
3. É possível personalizar as mensagens para cada contato na automação?
Sim. O n8n permite montar mensagens dinâmicas usando os dados de cada linha da Data Table. Você pode incluir o nome do contato, referências personalizadas ou qualquer outro campo que esteja na sua base. O Claude já configura essa lógica de personalização no fluxo quando você menciona isso no prompt inicial.
4. Quantas mensagens dá para disparar por dia sem queimar o número?
Não existe um número único: o limite depende da idade do chip, do histórico de conversa e de quantas pessoas marcam o contato como spam. A prática que segura a conta é começar baixo, com dezenas de envios por dia, subir aos poucos ao longo de semanas e manter o intervalo entre as mensagens que o fluxo do n8n já aplica.
5. Preciso deixar o computador ligado para a automação rodar?
Depende de onde o n8n está. Na instalação local, o fluxo só dispara com a máquina ligada e o serviço no ar. Em uma instância na nuvem, própria ou na versão hospedada do n8n, o agendamento roda sozinho e o seu computador serve apenas para montar e editar o fluxo.
Hashtag Treinamentos
Para acessar outras publicações de No Code, clique aqui!
Posts mais recentes de No Code
- Dots do ChatGPT: o que é e como usar esse agente de IA
Descubra o que é o Dots do ChatGPT, como configurar, integrar com Slack e agenda e se vale a pena usar esse novo agente de IA da OpenAI. - GPT-6 Astra: 7 usos reais do novo modelo da OpenAI
Veja 7 usos reais do GPT-6 Astra, o novo modelo da OpenAI que executa tarefas sozinho no computador. Entenda como ele funciona e onde ainda erra. - Jev IA: o que é e como usar essa IA que não escreve
Entenda o que é o Jev IA, a inteligência artificial classificadora mais rápida e barata do mercado, e veja 5 usos práticos para seus fluxos.
Posts mais recentes da Hashtag Treinamentos
- Planilha de Controle de Notas Fiscais no Excel [Grátis]
Baixe a planilha de controle de notas fiscais no Excel grátis: calcule ISS e retenções, veja o que está em aberto e gere a cobrança de cada nota de serviço. - Qual IA usar na empresa: ChatGPT, Claude ou Perplexity?
Qual IA usar na empresa: veja as diferenças entre ChatGPT, Claude e Perplexity e quando cada um rende mais em cada área da sua equipe. - Apostilas Gratuitas em PDF: Excel, Power BI, Python e IA
Baixe apostilas gratuitas em PDF de Excel, Power BI, Python, Claude e agentes de IA, com exercícios e gabarito. Escolha a sua e comece hoje.
