Como criar um agente de IA integrado ao WhatsApp grátis com Docker

Desbloqueie o WhatsApp: IA integrada grátis, sem limites

Configurar um agente de IA para responder no WhatsApp está ao alcance de qualquer pessoa
com um computador – não é preciso gastar nada, nem assinar nenhum serviço. Em poucos
minutos, você instala todas as ferramentas usando Docker e cria seu próprio fluxo
inteligente, com memória, respostas automatizadas e poder da IA generativa Google
Gemini.

O que você vai construir

Você vai criar um agente de IA no WhatsApp, capaz de responder conversas
automaticamente, lembrar o histórico dos chats usando Redis, e personalizar o tipo de
atendimento (suporte, vendas ou assistente de viagem). Tudo isso rodando no seu
computador usando Docker, sem custos.

Pré-requisitos: o que você precisa

- Computador com acesso à internet e permissão para instalar programas - Docker Desktop
instalado (disponível para Windows, Linux e MacOS) - Conta Google para usar a API do
Google Gemini gratuita - WhatsApp em funcionamento no celular para conectar via QR Code

Instalando Docker e preparando o ambiente

Baixe e instale Docker Desktop do site oficial. Após a instalação, baixe o arquivo docker-compose.yml do repositório ou link indicado (veja a descrição completa do
tutorial Dev Doido no YouTube). Crie uma pasta chamada n8n-waha-local e coloque o
arquivo docker-compose nela. Abra um terminal nesta pasta e rode o comando:

docker-compose up -d

Este comando baixa automaticamente o N8N, a API WhatsApp AHA, Redis e Postgres. Em
segundos, seu ecossistema estará rodando no Docker.

Conectando o WhatsApp à API WAHA

No painel do Docker, localize o container AHA (API WhatsApp) e clique para abrir
o Dashboard no navegador. Inicie uma sessão, clique em "Start" e leia o QR Code
usando o WhatsApp do seu celular. Em segundos, a IA estará pronta para receber
mensagens.

Configurando o N8N sem custos

Acesse o painel do N8N por meio do link disponível no Docker. Crie um usuário, senha e
siga os passos indicados. Na tela inicial, solicite a chave gratuita de ativação para
habilitar recursos extras por e-mail – aproveite as funções premium de graça.

Instalando o pacote de nodos WhatsApp (WAHA)

No N8N, navegue até Community Nodes , busque por n8n-nodes-waha e instale.
Isso adiciona os blocos de integração com o WhatsApp necessários para montar o fluxo
inteligente. Marque para instalar e ative.

Criando o workflow do chatbot WhatsApp IA

Na tela inicial do N8N, crie um novo workflow e renomeie para “WhatsApp IA”. O primeiro
bloco é um Webhook configurado como POST no path /webhook . Copie a URL
gerada e registre como Webhook Global nas configurações do AHA (Dashboard).

Filtrando e organizando dados do WhatsApp

Utilize o node Set para selecionar apenas os campos necessários: session, chat
id, push name, payload id, event, message e from me. Isso evita ruídos e deixa o fluxo
otimizado.

Lógica condicional de eventos (Switch)

Adicione um node Switch para separar os tipos de evento e crie uma ramificação
especial para quando chegar um novo “message”. Isso garante que apenas mensagens
recebidas ativam o agente de IA.

Integrando a IA Gemini (Google API gratuita)

No ramo principal, adicione o node AI Agent , selecione “define below” e defina as
instruções do seu agente (exemplo: “Você é um guia de turismo em Foz do Iguaçu…”). No
modelo, escolha Google Gemini, crie sua API Key gratuita por meio do AI Studio do Google
e cole no campo correto.

Adicionando memória ao chatbot com Redis

Insira o bloco redis chat memory , crie as credenciais com senha padrão (default)
e configure o host para host.docker.internal . O “Session ID” deve ser o chat id
do usuário, time to live em segundos (ex: 3600) e contexto limitado a 10 mensagens.

Respondendo mensagens no WhatsApp via AHA

Anexe dois blocos WAHA: o primeiro envia um “send sim” para visualizar a mensagem e o
segundo “send a text message” responde usando o texto gerado pela IA. Conecte
credenciais AHA usando o host host.docker.internal:3000 e garanta que todos os
campos (Session, ChatId, PayloadId) estejam mapeados.

Ativando o workflow e testando seu agente IA

Ative o workflow no N8N. Agora é só conversar com o seu número no WhatsApp: a IA
responde, lembra o que foi falado e adapta as respostas em tempo real. Faça perguntas,
defina um papel para o agente e explore automações ilimitadas.

Limitações e futuras possibilidades

O agente só funciona enquanto o computador estiver ligado e na mesma rede. Para aceitar
webhooks externos ou integrar APIs, use soluções como ngrok ou suba em uma VPS (assunto
para um próximo artigo). Esta base é perfeita para automação pessoal, prototipagem ou
criar bots inteligentes para pequenos grupos.

Dicas extras e próximos passos

Com o domínio da estrutura básica, explore novas possibilidades: alterar instruções do
agente (“prompt”), conectar APIs externas, ou construir um front-end para o seu bot. No
canal Dev Doido você encontra cursos completos e conteúdos avançados para ampliar
automações, construir sites, aplicativos e integrar múltiplas IAs ao seu cotidiano.

Aprenda mais, acelere com IA

Assista ao vídeo completo do canal Dev Doido para ver todos os detalhes em ação. No mês
de maio, cursos e bônus exclusivos estão disponíveis para quem quer dominar automação,
IA, sites, APIs e bancos de dados, do iniciante ao avançado.

Perguntas frequentes

Agente no WhatsApp grátis: dá?

Protótipo sim. Oficial/escala tem custo e regras.

Stack comum?

n8n/API + LLM com schema.

Opt-in?

Obrigatório.

Quando cobrar?

Quando houver valor claro e retenção.

Continue explorando