Crie um Chatbot com IA para WhatsApp de Graça Usando Gemini e N8N (Tutorial Completo)

Quer levar seu atendimento no WhatsApp para o próximo nível sem gastar uma fortuna? Neste tutorial, vamos direto ao ponto e construir, do zero, um chatbot poderoso que integra a inteligência artificial do Google Gemini com a flexibilidade da plataforma de automação N8N.

O melhor de tudo? Você conseguirá consumir a API do WhatsApp, conectar a IA e hospedar toda a solução na sua própria infraestrutura (no seu PC ou em uma VPS), tudo de forma 100% gratuita.

Bora pra ação!

O Que Você Vai Precisar (Pré-requisitos)

Antes de começarmos, garanta que você já tenha o ambiente básico preparado.

• Evolution API Instalada: A API que fará a ponte com o seu número de WhatsApp.
• N8N Instalado: A nossa plataforma de automação low-code onde a mágica acontece.
• Um Número de WhatsApp Conectado: O dispositivo precisa estar com o QR Code lido e conectado na sua instância da Evolution API.

Passo 1: Criando o Fluxo e o Gatilho no N8N

O gatilho (ou trigger) é o que inicia nossa automação. Neste caso, ele será um Webhook, que aguarda receber uma mensagem vinda da Evolution API.

1. No seu N8N, crie um novo workflow e dê um nome a ele, como "Chatbot Gemini".
2. Adicione o nó Webhook.
3. No painel de configurações do Webhook, defina o HTTP Method como POST.

Passo 2: Configurando o Nó de Inteligência Artificial (Gemini)

Agora, vamos adicionar o cérebro do nosso chatbot.

1. Adicione o nó AI Agent.
2. Em Chat Model, selecione Gemini.
3. Para que o chatbot tenha contexto e se lembre da conversa, adicione uma memória. Em Memory, selecione Simple Memory.
4. Conectando sua credencial do Gemini:
   • Clique em "Create New Credential".
   • Para obter sua chave de API gratuita, acesse o Google AI Studio.
   • Faça login com sua conta Google e clique em "Get API key".
   • Crie uma nova chave de API associada a um projeto do Google Cloud.
   • Copie a chave gerada, cole no campo API Key do N8N e salve a credencial.
5. Em Model, escolha a versão que deseja utilizar, como gemini-1.5-pro-latest ou gemini-pro. Salve o nó.

Passo 3: Conectando a Evolution API ao N8N

Agora, precisamos dizer à Evolution para onde enviar as mensagens recebidas.

1. No seu nó Webhook do N8N, copie a URL da versão de Test.
2. Vá para o painel da sua Evolution API.
3. No menu, acesse Configurações > Webhook.
4. Cole a URL do N8N no campo URL Webhook.
5. Ative a chave geral do Webhook.
6. Ponto crucial: Na seção de eventos (Events), marque apenas a opção messages-upsert. Isso garante que o N8N receba apenas novas mensagens, evitando uma bagunça de eventos desnecessários no seu fluxo.
7. Salve as configurações.

Passo 4: Mapeando os Dados de Entrada para a IA

Com a conexão feita, vamos ensinar a IA a "ler" a mensagem que chega.

1. Envie uma mensagem de teste do seu WhatsApp para o número conectado. Você verá o Webhook no N8N receber os dados.
2. Abra o nó AI Agent novamente.
3. No campo Prompt, vamos inserir dinamicamente a mensagem do usuário. Clique no ícone de engrenagem, selecione "Add Expression" e mapeie o campo da mensagem que vem do Webhook. Geralmente, o caminho é: {{ $json.body.message.conversation }}.
4. No campo Memory Key, faremos o mesmo para identificar unicamente cada conversa. Mapeie o número do remetente: {{ $json.body.sender.remote.id }}.

Isso garante que cada usuário tenha seu próprio histórico de conversa salvo.

Passo 5: Enviando a Resposta de Volta para o WhatsApp

A IA processou a mensagem e gerou uma resposta. Agora, precisamos enviá-la de volta.

1. Adicione o nó HTTP Request.
2. Method: POST.
3. URL: Aqui vai a URL da sua Evolution API para enviar mensagens. O formato é:
   http://SEU_IP_EVOLUTION:PORTA/message/sendText/NOME_DA_SUA_INSTANCIA
4. Authentication: Header Auth.
5. Name (Header): apikey.
6. Value (Header): Insira a sua chave de API (API Key) da instância da Evolution.
7. Body Content Type: JSON.
8. No corpo da requisição (Body), adicione dois campos:
   • number: O número para onde a resposta vai.
   • textMessage: O conteúdo da resposta.

Passo 6: O Pulo do Gato - Tratando e Mapeando os Dados de Saída

Esta é a etapa final de configuração, onde garantimos que os dados dinâmicos sejam enviados corretamente.

1. Mapeando o número: No campo number do seu nó HTTP Request, mapeie o número do remetente que veio do Webhook. O problema é que ele vem no formato [email protected]. Precisamos apenas do número. Use a seguinte expressão em JavaScript para limpá-lo:

   {{ $json.body.sender.remote.id.split('@')[0] }}

2. Mapeando a resposta da IA: No campo textMessage, mapeie o output do nó do Gemini. O caminho geralmente é {{ $('AI Agent').json.output }}. Para garantir que a resposta venha sem espaços ou quebras de linha indesejadas, use a função .trim():

   {{ $('AI Agent').json.output.trim() }}

Passo 7: Ativando para Produção

Seu fluxo está pronto! Para colocá-lo para rodar de verdade:

1. Ative o workflow no botão "Active" no canto superior esquerdo do N8N.
2. Copie a URL de Production do seu nó Webhook.
3. Cole essa nova URL lá nas configurações de Webhook da sua Evolution API.

Pronto! Seu chatbot com inteligência artificial está ativo, recebendo e respondendo mensagens no WhatsApp 24/7, de graça.