ChatCieloDocs

Sesiones

Gestión de sesiones activas de agentes y canales, cierre de sesiones huérfanas y buenas prácticas de seguridad.

Sesiones

El módulo Sesiones es el centro de control de todas las conexiones activas de ChatCielo: canales de WhatsApp, Webchat, Telegram y las sesiones autenticadas de tus agentes. Desde aquí detectas desconexiones, cierras sesiones huérfanas y proteges la operación.

Ruta: Canales > Sesiones o /sessoes. Verás cada canal con su estado, QR (cuando aplica), agente asignado y última sincronización.

Estados de sesión

Conectado

Canal operativo. Los mensajes entran y salen con normalidad. Indicador verde.

Desconectado

Sesión caída por QR expirado, cierre desde el móvil o inestabilidad de red.

Sincronizando

Reconectando. Espera 30–60 s antes de intervenir.

Huérfana / Zombie

Sesión autenticada sin agente o canal activo. Debe cerrarse manualmente.

Gestión de sesiones activas

Canales (WhatsApp QR / WABA / Telegram / Webchat)

  1. Identifica el canal por nombre y número/bot.
  2. Verifica el badge de estado y el timestamp de última actividad.
  3. Si está desconectado:
    • QR: clic en Reconectar y escanea el nuevo QR desde el móvil en < 40 s.
    • WABA Oficial: verifica token y webhook en Meta Cloud API; usa Probar conexión.
    • Telegram / Webchat: valida token y estado del webhook.

No reconectes un mismo número QR en dos instancias simultáneamente: provocarás desconexiones cíclicas y posible bloqueo temporal por actividad sospechosa.

Agentes

  • Cada login genera una sesión vinculada al navegador/dispositivo.
  • Puedes forzar Cerrar sesión de un agente (ej. dispositivo perdido o rotación de turno).
  • Filtra por En línea / Fuera de línea para auditar quién está recibiendo chats.

Cierre de sesiones huérfanas

Las sesiones huérfanas ocurren tras cierres abruptos, múltiples logins o pruebas de integración.

Procedimiento:

  1. En Sesiones, ordena por Última actividad — las huérfanas suelen tener timestamp antiguo y sin canal vinculado.
  2. Selecciona la sesión > Cerrar / Desconectar.
  3. Confirma. El token se invalida y se libera el slot en el servidor.
  4. Si el canal no vuelve a conectar, reinicia caché y cookies del navegador del agente.

Programa una revisión semanal de sesiones huérfanas si tu equipo supera 15 agentes o usas múltiples canales QR. Reduce zumbidos de "mensajes no llegan".

Seguridad y prevención

Autenticación

Usa contraseñas robustas y, si tu plan lo soporta, 2FA. Evita compartir el mismo usuario entre varios agentes.

Roles y permisos

Limita quién puede reconectar canales y cerrar sesiones globales a Supervisor/Administrador.

Cierre por inactividad

Configura tiempo de expiración en Configuraciones Generales para sesiones ociosas.

Auditoría

Revisa el listado de IPs y dispositivos si sospechas acceso no autorizado.

Buenas prácticas

  • Un dispositivo = una sesión: evita logins duplicados del mismo agente en dos navegadores.
  • Nombra tus canales con patrón claro: WABA-Ventas-549... o QR-Soporte-52....
  • Documenta reconexiones en Notas internas para trazabilidad.
  • Tras reconectar QR, envía un mensaje de prueba y verifica que llegue a Atenciones sin demora > 5 s.

Si una sesión no se restablece tras 3 intentos, contacta soporte con el ID del canal, captura del error y timestamp. No borres el canal sin respaldo: perderás el historial asociado.