Configuracion de WhatsApp
Guia paso a paso para conectar tu agente de Claw Buff a WhatsApp
La integracion con WhatsApp esta en Beta. Utiliza el protocolo de WhatsApp Web (Baileys) que no es una API oficial. Consulta las Notas importantes a continuacion.
Conecta tu agente de IA de Claw Buff a WhatsApp para que los usuarios puedan chatear con el como un contacto normal. La configuracion tarda unos 5 minutos.
Requisitos previos
- Una cuenta de WhatsApp (se recomienda encarecidamente un numero de telefono dedicado)
- Un smartphone para escanear el codigo QR
- Un agente de Claw Buff desplegado (Primeros pasos)
Paso 1: Conectar a Claw Buff
- Abre la Consola de Claw Buff → pagina de Canales
- Encuentra la tarjeta de WhatsApp y haz clic en Conectar
- Haz clic en Generar codigo QR
Aparecera un codigo QR en pantalla.
Paso 2: Escanear el codigo QR
Abre WhatsApp en tu telefono
Abre el menu ⋮ (arriba a la derecha) o Configuracion, luego toca Dispositivos vinculados → Vincular un dispositivo. En algunas versiones, toca el icono QR junto a tu nombre de perfil.
Escanea el codigo QR
Apunta la camara de tu telefono al codigo QR mostrado en la Consola. La conexion se establecera automaticamente.
Verifica la conexion
La Consola mostrara el estado como Conectado. Veras el numero de telefono vinculado.
Paso 3: Empieza a chatear
Envia un mensaje al numero de WhatsApp vinculado desde cualquier otra cuenta de WhatsApp. Tu agente de IA respondera.
Recomendamos usar un numero de telefono dedicado para tu bot de WhatsApp. Esto mantiene tu WhatsApp personal separado y evita cualquier riesgo para tu cuenta personal.
Caracteristicas
| Caracteristica | Compatible |
|---|---|
| Mensajes directos | Si |
| Chats grupales | Si |
| Formato enriquecido | Si |
| Archivos adjuntos | Si |
| Mensajes de voz | Planificado |
Notas importantes
Estado Beta
La integracion con WhatsApp utiliza la biblioteca Baileys (protocolo de WhatsApp Web). Esta no es una API oficial de WhatsApp, lo que significa:
- Riesgo de cuenta — WhatsApp puede restringir cuentas que usen APIs no oficiales. Usa un numero dedicado, no tu numero personal
- Expiracion de sesion — La sesion vinculada expira despues de aproximadamente 30 dias de inactividad. Necesitaras volver a escanear el codigo QR
- Sin SLA — Los cambios de protocolo por parte de WhatsApp pueden interrumpir temporalmente la conexion
Recomendacion de numero dedicado
Recomendamos encarecidamente obtener un numero de telefono separado para tu bot de WhatsApp. Opciones:
- Una tarjeta SIM prepago
- Un numero de Google Voice
- Un numero VoIP que pueda recibir SMS para verificacion
Alternativa de Cloud API
Para casos de uso en produccion que requieran una API oficial, el soporte para WhatsApp Cloud API esta planificado para una version futura. Esto utilizara la API oficial de negocios de Meta con SLAs adecuados y sin riesgo para la cuenta.
Preguntas frecuentes
1. El codigo QR expiro?
Los codigos QR expiran despues de aproximadamente 60 segundos. Haz clic en Generar codigo QR nuevamente en la Consola para obtener uno nuevo.
2. La conexion se cae frecuentemente?
- Asegurate de que el telefono permanezca conectado a internet
- Verifica que WhatsApp este actualizado a la ultima version
- Es posible que la sesion necesite ser revinculada si el telefono estuvo desconectado por mucho tiempo
3. Los mensajes no se entregan?
- Verifica que el numero del destinatario este en formato E.164 (por ejemplo, +15551234567)
- Los mensajes grupales requieren que el numero del bot sea miembro del grupo
- Revisa la pagina de Canales de la Consola para ver los detalles del error