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.
{ "errorCode": "101", "message": "Error 101: No connected WhatsApp instances found!", "resolution": "Connect at least one WhatsApp instance for this location"}
[ERROR] Error 101: No connected WhatsApp instances found!
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.
{ "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"}
\{ 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.
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.
{ "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"}
"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!
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.
{ "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"}
[ERROR] Error 104: Whatsapp number +15559876543 is not connected. Either connect the number or remove the tag 'wa:+15559876543' from the contact!
Opción A
Reconectar la instancia de WhatsApp con el número +15559876543
Opción B
Eliminar la etiqueta wa: +15559876543 del 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.
{ "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"}
[ERROR] Error 105: Contact was assigned to Sarah Williams (user456) but the Whatsapp Instance - 2 for that User was not connected!
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.
{ "errorCode": "106", "message": "Error 106: No connected WhatsApp instances found!", "resolution": "Connect at least one WhatsApp instance and ensure it has a phone number"}
[ERROR] Error 106: No connected WhatsApp instances found!
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
- 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
Para soporte adicional con solución de errores, contacta a nuestro equipo a través del botón de WhatsApp a continuación.
Soporte
Si necesitas ayuda con la configuración o incorporación:
