Conecta el asistente de IA Clawdbot a WhatsApp para mensajería automatizada, respuestas inteligentes y conversaciones impulsadas por IA las 24 horas del día.

Descripción general de la integración de Clawdbot con WhatsApp

La integración de Clawdbot con WhatsApp te permite conectar tu asistente de IA personal directamente a WhatsApp, la plataforma de mensajería más popular del mundo. Clawdbot usa WhatsApp Web a través de Baileys, con el Gateway siendo propietario de la sesión. Esto te permite automatizar conversaciones, recibir respuestas inteligentes y gestionar tus mensajes de WhatsApp mediante automatización impulsada por IA.

¿Por qué usar Clawdbot con WhatsApp?

WhatsApp es utilizado por más de 2 mil millones de personas en todo el mundo. Al integrar Clawdbot con WhatsApp, desbloqueas potentes capacidades de IA:

Característica	Beneficio de Clawdbot WhatsApp
Respuestas inteligentes	Clawdbot genera respuestas inteligentes de WhatsApp automáticamente
Disponibilidad 24/7	Tu asistente Clawdbot WhatsApp nunca duerme
Automatización de mensajes	Automatiza conversaciones repetitivas de WhatsApp con Clawdbot
Privacidad primero	Clawdbot se ejecuta localmente, manteniendo tus datos de WhatsApp privados
Múltiples cuentas	Conecta múltiples cuentas de WhatsApp a Clawdbot
Enrutamiento determinista	Las respuestas siempre regresan a WhatsApp, sin necesidad de enrutamiento de modelo

Configuración rápida (Principiante)

Usa un número de teléfono separado si es posible (recomendado)
Configura WhatsApp en ~/.clawdbot/clawdbot.json
Ejecuta clawdbot channels login para escanear el código QR (Dispositivos vinculados)
Inicia el gateway

Configuración mínima:

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    }
  }
}

Obtener un número de teléfono

WhatsApp requiere un número móvil real para la verificación. Los números VoIP y virtuales suelen estar bloqueados. Hay dos formas compatibles de ejecutar Clawdbot en WhatsApp:

Número dedicado (Recomendado)

Usa un número de teléfono separado para Clawdbot WhatsApp. Esto proporciona la mejor experiencia de usuario con enrutamiento limpio y sin peculiaridades de auto-chat.

Configuración ideal: teléfono Android de repuesto/antiguo + eSIM. Déjalo conectado a Wi-Fi y corriente, y vincúlalo mediante QR.

Consejo de WhatsApp Business: Puedes usar WhatsApp Business en el mismo dispositivo con un número diferente para mantener tu WhatsApp personal separado.

Configuración de ejemplo (número dedicado, lista de permitidos de un solo usuario):

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    }
  }
}

Número personal (Alternativa)

Alternativa rápida: ejecuta Clawdbot en tu propio número. Envíate mensajes a ti mismo (WhatsApp "Envíate un mensaje") para probar.

Configuración de ejemplo (número personal, auto-chat):

{
  "whatsapp": {
    "selfChatMode": true,
    "dmPolicy": "allowlist",
    "allowFrom": ["+15551234567"]
  }
}

Consejos para obtener números

eSIM local de tu operador móvil del país (más confiable)
SIM prepago — barato, solo necesita recibir un SMS de verificación
Evitar: TextNow, Google Voice, la mayoría de servicios de "SMS gratis" — WhatsApp los bloquea agresivamente

Consejo: El número solo necesita recibir un SMS de verificación. Después de eso, las sesiones de WhatsApp Web persisten a través de creds.json.

Configurar Clawdbot WhatsApp

Requisitos previos

Antes de conectar Clawdbot a WhatsApp, asegúrate de tener:

Clawdbot instalado en tu dispositivo
Una cuenta de WhatsApp con un número de teléfono activo
Node.js 22 o superior

Paso 1: Configurar el canal de WhatsApp

Agrega la configuración de WhatsApp a tu ~/.clawdbot/clawdbot.json:

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    }
  }
}

Paso 2: Iniciar sesión con código QR

Ejecuta el comando de inicio de sesión de Clawdbot WhatsApp:

clawdbot channels login

Abre WhatsApp en tu teléfono, ve a Configuración > Dispositivos vinculados > Vincular un dispositivo, y escanea el código QR mostrado por Clawdbot.

Para inicio de sesión con múltiples cuentas:

clawdbot channels login --account <id>

Paso 3: Iniciar el Gateway

clawdbot gateway --port 18789

Paso 4: Verificar la conexión

Confirma que tu integración de Clawdbot WhatsApp está funcionando:

clawdbot channels status whatsapp

Características de Clawdbot WhatsApp

Manejo inteligente de mensajes

Clawdbot WhatsApp procesa mensajes entrantes y genera respuestas contextuales. La IA comprende el historial de conversación y proporciona respuestas relevantes. El modelo ve suficiente contexto para entender respuestas citadas.

Opciones de política de DM

Política	Descripción
`allowlist`	Solo responder a números en la lista `allowFrom`
`pairing`	Los remitentes desconocidos obtienen un código de emparejamiento; aprobar con CLI
`open`	Responder a todos los mensajes (no recomendado)

Soporte para mensajes de grupo

Clawdbot WhatsApp admite conversaciones grupales. Los chats directos usan la sesión principal del agente; los grupos permanecen aislados.

Soporte de medios

Clawdbot WhatsApp puede procesar y responder a:

Mensajes de texto
Imágenes (con IA de visión)
Mensajes de voz (audio PTT con transcripción)
Documentos
Mensajes de ubicación

Confirmaciones de lectura

Clawdbot WhatsApp puede enviar confirmaciones de lectura cuando está configurado.

Reacciones de reconocimiento

Reacciona automáticamente al recibir para confirmar que se recibió el mensaje.

Configuración de Clawdbot WhatsApp

Ejemplo de configuración completa

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567", "+10987654321"],
      "configWrites": true,
      "selfChatMode": false
    }
  }
}

Escrituras de configuración

Por defecto, WhatsApp puede escribir actualizaciones de configuración activadas por /config set|unset. Deshabilitar con:

{
  "channels": {
    "whatsapp": {
      "configWrites": false
    }
  }
}

Almacenamiento de credenciales de Clawdbot WhatsApp

Clawdbot almacena las credenciales de WhatsApp de forma segura:

~/.clawdbot/credentials/whatsapp/<accountId>/creds.json

Copia de respaldo en creds.json.bak (restaurada en caso de corrupción)
Compatibilidad heredada: instalaciones antiguas almacenaban archivos de Baileys directamente en ~/.clawdbot/credentials/

Los datos de tu sesión de WhatsApp permanecen en tu máquina local, garantizando la privacidad.

Solución de problemas de Clawdbot WhatsApp

Conexión perdida

Si Clawdbot WhatsApp se desconecta:

Verifica la conexión a Internet
Vuelve a autenticar: clawdbot channels login
Revisa los registros: cat /tmp/clawdbot/whatsapp.log

Los mensajes no se envían

Si Clawdbot WhatsApp no puede enviar mensajes:

Verifica el estado de la cuenta: clawdbot channels status whatsapp
Verifica la configuración de la lista de permitidos
Asegúrate de que el gateway de Clawdbot esté en ejecución
Se requiere un oyente activo para envíos salientes

Código QR caducado

Si el código QR de Clawdbot WhatsApp caduca:

clawdbot channels logout
clawdbot channels login

Cerrar sesión

Cerrar sesión elimina el estado de autenticación de WhatsApp (pero mantiene el oauth.json compartido):

clawdbot channels logout
# o para una cuenta específica
clawdbot channels logout --account <id>

Mejores prácticas de Clawdbot WhatsApp

Usa un número dedicado: Un número de teléfono separado proporciona la mejor experiencia
Establece límites claros: Configura listas de permitidos para controlar el acceso de Clawdbot WhatsApp
Monitorea el uso: Revisa los registros de Clawdbot WhatsApp regularmente
Actualiza regularmente: Mantén Clawdbot actualizado para la última compatibilidad con WhatsApp
Haz copias de seguridad de las credenciales: Respalda tus credenciales de Clawdbot WhatsApp periódicamente

¿Por qué no Twilio?

Los números de WhatsApp Business no son adecuados para un asistente personal:

Meta impone una ventana de respuesta de 24 horas
El uso de alto volumen desencadena bloqueos agresivos
Las cuentas comerciales no están destinadas a mensajes de asistente personal

Próximos pasos

Integración de Clawdbot con Telegram - Conecta Clawdbot a Telegram
Integración de Clawdbot con Discord - Configura Clawdbot en Discord
Guía de configuración de Clawdbot - Guía de instalación completa

Integración de Clawdbot con WhatsApp