Saltar al contenido principal

Primeros Pasos

Esta página te guía a través de la instalación, activación y primera apertura de PulseChat.

1. Requisitos​

  • Perfex CRM >= 3.0.0
  • Versión de PHP compatible con tu instalación de Perfex (PulseChat no requiere extensiones especiales más allá de las que Perfex ya utiliza)

2. Instalación​

  1. Sube el módulo

    • Copia la carpeta del módulo pulsechat en tu instalación de Perfex bajo:
      • modules/pulsechat
    • Asegúrate de que todas las subcarpetas estén presentes:
      • controllers, models, views, assets, migrations, language, libraries, core, third_party, vendor, etc.

  2. Verifica los permisos de archivos

    • El usuario del servidor web/PHP debe poder leer los archivos del módulo.
    • El directorio de subida debe ser escribible:
      • modules/pulsechat/uploads/

  3. Inicia sesión como administrador

    • Inicia sesión en tu Perfex CRM como miembro del personal con privilegios de administrador.

3. Asistente de Configuración Inicial​

En el primer uso como administrador:

  1. Ve a PulseChat desde la barra lateral izquierda:

    • Verás un icono de chat (fa-comments) añadido por el módulo.
    • Haz clic para abrir la página completa de PulseChat (admin/pulsechat/chat).

  2. Si la configuración inicial no se ha completado, verás un asistente:

    • Este te guía para seleccionar el modo de transporte:
      • Pusher WebSockets --- mensajería instantánea en tiempo real (requiere credenciales de Pusher).
      • Sondeo Incorporado --- sin servicio externo, los mensajes se actualizan cada ~3 segundos.
    • Para Pusher, se te pedirá:
      • App ID, Key, Secret, Cluster

  3. Después de guardar, el asistente marca la configuración como completa y te redirige a la interfaz principal del chat.

Siempre puedes cambiar el transporte más tarde desde Configuración de PulseChat, por lo que el asistente es solo una conveniencia para instalaciones iniciales.

4. Dónde Encontrar PulseChat en Perfex​

  • Área de administración

    • Barra lateral izquierda: una entrada "Chat" (PulseChat) bajo la navegación principal.
    • Abre la interfaz de chat de tres paneles (chat_view.php).

  • Área de clientes (opcional)

    • Si el chat de clientes está habilitado en la configuración, aparece un widget de chat flotante en el portal del cliente, permitiendo conversaciones entre personal y clientes.

  • Página de módulos

    • Configuración -> Módulos -> PulseChat
      • Enlaces:
        • Configuración --- abre admin/pulsechat/settings (configuración completa de PulseChat).
        • Abrir Chat --- atajo a admin/pulsechat/chat.

5. Modelo de Datos Básico (Alto Nivel)​

PulseChat almacena sus datos en tablas dedicadas (todas prefijadas mediante db_prefix()):

  • pc_conversations --- todas las conversaciones (MD de personal, grupos, clientes, omnicanal)
  • pc_participants --- participantes en cada conversación
  • pc_messages --- mensajes individuales (entrantes/salientes, multimedia, mensajes del sistema)
  • pc_channels --- conexiones omnicanal (WhatsApp, Telegram, Email, etc.)
  • pc_external_contacts, pc_contact_identities --- mapeo de contactos externos para canales
  • pc_ai_logs --- seguimiento de uso y costos de IA
  • pc_analytics_cache, pc_assignments_log --- analíticas e historial de asignaciones

No necesitas gestionar estas tablas manualmente --- las migraciones de Perfex se encargan de la creación y actualización --- pero entenderlas ayuda al solucionar problemas o crear integraciones.

6. Siguientes Pasos​

Una vez que PulseChat está instalado y activado: