Saltar al contenido principal

Configuración de Administrador

Esta página explica cómo configurar PulseChat como administrador: transporte, permisos, límites, canales omnicanal, IA y otras opciones expuestas en views/admin/settings.php.

Todas las opciones a continuación se encuentran en Configuración -> Módulos -> PulseChat -> Configuración (que abre admin/pulsechat/settings).

1. General​

Estas opciones controlan el comportamiento global del módulo.

  • Habilitar PulseChat

    • Opción: pulsechat_enabled
    • Cuando es Sí, PulseChat está activo y el elemento de menú de chat aparece para el personal con permiso.

  • Habilitar Chat de Clientes

    • Opción: pulsechat_clients_enabled
    • Cuando es Sí, se inyecta un widget de chat en el portal del cliente, permitiendo conversaciones entre personal y clientes.

  • Estado Predeterminado del Usuario al Iniciar Sesión

    • Opción: pulsechat_default_status
    • Valores: online, away, busy, offline
    • Determina el estado de presencia inicial cuando el personal abre el área de administración.

2. Notificaciones​

  • Notificaciones de Escritorio

    • Opción: pulsechat_desktop_notifications
    • Habilita las notificaciones de escritorio del navegador para nuevos mensajes (el personal debe permitir las notificaciones en el navegador).

  • Notificaciones de Sonido

    • Opción: pulsechat_sound_notifications
    • Reproduce un sonido (assets/audio/notification.mp3) cuando llegan nuevos mensajes.

  • Notificaciones Toast

    • Opción: pulsechat_toast_notifications
    • Muestra pequeñas notificaciones emergentes dentro de la interfaz de administración para eventos clave.

3. Permisos y Acceso​

Estas opciones y capacidades del personal controlan quién puede usar qué.

3.1 Capacidades del Personal (basadas en roles)​

Definidas en pulsechat.php mediante pulsechat_register_permissions():

  • view --- puede ver la interfaz de PulseChat.
  • send --- puede enviar mensajes.
  • delete --- puede eliminar mensajes (sujeto a configuración adicional).
  • create_groups --- puede crear conversaciones grupales.
  • manage_channels --- puede configurar conexiones omnicanal.
  • manage_automation --- puede gestionar reglas de automatización.
  • view_analytics --- puede ver analíticas e informes.
  • use_ai --- puede acceder a herramientas de IA (borrador, sugerencias, reescritura, traducción, etc.).
  • assign --- puede asignar / reasignar conversaciones.
  • view_all_channels --- puede ver todas las conversaciones omnicanal, no solo las asignadas/propias.

Asigna estas capacidades a los roles en Configuración -> Personal -> Roles.

3.2 Permisos en la Pestaña de Configuración​

  • Permitir al Personal Eliminar Mensajes

    • Opción: pulsechat_staff_can_delete

  • Permitir al Personal Crear Grupos

    • Opción: pulsechat_staff_can_create_groups

  • Permitir Abandonar Grupos

    • Opción: pulsechat_allow_leave_groups
    • Si es No, solo los administradores pueden eliminar miembros o disolver grupos.

  • Nuevos Miembros Ven el Historial

    • Opción: pulsechat_new_members_see_history
    • Cuando es Sí, los miembros recién añadidos ven el historial completo del grupo.
    • Cuando es No, solo ven los mensajes enviados después de unirse.

  • Solo Usuarios Permitidos

    • Opción: pulsechat_only_permitted_users
    • Cuando es Sí, solo el personal con la capacidad view (o administradores) aparece en las listas de personal y puede usar PulseChat.

4. Funcionalidades​

Activa o desactiva funcionalidades opcionales:

  • Compartir Archivos

    • pulsechat_allow_file_sharing
    • Habilita la subida de archivos adjuntos mediante el botón del clip.

  • Mensajes de Audio

    • pulsechat_allow_audio_messages
    • Habilita la grabación y envío de mensajes de voz.

  • Reacciones

    • pulsechat_allow_reactions
    • Habilita reacciones con emoji en los mensajes.

  • Reenvío

    • pulsechat_allow_message_forwarding

  • Fijar

    • pulsechat_allow_message_pinning

  • Conversión a Ticket

    • pulsechat_allow_ticket_conversion
    • Habilita el botón "Convertir a Ticket" en el encabezado del chat.

  • Indicadores de Escritura

    • pulsechat_show_typing_indicators

  • Confirmaciones de Lectura

    • pulsechat_show_read_receipts

  • Estado en Línea

    • pulsechat_show_online_status

5. Límites y Gestión de Datos​

5.1 Límites​

  • Tamaño Máximo de Archivo

    • pulsechat_max_file_size_mb
    • Tamaño máximo de subida para archivos adjuntos (en MB).

  • Ventana de Edición de Mensajes

    • pulsechat_edit_window_minutes
    • Cuánto tiempo después de enviar un mensaje se puede editar (0 = nunca permitido).

  • Máximo de Miembros por Grupo

    • pulsechat_max_group_members

  • Tipos de Archivo Permitidos

    • pulsechat_allowed_file_types
    • Lista separada por comas de extensiones (ej. .jpg,.png,.pdf,.docx).

5.2 Retención de Datos​

Definida en la misma página de Configuración:

  • Purga Automática Después de (meses)
    • pulsechat_auto_purge_months
    • 0 = nunca purgar.
    • De lo contrario, los mensajes más antiguos que el número especificado de meses pueden ser purgados por la lógica de limpieza.

6. Apariencia​

PulseChat hereda los estilos de Perfex y añade los propios.

Opciones clave:

  • Color de Marca

    • pulsechat_brand_color
    • Usado para acentos primarios en la interfaz del chat.

  • Fondo del Chat

    • pulsechat_chat_bg
    • Selecciona entre fondos/temas predefinidos.

También hay preferencias a nivel de usuario (tema oscuro/claro) almacenadas por personal y aplicadas mediante atributos data-theme en chat_view.php.

7. Transporte (Tiempo Real)​

PulseChat soporta:

  • Sondeo Incorporado --- Llamadas AJAX periódicas para obtener nuevos mensajes (sin servicios externos).
  • Pusher WebSockets --- Entrega en tiempo real mediante Pusher Channels.
  • Auto --- Usa Pusher cuando está correctamente configurado; de lo contrario, recurre al sondeo.

Configuraciones relevantes en la sección "Transporte en Tiempo Real":

  • pulsechat_transport --- auto, pusher o polling
  • Configuraciones adicionales de Pusher extraídas de la configuración central de Perfex (App ID, Key, Secret, Cluster).

Puedes cambiar estas en cualquier momento en la configuración de PulseChat; la interfaz indica el modo activo mediante la barra de transporte en la parte superior del chat.

8. Canales Omnicanal​

Para habilitar la bandeja de entrada omnicanal:

  • Activa Habilitar Canales Omnicanal
    • Opción: pulsechat_channels_enabled
    • Cuando es Sí, aparece una pestaña de Canales en la barra lateral izquierda y el backend omnicanal está activo.

Cada canal (WhatsApp, Telegram, Email, etc.) se configura en la interfaz de Canales (icono de engranaje en la pestaña de Canales) y se almacena en pc_channels como configuración JSON encriptada.

Consulta Omnicanal y Canales para detalles por canal.

9. Asistente de IA​

PulseChat puede usar OpenAI (ChatGPT) o Anthropic (Claude) para:

  • Borradores de respuestas
  • Sugerencias inteligentes (chips)
  • Reescritura de mensajes
  • Ortografía/gramática
  • Resúmenes
  • Traducción
  • Análisis de sentimiento

En la sección Asistente de IA --- Multi-Proveedor encontrarás:

  • Habilitar Funciones de IA

    • pulsechat_ai_enabled

  • Proveedor de IA

    • pulsechat_ai_provider --- openai o anthropic

  • Clave API de OpenAI

    • pulsechat_ai_api_key

  • Clave API de Anthropic

    • pulsechat_ai_anthropic_api_key

  • Modelo de IA

    • pulsechat_ai_model --- las opciones incluyen:
      • OpenAI: gpt-4o, gpt-4o-mini, gpt-3.5-turbo
      • Anthropic: claude-3-5-sonnet-20241022, claude-3-5-haiku-20241022, claude-3-opus-20240229

  • Prompt del Sistema

    • pulsechat_ai_system_prompt
    • Instrucción global utilizada por todas las llamadas de IA (ej. "Eres un asistente de soporte al cliente útil...").

  • Temperatura

    • pulsechat_ai_temperature

  • Máximo de Tokens

    • pulsechat_ai_max_tokens

  • Interruptores de Funciones

    • pulsechat_ai_auto_reply --- muestra el botón Borrador (borrador de respuesta IA).
    • pulsechat_ai_suggestions --- muestra chips de sugerencias.
    • pulsechat_ai_rewrite --- habilita el botón de reescritura.
    • pulsechat_ai_translate --- habilita el botón de traducción.
    • pulsechat_ai_sentiment --- ayudantes de análisis de sentimiento.

Consulta Asistente de IA para ver cómo aparecen en la interfaz y cómo se comportan en las conversaciones.

10. Licencia​

La licencia de PulseChat se configura mediante:

  • pulsechat_verification_id
  • pulsechat_product_token
  • pulsechat_last_verification
  • pulsechat_heartbeat

Estos son gestionados automáticamente por el flujo de licencias y no deben editarse manualmente. Para cambiar la licencia:

  • Desactiva PulseChat en Configuración -> Módulos.
  • Actívalo de nuevo; la pantalla de activación reaparecerá, permitiéndote ingresar una nueva clave de compra.