Configuracion de email (IMAP/SMTP)
Descripcion general
FSMensajeria puede conectarse a una cuenta de correo electronico para:
- Recibir emails (IMAP): Los emails entrantes se convierten automaticamente en tickets.
- Enviar emails (SMTP): Las respuestas a tickets se pueden enviar por correo al remitente original.
Esta funcionalidad es opcional. La mensajeria interna y los tickets funcionan sin configuracion de email.
Requisitos previos
Extension PHP IMAP
La recepcion de emails requiere la extension PHP imap. Si no esta instalada, la pagina de configuracion muestra un aviso rojo indicandolo.
Para instalarla en Debian/Ubuntu:
sudo apt install php-imap && sudo phpenmod imap && sudo systemctl restart apache2
Nota: El envio de emails (SMTP) funciona sin la extension IMAP. Solo la recepcion la necesita.
Contrasenas de aplicacion
Si usas Gmail o Outlook/Office 365, necesitaras una contrasena de aplicacion en lugar de tu contrasena normal.
Gmail:
- Ve a tu cuenta de Google > Seguridad > Verificacion en dos pasos (debe estar activa).
- Busca "Contrasenas de aplicacion" al final de la seccion.
- Genera una contrasena para "Correo" en "Otro dispositivo".
- Usa esa contrasena de 16 caracteres en la configuracion IMAP/SMTP.
Outlook/Office 365:
- Ve a tu cuenta de Microsoft > Seguridad > Contrasenas de aplicaciones.
- Genera una nueva contrasena de aplicacion.
- Usa esa contrasena en la configuracion.
Acceder a la configuracion
Desde el menu Chat / Tickets > Config. Email se abre la pagina de configuracion.
Datos generales
La primera tarjeta contiene los datos basicos de la cuenta:
- Nombre de la cuenta: Nombre identificativo para esta configuracion (ejemplo: "Principal")
- Email de soporte: Direccion que aparece como remitente en los emails enviados (ejemplo: soporte@tuempresa.com)
- Usuario por defecto: Usuario de FacturaScripts que se asigna como creador de los tickets creados desde email
Importante: El "Usuario por defecto" es el usuario interno que aparece como creador de todos los tickets generados automaticamente desde emails.
Configuracion IMAP (Recepcion)
La tarjeta IMAP permite configurar la conexion para recibir emails:
- Servidor IMAP: Direccion del servidor de correo entrante
- Puerto: Puerto de conexion IMAP (por defecto: 993)
- Cifrado: Tipo de cifrado (SSL, TLS o Ninguno)
- Usuario IMAP: Nombre de usuario o email para autenticacion
- Contrasena IMAP: Contrasena o contrasena de aplicacion (se almacena codificada)
Valores recomendados por proveedor
Gmail: imap.gmail.com / Puerto 993 / SSL
Outlook/Office 365: outlook.office365.com / Puerto 993 / SSL
Servidor propio: mail.tudominio.com / Puerto 993 / SSL
Probar conexion IMAP
Haz clic en "Probar conexion IMAP" para verificar que los datos son correctos. El sistema mostrara:
- Exito: Mensaje verde con el numero de emails no leidos encontrados.
- Error: Mensaje con detalles del fallo.
La prueba guarda automaticamente la configuracion antes de probar.
Configuracion SMTP (Envio)
La tarjeta SMTP permite configurar la conexion para enviar emails:
- Servidor SMTP: Direccion del servidor de correo saliente
- Puerto: Puerto de conexion SMTP (por defecto: 587)
- Cifrado: Tipo de cifrado (TLS/STARTTLS, SSL o Ninguno)
- Usuario SMTP: Nombre de usuario o email para autenticacion
- Contrasena SMTP: Contrasena o contrasena de aplicacion
Valores recomendados por proveedor
Gmail: smtp.gmail.com / Puerto 587 / TLS
Outlook/Office 365: smtp.office365.com / Puerto 587 / TLS
Servidor propio: mail.tudominio.com / Puerto 587 / TLS
Probar conexion SMTP
Haz clic en "Probar conexion SMTP" para verificar la conexion. El test verifica que el servidor responde correctamente.
Opciones de automatizacion
Estado (Activo / Inactivo)
El interruptor principal activa o desactiva toda la integracion de email. Cuando esta activo, el sistema revisa periodicamente el buzon de correo.
Crear tickets automaticamente
- Activado (recomendado): Los emails nuevos crean tickets automaticamente.
- Desactivado: Los emails se reciben pero no se crean tickets (util para pruebas).
Enviar confirmacion al crear ticket
- Activado (recomendado): Cuando se crea un ticket desde un email, se envia una respuesta automatica al remitente con el codigo del ticket (requiere SMTP configurado).
- Desactivado: No se envia confirmacion.
Intervalo de comprobacion
Define cada cuantos minutos el sistema revisa si hay emails nuevos. Valor por defecto: 5 minutos. Rango permitido: 1 a 60 minutos.
La comprobacion se ejecuta en cada carga de pagina de FacturaScripts, pero respeta el intervalo configurado. Si configuraste 5 minutos, no revisara el buzon hasta que pasen 5 minutos desde la ultima revision.
Plantilla de auto-respuesta
Cuando se crea un ticket desde un email y la opcion "Enviar confirmacion" esta activa, se envia un email con el texto configurado en esta plantilla.
Variable disponible
{CODIGO} se reemplaza por el codigo del ticket creado (ejemplo: TKT-00042)
Ejemplo de plantilla
Hemos recibido tu mensaje y se ha registrado con el codigo {CODIGO}. Para hacer seguimiento o responder, incluye el codigo {CODIGO} en el asunto de tu email. Gracias.
Puedes personalizar este texto a tu gusto. La variable {CODIGO} se puede usar multiples veces.
Acciones manuales
Guardar configuracion
Boton "Guardar configuracion": Guarda todos los cambios realizados en el formulario.
Revisar emails ahora
Boton "Revisar emails ahora": Ejecuta una comprobacion inmediata del buzon de correo, sin esperar al intervalo programado. Muestra un resumen con: emails procesados, tickets creados, respuestas anadidas y errores (si los hay).
Resolucion de problemas
"Extension PHP IMAP no instalada": Instala la extension php-imap en tu servidor (ver seccion Requisitos previos).
"Error de conexion IMAP: Login failed": Verifica usuario y contrasena. Si usas Gmail, asegurate de usar una contrasena de aplicacion. Comprueba que IMAP esta habilitado en tu proveedor.
"Error de conexion SMTP": Verifica servidor, puerto y cifrado. Para Gmail, el puerto 587 con TLS suele funcionar mejor.
"No hay emails nuevos" pero hay emails en el buzon: El sistema solo lee emails no leidos (UNSEEN). Si ya estan marcados como leidos, no se procesan.