Conecte o GPT-4o ao WhatsApp com o agentkit: bot com QR Code, integração com Agent Builder e respostas inteligentes para clientes reais.
Como funciona, repo, stack
clone, npm install, .env
API key, WORKFLOW_ID
npm run dev, escanear, testar
integração agente, WORKFLOW_ID
!help, !clear, limitações
O WhatsApp AgentKit é um bot Node.js que conecta o GPT-4o ao WhatsApp via WhatsApp Web. Você escaneia um QR Code, e qualquer mensagem enviada ao número conectado vai para o agente GPT e retorna como resposta automática.
WhatsApp é o canal de comunicação dominante no Brasil. Com este bot, você automatiza atendimento ao cliente, suporte, vendas e FAQ com um agente de IA real — sem pagar APIs oficiais caras do WhatsApp Business.
Repositório: github.com/inematds/whatsapp-agentkit
Instalar o agentkit é simples: clone o repo, instale as dependências com npm e configure o arquivo .env. Em menos de 5 minutos o bot está pronto para conectar ao WhatsApp.
# 1. Clone o repositório git clone https://github.com/inematds/whatsapp-agentkit cd whatsapp-agentkit # 2. Instale as dependências npm install # 3. Copie o arquivo de configuração cp .env.example .env # 4. Edite o .env com suas credenciais nano .env
whatsapp-agentkit/ ├── index.js ← bot principal ├── agent.js ← chamada ao GPT/Agent Builder ├── .env ← suas credenciais ├── .env.example ← template ├── start_dev.bat ← atalho Windows └── package.json
O arquivo .env guarda suas credenciais de forma segura. Nunca commitá-lo no git. As duas variáveis principais são a API key da OpenAI e o ID do workflow do Agent Builder.
# Chave da API da OpenAI OPENAI_API_KEY=sk-proj-... # ID do workflow do Agent Builder (opcional) # Se definido, o bot usa o agente configurado # em vez de GPT-4o direto WORKFLOW_ID=wf_abc123... # Nome do bot (aparece nas mensagens) BOT_NAME=Assistente AutomationsAI
Bot usa o agente do Agent Builder com guardrails, vector store e widgets configurados — mais personalizado.
Bot usa GPT-4o diretamente via API — mais simples, sem configuração extra.
⚠️ Segurança: Adicione .env ao .gitignore. Nunca compartilhe o arquivo com a API key. O .env.example já está no gitignore do projeto.
A conexão funciona como o WhatsApp Web: você roda o bot, ele exibe um QR Code no terminal, e você escaneia com o celular em Configurações → Dispositivos Conectados.
# Linux / Mac (terminal) npm run dev # Windows (duplo clique ou terminal) npm start # ou double-click em: start_dev.bat
QR Code aparece no terminal após ~5 segundos
No celular: WhatsApp → ⋮ → Dispositivos Conectados → Conectar Dispositivo
Escaneie o QR Code com a câmera do celular
Terminal mostra "Client is ready!" — bot está online
Envie uma mensagem para o número conectado e veja a resposta do GPT
A integração mais poderosa: seu agente configurado no Agent Builder (com Guardrails, Vector Store e ferramentas) recebe as mensagens do WhatsApp e responde como se fosse um atendente especializado.
Configure o prompt, guardrails e ferramentas para atendimento ao cliente
No Agent Builder → Deploy → API → copie o ID do workflow (formato wf_xxx)
WORKFLOW_ID=wf_seu_id_aqui
Agora as mensagens do WhatsApp vão para o seu agente personalizado
| Comando | Função |
|---|---|
| !help | Lista os comandos disponíveis |
| !status | Mostra se o bot está ativo e conectado |
| !ping | Testa a latência de resposta |
| !clear | Limpa o histórico de conversa (memória) |
Para rodar 24/7, faça o deploy em um servidor VPS (AWS, DigitalOcean, Railway):
# Com PM2 (mantém rodando após reinicialização)
npm install -g pm2
pm2 start index.js --name whatsapp-bot
pm2 startup
pm2 save