• Instalacion y primeros pasos
  • Sistema de mensajeria interna (Chat) +
    • Sistema de tickets +
      • Configuracion de email (IMAP/SMTP) +
        • Automatizacion email-a-ticket y flujos de trabajo

Instalacion y primeros pasos

Descripcion del plugin

FSMensajeria es un plugin para FacturaScripts que anade tres funcionalidades principales:

• Mensajeria interna: Sistema de chat entre usuarios de FacturaScripts.
• Sistema de tickets: Gestion de incidencias con estados, prioridades, categorias y asignaciones.
• Integracion con email: Recepcion automatica de emails por IMAP y envio de respuestas por SMTP, con creacion automatica de tickets desde correos entrantes.

Requisitos

• FacturaScripts 2025.5 o superior
• PHP 8.0 o superior
• Extension PHP imap (solo si se va a usar la integracion con email)
• Extension PHP openssl (para conexiones seguras IMAP/SMTP)

Instalacion

Opcion A: Desde la Forja de FacturaScripts

1. Accede al panel de administracion de tu FacturaScripts.
2. Ve a Admin > Plugins.
3. Busca FSMensajeria en la lista de plugins disponibles.
4. Haz clic en Instalar.
5. Espera a que se complete la instalacion y haz clic en Activar.

Opcion B: Instalacion manual (archivo ZIP)

1. Descarga el archivo FSMensajeria-v2.2.zip.
2. Accede a tu FacturaScripts > Admin > Plugins.
3. Haz clic en el boton Subir plugin (icono de subida).
4. Selecciona el archivo ZIP descargado.
5. Una vez subido, haz clic en Activar junto al plugin FSMensajeria.

Nota: No es necesario descomprimir el ZIP. FacturaScripts lo procesa automaticamente.

Primeros pasos tras la instalacion

Menu del plugin

Una vez activado, aparecera un nuevo menu llamado Chat / Tickets en la barra de navegacion con las siguientes opciones:

• Mensajes - Bandeja de mensajes internos (recibidos y enviados)
• Tickets - Lista de todos los tickets del sistema
• Config. Email - Configuracion de cuentas de correo IMAP/SMTP

Tablas creadas automaticamente

El plugin crea automaticamente las siguientes tablas en la base de datos:

• mensajes - Almacena los mensajes internos entre usuarios
• tickets - Almacena los tickets de soporte/incidencias
• ticket_respuestas - Almacena las respuestas/conversaciones de cada ticket
• email_config - Almacena la configuracion de cuentas de email

Si actualizas desde una version anterior (v2.1 o inferior), el plugin detecta y corrige automaticamente tablas o archivos XML corruptos de versiones previas.

Actualizacion desde versiones anteriores

Desde v2.1 a v2.2

La actualizacion es automatica. Al activar la nueva version:

1. Se limpian archivos XML corruptos de versiones anteriores.
2. Se crean las tablas que falten (si no existian).
3. Se anaden las columnas nuevas de v2.2 a tablas existentes:
   • tickets: campos origen, email_origen, email_msgid
   • ticket_respuestas: campos origen, email_msgid

No es necesario ejecutar ningun SQL manualmente.

Desinstalacion

1. Ve a Admin > Plugins.
2. Haz clic en Desactivar junto a FSMensajeria.
3. Si deseas eliminar completamente el plugin, haz clic en Eliminar.

Atencion: La desinstalacion NO elimina las tablas de la base de datos ni los archivos adjuntos. Si deseas eliminar todos los datos, deberas borrar manualmente las tablas mensajes, tickets, ticket_respuestas y email_config, asi como la carpeta MyFiles/Mensajes/ y MyFiles/Tickets/.

Indice de la documentacion

• Parte 1: Instalacion y primeros pasos (esta pagina)
• Parte 2: Sistema de mensajeria interna (Chat)
• Parte 3: Sistema de tickets
• Parte 4: Configuracion de email (IMAP/SMTP)
• Parte 5: Automatizacion email-a-ticket y flujos de trabajo