ChatCieloDocs

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

  1. Entra a business.facebook.com > Configuración del negocio > Cuentas > Cuentas de WhatsApp Business.
  2. Selecciona tu WABA y revisa el estado de la cuenta, el nivel de verificación y los límites de números.
  3. Si ves advertencias de calidad o límite alcanzado, anota el detalle para el siguiente paso.

Limpia números inactivos o pendientes

  1. En el mismo panel de Meta, elimina números no verificados, pendientes o sin uso que ocupen cupo.
  2. En ChatCielo, ve a Administración > Canales y desconecta o elimina canales WABA en estado Error o Pendiente que ya no uses.
  3. 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:

  1. Toma una captura del error en ChatCielo y del estado de tu WABA en Meta.
  2. Envía a soporte tu nombre de tenant, ID de WABA y las capturas con el asunto PERMISSION CONNECTIONS LIMITED.
  3. 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

  1. Entra a business.facebook.com con el usuario administrador del BM.
  2. Verifica que sigues siendo Administrador de la WABA y del Business Manager.
  3. En Configuración > Integraciones > Conexiones, confirma que el App de ChatCielo sigue autorizado.

Reconecta el canal WABA

  1. En ChatCielo, ve a Administración > Canales.
  2. Localiza el canal WABA desconectado y haz clic en Reconectar o Conectar vía WhatsApp OAuth.
  3. Completa el flujo de OAuth en el pop-up de Meta sin cerrar la ventana antes de tiempo.
  4. 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:

  1. Abre Atenciones y verifica que las conversaciones previas siguen visibles.
  2. Envía un mensaje de prueba desde un número externo y confirma que entra al panel.
  3. 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

  1. Abre WhatsApp en el celular que escaneó el QR.
  2. Ve a Configuración > Dispositivos vinculados y confirma que el dispositivo de ChatCielo aparece como Activo.
  3. Si no aparece, la sesión se cerró y debes generar un nuevo QR.
  4. Asegúrate de que el celular tiene Wi-Fi o datos estables, batería y WhatsApp actualizado.

Genera un nuevo QR Code

  1. En ChatCielo, ve a Administración > Canales y abre el canal QR afectado.
  2. Haz clic en Nuevo QR Code.
  3. En el celular, toca Vincular un dispositivo y escanea el QR en los siguientes 30 segundos.
  4. Espera el estado Conectado en el panel.

Estabiliza la conexión

  1. Mantén el celular siempre conectado y sin cerrar sesión manualmente.
  2. Evita abrir la misma cuenta de WhatsApp en otro navegador o dispositivo que pueda desplazar la sesión.
  3. 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

  1. En Atenciones o Campañas, abre el mensaje fallido y lee el motivo de error que devuelve Meta.
  2. Anota el código y la descripción (ej. 132000 - Template param count mismatch indica error en {{1}}).

Corrige y reenvía

  1. Corrige la variable ({{1}}, {{2}}) o el opt-in según el motivo.
  2. Si la plantilla fue rechazada por contenido, duplícala, ajusta el texto y reenvíala a aprobación en Configuraciones > Plantillas.
  3. 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íntomaRevisa primeroSolución en esta guía
PERMISSION CONNECTIONS LIMITED al conectar WABAEstado de WABA y límites en Business ManagerSección PERMISSION CONNECTIONS LIMITED
Token expirado / Sesión inválidaPermisos del BM y usuario administradorSección Token Expirado
Esperando mensaje / QR no conectaCelular vinculado y redSección Esperando mensaje
Plantilla aprobada no llegaVariables {{1}}, opt-in y categoríaSecció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.