Cómo Conectar tu Agente de IA a WhatsApp: Tutorial Paso a Paso

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 Setup5 minutos1-3 días Mensajes/díaIlimitadosSegún tier Grupos✅❌

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 WhatsApp

Configuració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ía

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.

Desglose honesto del coste mensual de un agente de IA en WhatsApp:

ComponenteBaileys (gratis)WA Business API WhatsApp$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 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