Cómo Conectar tu Agente de IA a WhatsApp: Tutorial Paso a Paso
Dos formas de conectar: oficial y no oficial
Hay dos caminos para conectar un agente de IA a WhatsApp. Uno es gratis pero arriesgado. El otro es de pago pero legal.
1. Baileys (no oficial, gratis):
Baileys es una librería open source que simula el cliente web de WhatsApp. OpenClaw la usa por defecto. Ventaja: gratis, rápido de configurar. Riesgo: Meta puede banear tu número si detecta uso automatizado.
2. WhatsApp Business API (oficial, de pago):
La API oficial de Meta para negocios. Ventaja: legal, estable, sin riesgo de baneo. Desventaja: costes por mensaje y proceso de verificación.
| Baileys (no oficial) | WA Business API (oficial) | |
|---|---|---|
| Coste | $0 | $0.005-0.08/mensaje |
| Riesgo de baneo | ⚠️ Medio-Alto | ✅ Ninguno |
| Setup | 5 minutos | 1-3 días |
| Mensajes/día | Ilimitados | Según tier |
| Grupos | ✅ | ❌ |
Método 1: Conectar con Baileys (5 minutos)
El método rápido. Ideal para uso personal (tu propio número):
# Si ya tienes OpenClaw instalado:
openclaw channel add whatsapp
# Se abre un QR code en terminal
# Escanéalo con WhatsApp en tu teléfono
# (WhatsApp > Dispositivos vinculados > Vincular dispositivo)
# ¡Listo! Tu agente ya responde por WhatsAppConfiguración recomendada para evitar baneo:
- Usa tu número personal, no uno desechable
- No respondas automáticamente a todos — usa allowlist
- Limita los mensajes automatizados a 50-100/día
- No envíes mensajes masivos nunca
# config.yaml — restricciones de seguridad
whatsapp:
allowlist:
- "+34612345678" # solo responde a estos números
- "+34698765432"
auto_reply: false # requiere mención o DM
rate_limit: 100 # máximo mensajes/díaMétodo 2: WhatsApp Business API (oficial)
Para uso profesional o si no quieres arriesgar tu número:
1. Crear cuenta en Meta Business:
- Ir a business.facebook.com
- Crear o vincular una cuenta de negocio
- Verificar el negocio (puede tomar 1-3 días)
2. Configurar WhatsApp Business API:
- En Meta for Developers, crear una app
- Añadir el producto "WhatsApp"
- Obtener el token de acceso y el Phone Number ID
3. Conectar con OpenClaw:
whatsapp:
provider: official # en lugar de baileys
phone_number_id: "123456789"
access_token: "EAAxxxxxxx"
webhook_verify_token: "mi-token-secreto"
webhook_url: "https://agente.tudominio.com/webhook/whatsapp"Costes de la API oficial: ~$0.005-0.08 por mensaje dependiendo del país y tipo de conversación. Para uso personal (50 mensajes/día): ~$7-12/mes.
Costes reales: la verdad sobre WhatsApp + IA
Desglose honesto del coste mensual de un agente de IA en WhatsApp:
| Componente | Baileys (gratis) | WA Business API |
|---|---|---|
| $0 | $7-15 | |
| LLM (Claude Haiku, 100 msg/día) | $3-5 | $3-5 |
| VPS/Hosting | $0-5 | $5-10 |
| Total/mes | $3-10 | $15-30 |
¿Vale la pena la API oficial? Solo si usas el agente para un negocio, tienes múltiples usuarios, o no puedes permitirte perder el número de WhatsApp.
Limitaciones y alternativas
Limitaciones de WhatsApp como canal para IA:
- Sin formato rico: No puedes enviar Markdown, tablas, ni código con syntax highlighting. Solo texto plano, emojis y archivos.
- Límite de caracteres: 65.536 por mensaje. Parece mucho pero un agente detallado puede alcanzarlo.
- Sin botones nativos (Baileys): La API oficial soporta botones y listas, Baileys no.
- Latencia de entrega: WhatsApp puede tardar 1-5 segundos en entregar mensajes vs casi instantáneo en Telegram.
¿Alternativas?
- Telegram: Gratis, sin riesgo de baneo, soporta Markdown y botones. → Tutorial de Telegram
- Discord: Ideal para comunidades y equipos.
- WebChat: Control total, sin dependencias de terceros.
→ Guía detallada de OpenClaw + WhatsApp: OpenClaw en WhatsApp
Hermes
Hermes
🤖 Investigado por Hermes. Verificado por Ricardo Castro. [Sobre nosotros →](/nosotros/) Sobre nosotros →
Preguntas frecuentes
¿Me van a banear el WhatsApp si uso Baileys?
Es un riesgo real. Meta no aprueba clientes no oficiales. Para minimizar el riesgo: usa allowlist, limita mensajes, no envíes masivos. Para riesgo cero: usa la API oficial.
¿Puedo usar el agente en grupos de WhatsApp?
Con Baileys: sí, puedes configurarlo para responder cuando lo mencionan en grupos. Con la API oficial: no, solo soporta conversaciones 1-a-1.
¿Necesito un número de teléfono separado?
Con Baileys: usas tu número personal (o uno con SIM dedicada). Con la API oficial: necesitas un número verificado con Meta Business, que puede ser el mismo o uno nuevo.
¿WhatsApp ve mis conversaciones con el agente?
WhatsApp usa cifrado end-to-end, pero Meta tiene acceso a metadatos (quién habla con quién, cuándo). El contenido de los mensajes pasa por el LLM externo (Anthropic/OpenAI) para procesarse.