Guia exclusivo
@ivanmsneto
0 de 8 passos
✦ Guia exclusivo

Conecta o Claude no WhatsApp

Aqui você monta um atendente no WhatsApp do seu negócio que responde dúvidas com os seus fatos, anota cada contato numa planilha e passa a conversa pra uma pessoa quando precisa. Tudo sem escrever código.

8 passos Sem código Conferido nas páginas oficiais em out/2026
Entrada
WhatsApp
Cliente manda mensagem pela API oficial da Meta
Orquestra
n8n
Recebe, filtra só texto e liga os blocos
Cérebro
Claude Haiku 5.5
Responde só com os fatos do seu negócio
Saída
Resposta
Volta pro cliente no mesmo chat
Registro
Google Sheets
Cada contato vira uma linha com status
Exceção
Equipe humana
Lesão, reclamação ou pedido de pessoa: o robô transfere

O exemplo é um estúdio de pilates fictício, o Studio Movimento. Troque pelos dados do seu negócio.

Telas, nomes e preços mudam. Confira o link oficial de cada passo antes de pagar qualquer coisa.

Antes de começar

O que você precisa ter em mãos e o que vai anotar no caminho.

Contas

  • Conta do Facebook (vira conta de desenvolvedor na Meta)
  • Conta no Console do Claude, com créditos de API
  • n8n: Cloud (pago, 14 dias de teste) ou Community (grátis, no seu servidor)
  • Conta do Google, para a planilha e o Gmail

Não precisa

  • Saber programar
  • Chip novo para testar: a Meta dá um número de teste
  • Assinatura do app do Claude: a API é cobrada à parte, por uso

O que você vai anotar

DadoOnde apareceOnde vai
Phone number IDpasso 1 API Setuppasso 4 nó Responde
WhatsApp Business Account IDpasso 1 API Setuppasso 4 credencial WhatsApp API
Token do usuário do sistemapasso 2 System userspasso 4 credencial WhatsApp API
Chave da API do Claude sk-ant-…passo 3 Consolepasso 4 credencial Anthropic
App ID e App Secretpasso 4 App settings > Basicpasso 4 credencial WhatsApp OAuth API

Token e chave dão acesso ao WhatsApp e à conta de API do seu negócio. Guarde num gerenciador de senhas, nunca em arquivo compartilhado ou print.

O passo a passo

Marque cada passo como concluído: o progresso fica salvo e aparece no topo.

01

Pegue o número de teste na Meta

Em developers.facebook.com/apps
  1. Entre em developers.facebook.com/apps com a sua conta do Facebook (na primeira vez, faça o cadastro de desenvolvedor) e clique em Create App.
  2. Dê um nome, escolha o caso de uso Connect with customers through WhatsApp e selecione um portfólio empresarial (business portfolio), ou crie um.
  3. Na tela do WhatsApp, clique em Start using the API. Em API Setup, a Meta cria sozinha um número de teste: ele serve pra testar tudo sem chip novo, mandando mensagem pros números que você cadastrar.
  4. Clique em Generate access token, escolha o número de teste em From, ponha o seu WhatsApp em To e clique em Send message. Chega no seu celular o modelo hello_world. Responda essa mensagem: isso abre a conversa.

Anote os 2 IDs que aparecem na mesma tela: o Phone number ID (o número de teste) e o WhatsApp Business Account ID (a sua conta do WhatsApp na Meta). Eles vão pro n8n no passo 4.

Pronto quando: você respondeu o hello_world e anotou os 2 IDs
02

Gere a chave que não vence

Um usuário do sistema nas configurações do negócio

A chave (token) do API Setup é temporária e vence rápido. É por isso que tanto robô para no dia seguinte. Pro robô funcionar sozinho, gere a chave de um usuário do sistema.

  1. Abra as configurações do negócio e clique em System users. Clique em Add e crie o usuário (no exemplo, n8n-whatsapp).
  2. Selecione esse usuário e clique em Assign assets: no seu app, ligue Manage app em controle total (Full control); na sua conta do WhatsApp, ligue Manage WhatsApp Business accounts em controle total.
  3. Clique em Generate token, escolha o seu app, a validade que não vence (Never, se aparecer) e marque só estas 3 permissões:
business_management whatsapp_business_messaging whatsapp_business_management

Copie a chave na hora e guarde num lugar seguro: ela dá acesso ao WhatsApp do seu negócio. Se vazar, revogue e gere outra.

Pronto quando: o token permanente está guardado
03

Crie a chave da API do Claude

No Console do Claude, em platform.claude.com

O robô usa a API do Claude, que é cobrada por uso, à parte da assinatura do app.

  1. Entre no Console do Claude e crie a sua conta, se ainda não tiver.
  2. Créditos. Sem plano ou no Pro, compre créditos em Billing, no botão Buy credits. Os planos Max 5x e Max 20x trazem US$ 100 e US$ 200 de créditos de API por mês: no claude.ai, em Settings > Billing, ligue a sua organização do Console em Link organization.
  3. Abra API keys, clique em Create key, dê um nome como robo-whatsapp e copie a chave, que começa com sk-ant-. Ela só aparece uma vez.

O ID do Claude Haiku 5.5 na API:

claude-haiku-5-5

O Haiku 5.5 é o modelo mais rápido e mais barato do Claude: US$ 0,10 por milhão de tokens de entrada e US$ 0,50 por milhão de saída. Pra atendimento com fatos fixos, ele dá conta. Se quiser respostas mais caprichadas, troque pelo Sonnet 5.5 (claude-sonnet-5-5) no n8n, a qualquer hora.

Pronto quando: a chave sk-ant- está guardada e há créditos
04

Ligue os blocos no n8n

Gatilho → filtro → agente de IA → resposta

Use o n8n na nuvem (o n8n Cloud é pago, com 14 dias de teste) ou instalado num servidor seu (a edição Community é grátis). Use a versão mais nova, que já lista os modelos atuais do Claude.

a. Credenciais

No app da Meta, em App settings > Basic, copie o App ID e o App Secret.

Credencial no n8nCampoO que vai
WhatsApp OAuth API
(gatilho)		Client ID
Client Secret		App ID
App Secret
WhatsApp API
(envio)		Access Token
Business Account ID		Token do passo 2
WhatsApp Business Account ID
AnthropicAPI KeyChave do passo 3

A documentação do n8n pede ainda, no app da Meta, os links da política de privacidade e dos termos, e o app no modo Live.

b. Os blocos (nós), nesta ordem

1WhatsApp Trigger
Trigger OnMessages
Options › Receive Message Status Updatesdeixe vazio
2Ifnome: É texto?
Condição{{ $json.messages[0].type }}
is equal totext
falseo fluxo para (áudio e foto ficam pra equipe)
3AI Agent
Source for PromptDefine below
Prompt (User Message){{ $json.messages[0].text.body }}
Options › System Messageo prompt do passo 5
Chat ModelAnthropic Chat Model, modelo claude-haiku-5-5
MemorySimple Memory
Session IDDefine below
Key{{ $('WhatsApp Trigger').item.json.messages[0].from }}
ToolGoogle Sheets (passo 6)
4WhatsApp Business Cloudnome: Responde
OperationSend
Sender Phone Number (or ID)o Phone number ID
Recipient's Phone Number{{ $('WhatsApp Trigger').item.json.messages[0].from }}
Text Body{{ $json.output }}

Por que deixar vazio o Receive Message Status Updates: a Meta avisa o n8n a cada mensagem enviada, entregue e lida. Vazio, só mensagem nova de cliente aciona o robô.

A Simple Memory com o número do cliente na Key separa a conversa de cada pessoa: o Claude lembra o que a Carla disse sem misturar com o Bruno.

c. Teste e publique

A Meta aceita um endereço de aviso (webhook) por app, e o de teste do n8n substitui o de produção. Teste com o fluxo despublicado, mandando mensagem do seu celular pro número de teste. Quando estiver tudo certo, clique em Publish e mande outra mensagem pra conferir se a execução aparece no n8n.

Pronto quando: a execução aparece no n8n com o fluxo publicado
05

Cole o cérebro do seu negócio

A mensagem de sistema do AI Agent

Preencha os dados do seu negócio: o prompt ao lado se monta sozinho. Depois cole em AI Agent › Options › System Message. Escreva só o que é verdade: o robô vai repetir isso pros seus clientes. O que ficar em [amarelo] ainda falta preencher.

Um por linha, no formato serviço: preço
System Message

              

            


            

              
              
Horários livres (“amanhã tem vaga às 18h e às 19h”) só funcionam se estiverem nos fatos. Se a sua agenda muda todo dia, deixe o robô pegar o horário preferido e marque como Interessado: a equipe confirma.

            

          

          
Pronto quando: o prompt está colado e sem nada em [colchetes]

        

      


      
      

        

          

            
06

            

              
Mande cada contato pra planilha

              
O Google Sheets como ferramenta do agente

            

          

          

            
    
              
  1. Crie uma planilha no Google Sheets chamada Contatos do WhatsApp, com estas colunas na primeira linha: Nome Telefone Quer Horário Status
    2. 
              
  2. No AI Agent, clique em Tool, escolha Google Sheets e conecte a sua conta do Google.
    3. 
              
  3. Dê ao nó o nome Salvar contato (o Claude enxerga esse nome). Operação Append Row, a sua planilha e a aba.
    4. 
              
  4. Em cada coluna, deixe o Claude preencher, com o botão de IA do campo ou com a expressão abaixo. O telefone vem do próprio WhatsApp, sem passar pelo Claude.
    5. 
            

            

              
O que vai em cada coluna

              

                
Nome{{ $fromAI('nome', 'primeiro nome do cliente') }}

                
Telefone{{ $('WhatsApp Trigger').item.json.messages[0].from }}

                
Quer{{ $fromAI('quer', 'o que o cliente quer, em poucas palavras') }}

                
Horário{{ $fromAI('horario', 'dia e horário combinados, ou vazio') }}

                
Status{{ $fromAI('status', 'Marcado, Interessado, Humano ou Respondido') }}

              

            

            
De manhã, a planilha mostra quem marcou, quem está interessado, quem pediu uma pessoa e quem só tirou uma dúvida.

          

          
Pronto quando: uma conversa de teste gerou uma linha

        

      


      
      

        

          

            
07

            

              
Passe pra uma pessoa na hora

              
O WhatsApp exige esse caminho

            

          

          

            
A política do WhatsApp Business diz que, com atendimento automático, a empresa precisa oferecer um caminho imediato, claro e direto até uma pessoa: transferência no próprio chat, telefone, e-mail, site, loja ou formulário. O prompt já manda o Claude responder TRANSFERIR nesses casos. Agora o n8n faz o resto.


            

              

                
AIfnome: Transferir? · entre o AI Agent e o Responde

                

                  
Condição{{ $json.output }}

                  
containsTRANSFERIR

                  
true
                    
    
                      
  1. WhatsApp Business Cloud › Send pro cliente: “Passei sua mensagem pra nossa equipe. Alguém te responde por aqui.”
    2. 
                      
  2. Gmail › Send pra equipe: o número e a última mensagem do cliente
    3. 
                      
  3. Google Sheets › Append Row na aba Pausados: o número do cliente
    4. 
                    

                  

                  
falsesegue pro Responde

                

              

              

                
BGoogle Sheets › Get Row(s)logo depois do É texto?, antes do AI Agent

                

                  
AbaPausados

                  
Filtro Telefone ={{ $('WhatsApp Trigger').item.json.messages[0].from }}

                  
Settings › Always Output Dataligado

                  
Depois, um Ifachou o número? Então o fluxo para e a equipe responde.

                

              

            


            
Quando o atendimento humano acabar, apague o número da aba Pausados e o robô volta a responder esse cliente.

            

              
              
O número da API não fica no app comum do WhatsApp. Pra equipe responder, use uma plataforma de atendimento de uma parceira da Meta ou um fluxo simples no n8n que manda a resposta da equipe pelo nó do WhatsApp.

            

          

          
Pronto quando: um pedido de “falar com alguém” cai na aba Pausados

        

      


      
      

        

          

            
08

            

              
Teste do seu celular

              
Os 4 testes antes de ligar o número de verdade

            

          

          

            

              
              
              
              
            

            
Em cada teste, confira a execução no n8n e a planilha. Não confie só na resposta do chat.

          

          
0 de 4 testes ok

        

      

    


    
    

      

        
Custos e regras antes de ir pro ar

        
Simule o gasto do mês com os seus números. Os valores iniciais são os preços de tabela citados no guia.

      


      

        

          

            
            
            
            
            
            
            
            
          

          

            
Claude por resposta
–

            
Claude no mês
–

            
Meta no mês
–

            
Total estimado
–
Sem o n8n: some o n8n Cloud ou o seu servidor.

          

        

        

          
          
É uma estimativa no preço de tabela: conversa longa lê mais tokens e custa mais. Acompanhe o gasto real no Console do Claude e no Billing Hub da Meta.

        

      


      

        
Quanto a Meta cobra
Mensagem do cliente pra empresa é grátis. Desde 1º de outubro de 2026, as respostas dentro da janela de 24 horas são cobradas por mensagem entregue, no preço de utilidade do país, mas cada número tem 1.000 respostas grátis por mês, que não acumulam.

        
Forma de pagamento na Meta
Cadastre um cartão no Billing Hub da Meta. Sem isso, as respostas param de ser entregues quando acabam as 1.000 grátis do mês.

        
Janela de 24 horas
Cada mensagem do cliente abre (ou renova) uma janela de 24 horas, e dentro dela o robô responde livre. Fora dela, só dá pra mandar um modelo de mensagem aprovado pela Meta, cobrado por mensagem.

        
O número de verdade
Troque o número de teste por um número do negócio: com DDD, que receba SMS ou ligação e que não esteja em uso no app do WhatsApp (salvo parceiras da Meta que fazem a coexistência). Nunca use o seu WhatsApp pessoal.

        
Permissão e transparência
Só mande mensagem pra quem deu o número e aceitou receber. Diga logo no começo que é um assistente virtual e deixe claro como falar com uma pessoa.

        
O n8n é à parte
Some o n8n Cloud, se usar a versão paga, ou o servidor onde você instalar a edição Community.

      


      

        
Dica do Ivan Mendes

        
Converse com o robô pelo número de teste por uns dias, fingindo ser cliente. Cada vez que ele errar, ajuste os fatos e as regras do prompt: é ali que mora quase toda a qualidade do atendimento. E comece pequeno: um robô que responde bem 5 perguntas vale mais que um que tenta responder tudo.