Conectar WhatsApp
Xambee usa Evolution API para conectar tu número de WhatsApp. No necesitas WhatsApp Business API oficial — cualquier número funciona.
Requisitos
- Un número de WhatsApp activo — puede ser tu número de negocios
- El número no debe estar conectado a WhatsApp Web en ningún otro dispositivo al momento de vincular
- Tener la app de WhatsApp (no WhatsApp Business) instalada en el teléfono
- El teléfono debe tener conexión a internet estable al momento de escanear el QR
Conectar el número
En el menú lateral, haz clic en WhatsApp.
Haz clic en Nueva instancia. El sistema crea automáticamente una instancia con un nombre único para tu negocio.
Aparecerá un código QR. En tu teléfono:
- Abre WhatsApp
- Ve a Configuración (ícono de engranaje)
- Selecciona Dispositivos vinculados
- Toca Vincular un dispositivo
- Escanea el QR que aparece en el panel
El estado cambiará a Conectando... y luego a ● Conectado. Este proceso tarda entre 5 y 30 segundos.
Una vez conectado, el sistema configura automáticamente el webhook para recibir los mensajes entrantes. No necesitas hacer nada adicional.
Estados de la instancia
| Estado | Descripción | Acción recomendada |
|---|---|---|
| Conectado | Todo funciona correctamente. El agente recibe y responde mensajes. | Ninguna |
| Conectando | La instancia se está inicializando. Espera hasta 60 segundos. | Esperar |
| Desconectado | La sesión se cerró. El agente no puede recibir mensajes. | Reconectar con nuevo QR |
| QR pendiente | Hay un QR esperando ser escaneado. | Escanear el QR |
Ajustes de la instancia
Desde la página de WhatsApp puedes configurar el comportamiento de la instancia:
| Ajuste | Descripción | Default |
|---|---|---|
| Rechazar llamadas | Rechaza automáticamente llamadas de voz entrantes a ese número de WhatsApp | Activado |
| Ignorar grupos | El agente no responde mensajes en grupos de WhatsApp donde está el número | Activado |
| Marcar leídos automáticamente | Los mensajes entrantes se marcan con doble check azul automáticamente | Activado |
| Siempre en línea | Muestra el número como siempre conectado (no muestra "última vez visto") | Desactivado |
Múltiples números
Puedes conectar más de un número de WhatsApp a la misma sucursal. Esto es útil para:
- Tener un número principal y uno de respaldo
- Separar departamentos (ventas y soporte con diferentes números)
- Manejar diferentes líneas de negocio bajo la misma sucursal
El agente atiende todos los números conectados usando la misma configuración y base de conocimiento.
Desconectar
Para desconectar un número:
- Ve a WhatsApp en el panel
- Haz clic en el menú de la instancia (⋮)
- Selecciona Desconectar
- Confirma la acción
El número queda libre para conectarlo de nuevo o usarlo en otro servicio. Los mensajes y el historial de conversaciones se conservan en Xambee.
Solución de problemas
El QR no aparece o tarda mucho
Si el QR no aparece después de 30 segundos:
- Refresca la página
- Si persiste, elimina la instancia y crea una nueva
- Verifica que tu conexión a internet sea estable
El QR expiró antes de escanearlo
Los QRs son válidos por 60 segundos. Si expiró, haz clic en Actualizar QR para generar uno nuevo.
El agente deja de responder sin que el estado cambie
A veces la conexión está técnicamente activa pero los mensajes no fluyen. Intenta:
- Ir al panel de WhatsApp y hacer clic en Verificar estado
- Si el estado dice "Conectado" pero el agente no responde, desconecta y reconecta
- Verifica que el agente esté en estado Activo (no Pausado) en la sección Mi Empleado
- Verifica que tengas saldo de créditos
El número se desconecta frecuentemente
Causas comunes:
- El teléfono del número se queda sin batería frecuentemente
- El teléfono tiene conexión inestable a internet
- El usuario del teléfono cierra la sesión manualmente de "Dispositivos vinculados"
Solución: conecta el teléfono permanentemente a un cargador o usa un número de una SIM dedicada en un dispositivo que siempre esté encendido.