Solución de Errores Comunes de Conexión
Guía de resolución de errores como PERMISSION CONNECTIONS LIMITED, tokens y desvinculaciones
Solución de Errores Comunes de Conexión
Esta guía resuelve los errores más frecuentes al conectar y operar canales de WhatsApp en ChatCielo, tanto en WABA Oficial como en sesiones QR no oficiales.
Antes de empezar, identifica el mensaje exacto que ves en Administración > Canales o en el detalle del canal. Cada error tiene causa y solución distintas; seguir el paso a paso evita reconexiones innecesarias y pérdida de historial.
Error PERMISSION CONNECTIONS LIMITED / ERR_NO_PERMISSION_CONNECTIONS_LIMIT
Verás este error como PERMISSION CONNECTIONS LIMITED o ERR_NO_PERMISSION_CONNECTIONS_LIMIT al intentar conectar un canal WABA por OAuth o al agregar un nuevo número.
Causa
- Score del App Tech Provider en rojo o amarillo crítico. El App compartido de la plataforma tiene un límite de conexiones simultáneas y una calificación de reputación en Meta. Si supera el umbral de denuncias o conexiones, Meta bloquea nuevas vinculaciones para proteger a todos los tenants.
- Límite de conexiones de tu cuenta WABA. Tu Business Manager o tu WABA alcanzó el máximo de números permitidos según su nivel de verificación.
Solución paso a paso
Verifica el estado de tu cuenta en Meta Business Suite
- Entra a business.facebook.com > Configuración del negocio > Cuentas > Cuentas de WhatsApp Business.
- Selecciona tu WABA y revisa el estado de la cuenta, el nivel de verificación y los límites de números.
- Si ves advertencias de calidad o límite alcanzado, anota el detalle para el siguiente paso.
Limpia números inactivos o pendientes
- En el mismo panel de Meta, elimina números no verificados, pendientes o sin uso que ocupen cupo.
- En ChatCielo, ve a Administración > Canales y desconecta o elimina canales WABA en estado Error o Pendiente que ya no uses.
- Espera 10 minutos y reintenta la conexión.
Contacta a soporte si el score del App está afectado
Si el error persiste y tu cuenta WABA está en verde:
- Toma una captura del error en ChatCielo y del estado de tu WABA en Meta.
- Envía a soporte tu nombre de tenant, ID de WABA y las capturas con el asunto
PERMISSION CONNECTIONS LIMITED. - Soporte verificará el score del Tech Provider y, si corresponde, te ofrecerá migrar a un App propio o habilitar el Modo Híbrido para aislar tu reputación.
No intentes reconectar de forma repetida en intervalos cortos: cada intento fallido puede empeorar el score. Espera al menos 10 minutos entre intentos y corrige la causa raíz primero.
Error de Token Expirado en Meta OAuth
El canal WABA aparece como Desconectado o muestra Token expirado, Sesión inválida o Invalid OAuth token. Los mensajes dejan de entrar y salir.
Causa
El token de acceso de Meta expiró porque revocaste permisos en Facebook, cambiaste la contraseña del administrador del BM, el token alcanzó su validez máxima o dejaste el pop-up de conexión abierto demasiado tiempo.
Cómo reconectar sin perder historial
Valida permisos en Facebook
- Entra a business.facebook.com con el usuario administrador del BM.
- Verifica que sigues siendo Administrador de la WABA y del Business Manager.
- En Configuración > Integraciones > Conexiones, confirma que el App de ChatCielo sigue autorizado.
Reconecta el canal WABA
- En ChatCielo, ve a Administración > Canales.
- Localiza el canal WABA desconectado y haz clic en Reconectar o Conectar vía WhatsApp OAuth.
- Completa el flujo de OAuth en el pop-up de Meta sin cerrar la ventana antes de tiempo.
- Aprueba en el celular si se solicita coexistencia por QR.
Verifica que el historial se conserva
ChatCielo conserva todo el historial de tickets, mensajes, etiquetas y notas aunque el token haya expirado. Tras reconectar:
- Abre Atenciones y verifica que las conversaciones previas siguen visibles.
- Envía un mensaje de prueba desde un número externo y confirma que entra al panel.
- Si algún ChatFlow no se disparó durante la desconexión, revisa Automatización > ChatFlow > Logs.
Prevención: asigna el token a un usuario del sistema del BM en lugar de a tu perfil personal, y evita revocar permisos del App sin coordinar con el equipo. Así el canal no depende de tu sesión personal de Facebook.
Error "Esperando mensaje en WhatsApp" — sesión QR pierde internet
En canales por QR (Baileys, Evolution, WhatsMeow, etc.), el estado queda en Conectando, Esperando mensaje o QR expirado. Los mensajes no entran aunque el celular tenga WhatsApp abierto.
Causa
El celular vinculado perdió conexión a internet, se quedó sin batería, cerró la sesión de Dispositivos vinculados o el QR expiró por timeout (30 a 60 segundos). También ocurre si abriste WhatsApp en otro dispositivo y desplazaste la sesión activa.
Cómo reconectar la sesión QR
Verifica el celular vinculado
- Abre WhatsApp en el celular que escaneó el QR.
- Ve a Configuración > Dispositivos vinculados y confirma que el dispositivo de ChatCielo aparece como Activo.
- Si no aparece, la sesión se cerró y debes generar un nuevo QR.
- Asegúrate de que el celular tiene Wi-Fi o datos estables, batería y WhatsApp actualizado.
Genera un nuevo QR Code
- En ChatCielo, ve a Administración > Canales y abre el canal QR afectado.
- Haz clic en Nuevo QR Code.
- En el celular, toca Vincular un dispositivo y escanea el QR en los siguientes 30 segundos.
- Espera el estado Conectado en el panel.
Estabiliza la conexión
- Mantén el celular siempre conectado y sin cerrar sesión manualmente.
- Evita abrir la misma cuenta de WhatsApp en otro navegador o dispositivo que pueda desplazar la sesión.
- Si el error se repite a diario, evalúa migrar ese número a WABA Oficial o a Modo Híbrido para eliminar la dependencia del QR.
Plantilla WABA no llega al destinatario
Enviaste una plantilla aprobada y el destinatario no la recibe. En el detalle del mensaje ves Rechazado, Failed o No entregado.
Motivos de rechazo por Meta
Meta bloquea plantillas enviadas a usuarios que no dieron consentimiento previo (opt-in) o que reportaron tu número como spam.
- Asegúrate de tener opt-in explícito (formulario, checkbox, confirmación por chat).
- Incluye siempre una opción de baja clara (ej. "Responde STOP para no recibir más mensajes").
- Si tu score de calidad bajó, pausa campañas y revisa denuncias en Business Manager > Calidad.
Revisa el detalle del rechazo
- En Atenciones o Campañas, abre el mensaje fallido y lee el motivo de error que devuelve Meta.
- Anota el código y la descripción (ej.
132000 - Template param count mismatchindica error en{{1}}).
Corrige y reenvía
- Corrige la variable (
{{1}},{{2}}) o el opt-in según el motivo. - Si la plantilla fue rechazada por contenido, duplícala, ajusta el texto y reenvíala a aprobación en Configuraciones > Plantillas.
- Una vez aprobada, reintenta el envío al destinatario.
Valida antes de masivos
Antes de una campaña, envía la plantilla a 2 o 3 números de prueba con distintos valores de {{1}} y {{2}} para confirmar entrega y formato.
No reintentes envíos masivos con la misma plantilla rechazada sin corregir la causa: cada rechazo adicional deteriora tu score de calidad y puede limitar tu capacidad de envío.
Checklist rápido de diagnóstico
| Síntoma | Revisa primero | Solución en esta guía |
|---|---|---|
PERMISSION CONNECTIONS LIMITED al conectar WABA | Estado de WABA y límites en Business Manager | Sección PERMISSION CONNECTIONS LIMITED |
Token expirado / Sesión inválida | Permisos del BM y usuario administrador | Sección Token Expirado |
Esperando mensaje / QR no conecta | Celular vinculado y red | Sección Esperando mensaje |
| Plantilla aprobada no llega | Variables {{1}}, opt-in y categoría | Sección Plantilla no llega |
Si tras seguir el paso a paso el error persiste, contacta a soporte con: nombre del tenant, ID del canal, captura del error y hora aproximada del fallo.