Saltar al contenido principal
Conecta WhatsApp a tu instancia de Claw escaneando un código QR, al igual que en WhatsApp Web.

​
Requisitos previos

WhatsApp utiliza tu número de teléfono real. Los mensajes enviados a través del bot aparecerán como si vinieran de tu cuenta de WhatsApp. Utiliza un número dedicado si deseas mantener la separación.
Los números VoIP no son compatibles. WhatsApp requiere un número de teléfono real basado en SIM. Los números virtuales (Google Voice, Skype, etc.) no funcionarán para el emparejamiento por código QR.

​
Guía de configuración

1

Guardar la configuración de WhatsApp

  1. Ve a tu Claw Dashboard
  2. Haz clic en el icono de configuración de tu instancia
  3. Abre la pestaña IM Integrations
  4. Expande la sección WhatsApp
  5. Configura la Access Policy (se recomienda allowlist)
  6. Haz clic en Save primero; debes guardar la configuración antes de escanear el código QR
2

Escanear el código QR

  1. Haz clic en el botón Scan QR Code
  2. Aparecerá un código QR (válido por ~60 segundos)
  3. En tu teléfono, abre WhatsApp → Ajustes → Dispositivos vinculados → Vincular un dispositivo
  4. Escanea el código QR que aparece en pantalla
  5. Espera a que se establezca la conexión
3

Configurar la Access Policy

WhatsApp utiliza la política allowlist: solo los números de teléfono que especifiques podrán interactuar con el bot de IA.Añade los números de teléfono permitidos en el dashboard de LemonData (formato internacional, ej. +1234567890).
A diferencia de otras plataformas, WhatsApp no admite el mecanismo de emparejamiento. Debes añadir explícitamente los contactos permitidos.
4

Comenzar a chatear

Envía un mensaje al número de WhatsApp conectado desde un contacto permitido: ¡la IA responderá!

​
Configuración de grupos

Los grupos de WhatsApp son compatibles. Configura el comportamiento de los grupos en la pestaña IM Integrations:
AjusteOpcionesDescripción
Group PolicyOpen (predeterminado) / Allowlist / DisabledControla quién puede activar el bot en los grupos
Require @mentionOn / OffEl bot solo responde cuando se le menciona con @
Group IDsLista de JIDs de grupoRestringir a grupos específicos (vacío = todos los grupos)
Group Allowed UsersLista de números de teléfonoSolo estos usuarios pueden activar el bot (modo allowlist)
Utiliza el formato E.164 para los números de teléfono en la allowlist de grupos (ej. +1234567890).

​
Solución de problemas

Haz clic en Scan QR Code de nuevo para generar un código nuevo. Los códigos QR expiran después de ~60 segundos.
WhatsApp puede desconectar los dispositivos vinculados tras un periodo de inactividad. Vuelve a escanear el código QR para reconectarte.
  • Comprueba que el número del remitente esté en tu allowlist (si utilizas la política allowlist)
  • Verifica que tu instancia esté en funcionamiento
  • Comprueba tu saldo de LemonData