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 <em>n8n-nodes-waha</em> 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 <em>host.docker.internal</em> . 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 <em>host.docker.internal:3000</em> 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