Saltar al contenido principal

Solución de Problemas y Preguntas Frecuentes

Esta página cubre problemas comunes y cómo resolverlos al trabajar con PulseChat.

1. El Chat No Aparece en la Barra Lateral​

Síntomas:

  • No hay elemento de menú "Chat" en la barra lateral de administración.

Verificaciones:

  1. ¿Módulo habilitado?

    • Ve a Configuración > Módulos.
    • Asegúrate de que PulseChat esté Activo.

  2. ¿Permisos del personal?

    • Tu rol debe tener la capacidad view para PulseChat.
    • Verifica Configuración > Personal > Roles y confirma:
      • view bajo PulseChat está habilitado para tu rol.

  3. ¿Opción de PulseChat habilitada?

    • En la configuración de PulseChat, asegúrate de que:
      • pulsechat_enabled esté configurado en Yes.

2. Problemas de Transporte (Mensajes Lentos o Sin Tiempo Real)​

Síntomas:

  • Los mensajes aparecen solo después de actualizar la página o con retrasos.
  • Los indicadores de escritura / confirmaciones de lectura son inconsistentes.

Verificaciones:

  1. Mira la barra de transporte en la parte superior del chat:

    • "Pusher WebSockets -- entrega instantánea" (azul) o
    • "Sondeo Incorporado -- los mensajes se actualizan cada ~3s" (verde).

  2. Si usas Pusher:

    • Confirma las credenciales de Pusher (App ID/Key/Secret/Cluster) en la configuración de Perfex.
    • Asegúrate de que el firewall no esté bloqueando pusher.com.
    • Revisa el panel de Pusher para errores o límites de conexión.

  3. Si usas Sondeo:

    • Algo de retraso (unos segundos) es normal; este es el comportamiento esperado.

  4. Para cambiar el transporte:

    • Ve a Configuración de PulseChat > Transporte en Tiempo Real.
    • Elige pusher, polling o auto.
    • Guarda y recarga la página del chat.

3. Los Archivos No Se Suben​

Síntomas:

  • La subida falla silenciosamente o con un error.

Verificaciones:

  1. Tipos de archivo permitidos

    • Asegúrate de que la extensión esté permitida en pulsechat_allowed_file_types.

  2. Tamaño máximo

    • El tamaño del archivo debe estar dentro del límite de pulsechat_max_file_size_mb.

  3. Permisos

    • Verifica que modules/pulsechat/uploads/ sea escribible.

  4. Registros de errores

    • Revisa los registros de Perfex y los registros de errores del servidor para mensajes relacionados con la subida.

4. Los Clientes No Pueden Ver o Usar el Chat​

Síntomas:

  • El personal puede usar PulseChat; los clientes no pueden ver ningún widget de chat.

Verificaciones:

  1. ¿Chat de clientes habilitado?

    • Asegúrate de que pulsechat_clients_enabled esté configurado en Yes en la configuración.

  2. Hooks del portal del cliente

    • PulseChat inyecta un widget en el portal del cliente vía init_chat.php.
    • Asegúrate de que no haya sobrecargas o personalizaciones de plantilla que lo eliminen.

  3. Permisos

    • Solo los contactos autenticados pueden usar el chat de clientes; los visitantes anónimos no lo verán.

5. Los Mensajes Omnicanal No Llegan​

Síntomas:

  • Los mensajes de WhatsApp/Telegram/Email no aparecen en Canales.

Verificaciones:

  1. ¿Omnicanal habilitado?

    • pulsechat_channels_enabled = Yes.

  2. Configuración del canal

    • Para cada tipo de canal:
      • WhatsApp: token, ID del teléfono, URL del webhook configurados en Meta.
      • Telegram: token del bot y URL del webhook configurados vía BotFather.
      • Email: configuración IMAP correcta, SSL/puertos correctos, credenciales válidas.

  3. Webhooks

    • Confirma que los webhooks del proveedor apunten a tu endpoint ChannelWebhook/webhook.php.
    • Revisa los registros para verificaciones de firma fallidas.

  4. Sondeo de email

    • Asegúrate de que el cron de Perfex esté ejecutándose.
    • pulsechat_cron_email_poll no se ejecutará sin after_cron_run.

6. Los Botones de IA No Funcionan​

Síntomas:

  • La barra de herramientas de IA es visible pero:
    • Hacer clic en Borrador/Sugerir/Reescribir/Traducir no hace nada, o
    • Los toast muestran "AI not configured" o errores HTTP.

Verificaciones:

  1. Configuración

    • pulsechat_ai_enabled = Yes.
    • Proveedor seleccionado (openai o anthropic).
    • Clave API correcta ingresada para el proveedor seleccionado.
    • Interruptores de funciones de IA (Respuesta Automática, Sugerencias, Reescritura, Traducción, Sentimiento) habilitados según se desee.

  2. Red

    • Asegúrate de que tu servidor pueda alcanzar:
      • https://api.openai.com
      • https://api.anthropic.com
    • Revisa si hay bloqueos de firewall/proxy o problemas de DNS.

  3. Texto de error

    • Muchos errores devuelven:
      • "OpenAI API key not configured."
      • "Text is required."
      • Estado HTTP con mensaje de error del proveedor.

  4. Registros de IA

    • Revisa pc_ai_logs para más detalles:
      • action_type, model, error (si se capturó), conteos de tokens.

7. Errores de Base de Datos (Constantes No Definidas)​

Síntomas:

  • Errores como "Undefined constant TABLE_PC_MESSAGES".

Verificaciones:

  1. Asegúrate de que el código más reciente de PulseChat esté desplegado:
    • pulsechat.php define las constantes TABLE_PC_*.
  2. Respaldos en Pulsechat_model:
    • El modelo define constantes de tablas principales si no están ya definidas.
  3. Si aún ves esto:
    • Confirma que no haya copias duplicadas/antiguas del módulo en otras rutas.

8. ¿Sigues Atascado?​

Si has probado lo anterior y aún no puedes resolver el problema:

  1. Recopila:
    • Mensajes de error exactos.
    • Registros relevantes (registros de errores de PHP, registros de Perfex).
    • Capturas de pantalla de las pantallas de configuración relevantes.
  2. Contacta al soporte con:
    • Tu versión de Perfex.
    • Versión de PulseChat.
    • Cualquier personalización que hayas hecho (vistas sobreescritas, código modificado, etc.).

Esta información hará mucho más fácil diagnosticar y solucionar el problema rápidamente.