Conecta GPT-4o a WhatsApp con agentkit: bot con código QR, integración con Agent Builder y respuestas inteligentes para clientes reales.
Cómo funciona, repo, stack
clone, npm install, .env
API key, WORKFLOW_ID
npm run dev, escanear, probar
integración de agente, WORKFLOW_ID
!help, !clear, limitaciones
O WhatsApp AgentKit es un bot de Node.js que conecta el GPT-4o al WhatsApp mediante WhatsApp Web. Escaneas un código QR y cualquier mensaje enviado al número conectado llega al agente GPT, que responde automáticamente.
WhatsApp es el canal de comunicación dominante en Brasil. Con este bot, automatizas la atención al cliente, el soporte, las ventas y las FAQ con un agente de IA real, sin pagar las costosas API oficiales de WhatsApp Business.
Repositorio: github.com/inematds/whatsapp-agentkit
Instalar agentkit es sencillo: clona el repo, instala las dependencias con npm y configura el archivo .env. En menos de 5 minutos, el bot estará listo para conectarse a 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
El archivo .env guarda tus credenciales de forma segura. Nunca lo confirmes en git. Las dos variables principales son la API key de OpenAI y el ID del workflow de 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 INEMA
El bot usa el agente de Agent Builder con guardrails, vector store y widgets configurados: es más personalizado.
El bot usa GPT-4o directamente a través de la API: es más sencillo y no requiere configuración adicional.
⚠️ Seguridad: Agrega .env a .gitignore. Nunca compartas el archivo con la API key. El .env.example ya está en el gitignore del proyecto.
La conexión funciona como WhatsApp Web: ejecutas el bot, muestra un código QR en la terminal y lo escaneas con el celular desde Configuración → Dispositivos conectados.
# Linux / Mac (terminal) npm run dev # Windows (duplo clique ou terminal) npm start # ou double-click em: start_dev.bat
El QR Code aparece en el terminal después de ~5 segundos
En el celular: WhatsApp → ⋮ → Dispositivos conectados → Conectar dispositivo
Escanea el código QR con la cámara del celular
La terminal muestra "Client is ready!" — el bot está en línea
Envía un mensaje al número conectado y mira la respuesta de GPT
La integración más potente: tu agente configurado en Agent Builder (con Guardrails, Vector Store y herramientas) recibe los mensajes de WhatsApp y responde como si fuera un agente de atención especializado.
Configura el prompt, las protecciones y las herramientas para la atención al cliente
En Agent Builder → Deploy → API → copia el ID del workflow (formato wf_xxx)
WORKFLOW_ID=wf_seu_id_aqui
Ahora los mensajes de WhatsApp llegan a tu agente personalizado
| Comando | Función |
|---|---|
| !help | Lista los comandos disponibles |
| !status | Muestra si el bot está activo y conectado |
| !ping | Prueba la latencia de respuesta |
| !clear | Borra el historial de conversación (memoria) |
Para que funcione 24/7, haz el deploy en un 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