Errores de Selección de Número
Esta documentación cubre todos los códigos de error (101-106) que pueden ocurrir durante la selección de número de WhatsApp, con guías de solución paso a paso y estrategias de resolución.
Códigos de Error y Manejo
Error 101: Sin Instancias Conectadas
Este error significa que no hay instancias de WhatsApp disponibles para la ubicación. Los mensajes no se pueden enviar hasta que al menos una instancia esté conectada.
Causa: No hay instancias de WhatsApp conectadas para la ubicación
{
"errorCode": "101",
"message": "Error 101: No connected WhatsApp instances found!",
"resolution": "Connect at least one WhatsApp instance for this location"
}
Escenario de Ejemplo: Una ubicación tiene 3 instancias de WhatsApp configuradas, pero todas están desconectadas debido a la expiración del código QR o problemas de red.
Lo que verás en el error:
[ERROR] Error 101: No connected WhatsApp instances found!
Cómo solucionar:
- Ve a tu panel de administración → Selecciona la Ubicación
- Verifica el estado de las instancias para la ubicación
- Reconecta cualquier instancia desconectada escaneando códigos QR
- Verifica que al menos una instancia muestre el estado "Conectada"
Error 102: La Instancia de Anulación Manual No Existe
Estás intentando usar una instancia de WhatsApp que no existe en la configuración de tu ubicación.
Causa: La anulación manual especifica un índice de instancia inexistente
{
"errorCode": "102",
"message": "Error 102: Manual override specified {WA#5}, but that instance does not exists.",
"resolution": "Use a valid instance index or remove the manual override pattern"
}
Escenario de Ejemplo: El usuario envía el mensaje "Usar este número \{\{ WA#7 \}\}" pero la ubicación solo tiene las instancias #1, #2 y #3 configuradas.
Lo que verás en el error:
[ERROR] Error 102: Manual override specified {WA#7}, but that instance does not exists.
Cómo solucionar:
- Verificar instancias disponibles: Ver el panel de administración para ver qué números de instancia existen (ej., 1, 2, 3)
- Actualizar mensaje: Cambiar "
\{\{ WA#7 \}\}" a una instancia válida como "\{\{ WA#2 \}\}" - Eliminar anulación: Eliminar el patrón "
\{\{ WA#7 \}\}" para usar la selección automática - Crear instancia: Si es necesario, crear la instancia #7 en el panel de administración
Error 103: Instancia de Anulación Manual No Conectada
La instancia de WhatsApp especificada existe pero está actualmente desconectada. Necesitas reconectarla o usar una instancia diferente.
Causa: La anulación manual especifica una instancia que no está conectada
{
"errorCode": "103",
"message": "Error 103: Manual override specified {WA#2}, but the instance 2 is not connected!",
"resolution": "Connect instance 2 or remove the manual override pattern"
}
Escenario de Ejemplo: El usuario envía el mensaje "Por favor llámame {{ WA#3 }}" pero la instancia de WhatsApp #3 está desconectada.
Lo que verás en el error:
[ERROR] Error 103: Manual override specified {WA#3}, but the instance 3 is not connected!
Cómo solucionar:
- Opción A: Conectar la instancia #3 en el panel de administración
- Opción B: Editar el mensaje para eliminar el patrón "
\{\{ WA#3 \}\}" - Opción C: Cambiar a una instancia conectada como "
\{\{ WA#1 \}\}"
Error 104: Instancia del Número Etiquetado No Conectada
El contacto tiene una etiqueta de número de WhatsApp, pero la instancia con ese número no está conectada.
Causa: El contacto tiene una etiqueta de WhatsApp pero la instancia correspondiente no está conectada
{
"errorCode": "104",
"message": "Error 104: Whatsapp number +15551234567 is not connected. Either connect the number or remove the tag 'wa: +15551234567' from the contact!",
"resolution": "Connect the WhatsApp number or remove the tag from contact"
}
Escenario de Ejemplo: El contacto "John Doe" tiene la etiqueta "wa: +15559876543" pero ninguna instancia con ese número de teléfono está conectada.
Lo que verás en el error:
[ERROR] Error 104: Whatsapp number +15559876543 is not connected. Either connect the number or remove the tag 'wa:+15559876543' from the contact!
Cómo solucionar:
- Opción A: Reconectar la instancia de WhatsApp con el número +15559876543
- Opción B: Eliminar la etiqueta
wa: +15559876543del contacto John Doe - Opción C: Actualizar la etiqueta para usar un número conectado como
wa: +15551111111
Error 105: Instancia del Usuario Asignado No Conectada
El contacto está asignado a un usuario, pero la instancia de WhatsApp de ese usuario no está conectada.
Causa: El contacto está asignado a un usuario cuya instancia de WhatsApp no está conectada
{
"errorCode": "105",
"message": "Error 105: Contact was assigned to John Doe (user123) but the Whatsapp Instance - 3 for that User was not connected!",
"resolution": "Connect the assigned user's WhatsApp instance"
}
Escenario de Ejemplo: El contacto "Jane Smith" está asignado al usuario "Sarah Williams" pero la instancia de WhatsApp #2 de Sarah está desconectada.
Lo que verás en el error:
[ERROR] Error 105: Contact was assigned to Sarah Williams (user456) but the Whatsapp Instance - 2 for that User was not connected!
Cómo solucionar:
- Opción A: Hacer que Sarah Williams reconecte su instancia de WhatsApp #2
- Opción B: Reasignar el contacto a un usuario con una instancia conectada
- Opción C: Eliminar a Sarah Williams de la Asignación de Instancia para que cualquier otro número pueda usarse para contactos asignados a Sarah Williams en el CRM
Error 106: Sin Instancias Disponibles
El sistema revisó todos los niveles de prioridad pero no pudo encontrar ninguna instancia de WhatsApp disponible para usar.
Causa: Todas las opciones de respaldo agotadas, no hay instancias disponibles
{
"errorCode": "106",
"message": "Error 106: No connected WhatsApp instances found!",
"resolution": "Connect at least one WhatsApp instance and ensure it has a phone number"
}
Escenario de Ejemplo: El sistema revisó todos los niveles de prioridad (sin anulación manual, sin etiquetas de contacto, sin asignación, sin instancia predeterminada) y aún no encontró instancias disponibles.
Lo que verás en el error:
[ERROR] Error 106: No connected WhatsApp instances found!
Cómo solucionar:
- Verificar conectividad de instancias: Confirmar que todas las instancias no estén desconectadas
- Establecer instancia predeterminada: Marcar al menos una instancia conectada como "default: true"
- Verificar números de teléfono: Asegurar que las instancias conectadas tengan números de teléfono válidos
Guía de Solución de Problemas
¡La mayoría de los problemas de mensajería de WhatsApp provienen de instancias desconectadas. Verifica siempre primero el estado de conexión de tu instancia!
Problemas Comunes
"No connected WhatsApp instances found"
- Verificar: Estado de conexión de la instancia en el panel de administración
- Solución: Reconectar instancias desconectadas
- Prevención: Configurar alertas de correo para desconexiones de instancias (Revisar spam y marcar como Importante si el correo termina en spam)
"Manual override instance not connected"
- Verificar: Estado de la instancia para el índice especificado
- Solución: Conectar la instancia o eliminar la anulación manual
- Prevención: Validar anulaciones manuales antes de enviar
"Contact assigned to disconnected instance"
- Verificar: Estado de la instancia asignada del usuario
- Solución: Reasignar contacto o reconectar instancia
- Prevención: Revisiones regulares de salud de instancias
Estrategias de Prevención de Errores
Monitoreo Proactivo
- Configurar alertas para desconexiones de instancias
- Probar flujos de trabajo regularmente para detectar problemas temprano
Mejores Prácticas de Configuración
- Mantener siempre una instancia predeterminada para cada ubicación
- Mantener actualizadas las etiquetas de contacto cuando cambien las instancias
- Validar anulaciones manuales antes de implementar en flujos de trabajo
- Documentar tu estrategia de instancias para referencia del equipo
Documentación Relacionada
- Introducción a Múltiples Instancias de WhatsApp: Descripción general y casos de uso
- Guía de Configuración Completa: Cómo conectar instancias de WhatsApp
Para soporte adicional con solución de errores, contacta a nuestro equipo a través del botón de WhatsApp a continuación.