Como criar um agente de IA integrado ao WhatsApp grátis com Docker
Descubra o método mais simples e gratuito para colocar um agente de inteligência artificial funcionando no seu WhatsApp, usando Docker e ferramentas open source.
Por que isso é importante
IA está mudando a comunicação no WhatsApp, permitindo automações inteligentes e atendimento 24/7 sem custo. Você pode ter seu próprio chatbot inteligente, totalmente de graça, usando ferramentas de código aberto, IA generativa e Docker em apenas alguns passos. Não precisa investir em VPS ou pagar plugins proprietários. Isso desbloqueia novas formas de atendimento ao cliente, geração de leads, roteiros personalizados e integração de IA no seu fluxo de trabalho – direto do seu PC.
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.
⚠️Atenção
Para seguir este guia, é fundamental usar apenas ferramentas gratuitas e rodar tudo localmente. Não conecte dados sensíveis a contas empresariais sem antes testar e entender as limitações de cada solução.
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.
ℹ️Aviso Legal
Este tutorial é focado em uso local e educativo. Para bots comerciais, confira políticas do WhatsApp e possíveis limitações técnicas.
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
⚠️Atenção
Esta estrutura não funciona em hospedagens tradicionais, apenas na sua rede local. Seu computador precisa estar ligado para o agente operar.
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.
ℹ️Suporte
Precisa de orientação visual? Veja o tutorial completo passo a passo no canal Dev Doido.
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).
⚠️Atenção
Para testar, envie mensagem usando outro WhatsApp (não use o mesmo número). Dados são recebidos no N8N na hora.
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.
ℹ️Info
Use o modelo Gemini 2.0 Flash para respostas mais rápidas e naturais. Ajuste o “sampling temperature” para controlar a criatividade.
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.
⚠️Atenção
O Redis permite lembrar conversas, nomes e preferências do usuário na mesma sessão, tornando seu agente de IA realmente útil.
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.
✅Sucesso
Seu agente IA está operando, com memória, totalmente grátis, sem limitações de API ou custos mensais.
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.
ℹ️Atenção
Para escalar, considere VPS e conexões seguras. Integração multi-api só é possível com infraestrutura aberta a internet.
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.