La integración IMAP/SMTP permite conectar al helpdesk cualquier cuenta de correo que soporte los protocolos estándar de internet: IMAP para la recepción de mensajes y SMTP para el envío. Esta modalidad es compatible con proveedores como Hostinger, Microsoft 365, Zoho y cualquier servidor de correo personalizado. Una vez configurado, el cronDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/banredco/helpdesk/llms.txt
Use this file to discover all available pages before exploring further.
process-imap.php consulta periódicamente el buzón en busca de mensajes no leídos y los convierte en tickets automáticamente.
Configurar un buzón IMAP/SMTP
Acceder al formulario de creación
Ve a Admin → Configuración → Correos y haz clic en el botón Nuevo Correo en la esquina superior derecha.
Seleccionar tipo de conexión
En el campo Tipo de conexión, selecciona IMAP / SMTP. El formulario mostrará automáticamente los campos de configuración de servidor de entrada y salida. Si seleccionas “Google Workspace”, esos campos quedan ocultos.
Completar la información general
Rellena los campos de identificación del buzón:
| Campo | Descripción | Ejemplo |
|---|---|---|
Nombre del buzón (name) | Identificador interno visible solo para los agentes | Servicio al Cliente |
Correo electrónico (email) | La dirección de la cuenta que se va a conectar | soporte@tuempresa.com |
Nombre remitente (sender_name) | Nombre que verá el cliente al recibir un email | Banred Soporte |
Reply-To (reply_to_email) | Dirección a la que responderán los clientes si es diferente al buzón | soporte@tuempresa.com |
Grupo asignado (group_id) | Grupo de agentes al que se asignarán los nuevos tickets de este buzón | Nivel 1 |
Configurar el servidor IMAP (entrada)
El servidor IMAP es el que recibe los correos de los clientes. El cron usa
imap_open() para conectarse y imap_search('UNSEEN') para recuperar solo los mensajes no leídos.| Campo | Valor típico | Descripción |
|---|---|---|
Servidor IMAP (imap_host) | imap.tuproveedor.com | Hostname del servidor de correo entrante |
Puerto (imap_port) | 993 | Puerto estándar para IMAP con SSL/TLS |
Seguridad (imap_encryption) | ssl | Selecciona ssl para el puerto 993 o tls para el 143 |
Usuario (imap_username) | soporte@tuempresa.com | Generalmente es la misma dirección de correo |
Contraseña (imap_password) | •••••••• | Contraseña de la cuenta o contraseña de aplicación |
Configurar el servidor SMTP (salida)
El servidor SMTP es el que envía los correos de respuesta a los clientes. El helpdesk usa PHPMailer con autenticación SMTP para el envío.
| Campo | Valor típico | Descripción |
|---|---|---|
Servidor SMTP (smtp_host) | smtp.tuproveedor.com | Hostname del servidor de correo saliente |
Puerto (smtp_port) | 587 | Puerto estándar para SMTP con STARTTLS |
Seguridad (smtp_encryption) | tls | Usa tls para el puerto 587 o ssl para el 465 |
Usuario (smtp_username) | soporte@tuempresa.com | Usuario de autenticación SMTP |
Contraseña (smtp_password) | •••••••• | Contraseña de la cuenta o contraseña de aplicación |
Configurar las opciones del buzón
En la sección Opciones encontrarás dos casillas:
- Crear tickets automáticamente (
create_tickets): cuando está marcada, el cron IMAP procesará los correos entrantes y creará tickets. Si la desactivas, el buzón solo se usará para envío. - Correo predeterminado del sistema (
is_default): marca esta opción si quieres que este buzón se use cuando un ticket no tiene un buzón asignado específicamente. Al marcar esta casilla, el sistema desmarcará el buzón predeterminado anterior de forma automática.
Proveedores populares
Referencia rápida de servidores para los proveedores más utilizados:| Proveedor | Servidor IMAP | Puerto IMAP | Servidor SMTP | Puerto SMTP |
|---|---|---|---|---|
| Gmail (con contraseña de app) | imap.gmail.com | 993 | smtp.gmail.com | 587 |
| Hostinger | imap.hostinger.com | 993 | smtp.hostinger.com | 587 |
| Microsoft 365 | outlook.office365.com | 993 | smtp.office365.com | 587 |
Para Gmail, se recomienda usar la integración nativa con Google Workspace en lugar de IMAP. Consulta la guía de Gmail / Google Workspace para más detalles.
Probar la conexión
El botón de prueba ejecutamailbox-test.php, que realiza dos verificaciones independientes y muestra el resultado en pantalla:
-
Prueba IMAP: intenta abrir una conexión al servidor IMAP con las credenciales guardadas usando
imap_open(). Si la conexión es exitosa, muestra✅ IMAP OK; de lo contrario,❌ IMAP ERROR. -
Prueba SMTP: instancia PHPMailer e intenta
smtpConnect()con el servidor y credenciales configuradas. Si la conexión es exitosa, muestra✅ SMTP OK; de lo contrario,❌ SMTP ERROR.
Sincronización manual
El cron automático se ejecuta según el intervalo configurado en el servidor. Si necesitas importar correos de inmediato, ve a Admin → Configuración → Correos y haz clic en el botón Sincronizar. Esto invocaadmin/mail-sync.php, que ejecuta tanto cron/process-gmail.php como cron/process-imap.php de forma síncrona y retorna una respuesta JSON indicando si se crearon tickets nuevos: