Para qué sirve#
Aquí conectas las cuentas de correo de tu empresa (por ejemplo, soporte@ o ventas@) para que los correos que llegan a ellas aparezcan en Correo electrónico, donde tu equipo los recibe, reserva y responde. Puedes conectar varios buzones.
Quién puede usarlo y cómo llegar#
- Solo administradores.
- Cómo llegar: Configuración → Correo electrónico (pestaña Correo electrónico). Esta sección aparece solo si el módulo está activo en Configuración → Configuración general → Preferencias. Si está apagado, la pantalla dice «El módulo Correo electrónico está desactivado. Actívalo en Preferencias para configurarlo.» con un enlace a Preferencias.
La tabla de buzones#
| Columna | Qué muestra |
|---|---|
| Nombre | El nombre con el que reconoces el buzón. |
| Correo | La dirección del buzón. |
| Lectura | El método: IMAP o API. |
| Última actualización | La última vez que el sistema revisó el buzón en busca de correos nuevos (dd/mm/aaaa hh:mm), o «—» si todavía no lo hizo. Se actualiza sola. |
| Estado | ACTIVO (se revisa y descarga) o INACTIVO (queda guardado pero no se lee). |
| Acciones | Enchufe: Probar conexión. Lápiz: Editar. Papelera: Eliminar (pide confirmación: «¿Eliminar el buzón NOMBRE?»). |
Si no hay buzones, la tabla dice «Todavía no hay buzones conectados.».
Agregar o editar un buzón#
Pulsa Agregar buzón. Los campos comunes son:
| Campo | Qué hace | Límites | Por defecto |
|---|---|---|---|
| Nombre | Nombre para reconocer el buzón (por ejemplo, «Soporte»). | Hasta 120 caracteres | Vacío |
| Correo | Dirección del buzón. Debe ser válida y no estar repetida. | Hasta 200 caracteres | Vacío |
| Lectura por | IMAP o API. | — | IMAP |
Un buzón nuevo se crea activo.
Lectura por IMAP#
Pide a quien administra tu correo el servidor, el puerto, la seguridad, el usuario y la contraseña. Con Gmail u Outlook usa una contraseña de aplicación.
| Campo | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Servidor IMAP | Dirección del servidor (ej. imap.miempresa.com). Obligatorio. | Hasta 200 caracteres | Vacío |
| Puerto | Puerto de conexión. | 1 a 65535 | 993 |
| Seguridad | Cifrado de la conexión. | SSL/TLS, STARTTLS, Ninguna | SSL/TLS |
| Usuario | Usuario del buzón. Obligatorio. | Hasta 200 caracteres | Vacío |
| Contraseña | Obligatoria al crear. Al editar, déjala vacía para conservar la guardada. | Hasta 500 caracteres | Vacío |
| Carpeta | Carpeta del buzón a revisar. | Hasta 100 caracteres | INBOX |
Lectura por API#
Primero eliges el Proveedor: Gmail (por defecto), Outlook / Microsoft (empresa u Hotmail), Zoho Mail u Otro. Según el proveedor se muestran estos campos:
| Campo | Gmail | Microsoft | Zoho | Otro |
|---|---|---|---|---|
URL de la API (debe empezar por https://) | — | — | — | Sí |
| Tipo de cuenta (Microsoft 365 (empresa o colegio) por defecto, o Personal (Outlook.com / Hotmail)) | — | Sí | — | — |
| ID de directorio (inquilino) | — | Solo empresa | — | — |
| ID de cliente | Sí | Sí | Sí | — |
Centro de datos (.com por defecto; .eu, .in, .com.au, .jp) | — | — | Sí | — |
| Secreto de cliente | Sí | Sí | Sí | — |
| Token de actualización | Sí | Solo personal | Sí | — |
| Token o clave | — | — | — | Sí |
Los secretos se guardan cifrados. Al editar un buzón, los campos secretos muestran «Guardado — escribe uno nuevo para cambiarlo»; si los dejas vacíos se conserva lo guardado.
Autorización automática (recomendada)#
Para Gmail, Zoho y Microsoft personal aparece el botón Guardar y autorizar con Google / Zoho / Microsoft. Antes de usarlo debes registrar en tu aplicación del proveedor el URI de redireccionamiento que muestra la pantalla (tiene la forma https://tu-dominio/api/correo_oauth.php; es el mismo para todos).
- Llena nombre, correo, ID de cliente y secreto de cliente (y, en Zoho, el centro de datos).
- Pulsa Guardar y autorizar con…. Connecto guarda el buzón y te lleva a la pantalla del proveedor.
- Inicia sesión con la cuenta del buzón y acepta los permisos de lectura y envío.
- Vuelves a Connecto con un mensaje: «Buzón autorizado» (o «Autorizado, pero la prueba falló», con el motivo). Con el botón Volver a Configuración regresas a la lista.
Mientras no llegue el token, el buzón queda INACTIVO; al autorizar con éxito, queda ACTIVO automáticamente. La autorización caduca a los 15 minutos si no se completa.
La pantalla incluye, bajo el formulario, una guía paso a paso para cada proveedor. En resumen:
| Proveedor | Qué debes crear | Permisos |
|---|---|---|
| Gmail | Un proyecto en Google Cloud Console con Gmail API activada, pantalla de consentimiento OAuth y un ID de cliente de OAuth de tipo «Aplicación web». | Alcances gmail.readonly (leer) y gmail.send (enviar y responder). |
| Microsoft 365 (empresa) | Un registro de aplicación en Microsoft Entra con un secreto de cliente. Copia el ID de aplicación y el ID de directorio. | Permisos de aplicación de Microsoft Graph Mail.Read y Mail.Send con consentimiento de administrador. Se recomienda limitar la aplicación a los buzones necesarios. |
| Microsoft personal | Un registro de aplicación que acepte cuentas personales, con URI de redirección «Web» y secreto de cliente. | Permisos delegados Mail.Read, Mail.Send y offline_access. |
| Zoho Mail | Un cliente «Server-based Applications» (o «Self Client») en la consola de API de Zoho, en el centro de datos de tu cuenta. | Alcances ZohoMail.messages.READ, ZohoMail.messages.CREATE, ZohoMail.accounts.READ y ZohoMail.folders.READ. |
| Otro | Una clave o token de acceso desde el panel de tu proveedor. | Solo lectura de mensajes. |
Probar la conexión#
Hay dos pruebas:
- Desde el formulario: el botón de abajo es Probar conexión. Prueba lo que escribiste sin guardar nada. Muestra «Probando la conexión» y, al terminar:
- Conexión exitosa → botón Guardar, que guarda el buzón y recarga la página.
- No se pudo conectar o Revisa los datos → botón Aceptar, que vuelve al formulario.
- Desde la tabla: el enchufe prueba un buzón ya guardado y muestra el resultado en un cuadro «Probar conexión».
Mensajes que puedes ver, entre otros:
| Proveedor | Mensaje |
|---|---|
| IMAP | «Conexión exitosa: inicio de sesión correcto y carpeta «INBOX» disponible.»; «No se pudo conectar a servidor:puerto…»; «El servidor rechazó el usuario o la contraseña. Con Gmail u Outlook usa una contraseña de aplicación.»; «…la carpeta «X» no existe o no se puede abrir.» |
| Gmail | «Conexión exitosa con Gmail: dirección.» y los permisos detectados («Permisos: leer y enviar correos.»). Si el token solo permite leer: «ATENCIÓN: esta autorización solo permite LEER…». Si el token es de otra cuenta: «Ojo: el token pertenece a … y este buzón está registrado como …». |
| Microsoft | «Conexión exitosa con Microsoft 365…» o «…con la cuenta personal de Microsoft…», con aviso si falta el permiso Mail.Send. |
| Zoho | «Conexión exitosa con Zoho Mail.» y aviso si falta ZohoMail.messages.CREATE. |
| Otro | «La API respondió correctamente (HTTP 200).»; «La URL de la API debe empezar por https://.» |
Errores al guardar#
| Situación | Mensaje |
|---|---|
| Sin nombre | «Escribe un nombre para el buzón.» |
| Correo inválido | «Escribe un correo válido.» |
| Correo repetido | «Ya hay un buzón configurado con ese correo.» |
| IMAP sin servidor, usuario o con puerto fuera de rango | «Escribe el servidor IMAP.» / «Escribe el usuario del buzón.» / «El puerto debe estar entre 1 y 65535.» |
| IMAP sin contraseña | «Escribe la contraseña.» |
| API: faltan ID de cliente, secreto o token | Un mensaje que nombra el dato faltante, por ejemplo «Escribe el ID de cliente (Client ID) de Google.» o «Escribe el token de actualización de Google, o usa «Guardar y autorizar con Google».» |
| Microsoft empresa sin inquilino | «Escribe el ID de directorio (inquilino) de Microsoft.» |
| Zoho sin centro de datos válido | «Elige el centro de datos de Zoho.» |
| Otro sin URL o sin token | «Escribe la URL de la API.» / «Escribe el token o la clave de la API.» |
Cómo se sincronizan los correos#
- El sistema revisa los buzones activos de Gmail, Microsoft y Zoho cada 2 minutos mientras alguien usa Connecto, y al pulsar Sincronizar en la bandeja.
- En cada vuelta descarga hasta 20 correos nuevos; los demás quedan pendientes para la vuelta siguiente.
- Cada correo se descarga una sola vez, se asocia a un contacto y se clasifica en una carpeta. Ver Clasificación y bandejas.
- El estado leído/no leído inicial se toma del buzón.
- Los adjuntos no se guardan: se piden al proveedor cuando alguien abre el correo.
- Si hay un error con un buzón (credenciales vencidas, límite de uso del proveedor, permisos), la pantalla de correo muestra el aviso con el nombre del buzón. Usa Probar conexión para diagnosticar.
Eliminar un buzón#
La papelera elimina el buzón de la lista. Los correos ya descargados de ese buzón pueden verse afectados; el código no lo deja claro.
<!-- Fuente: tenant-app/views/partials/cfg_correo.php, tenant-app/views/partials/cfg_preferencias_post.php, tenant-app/public/api/correo_oauth.php, shared/src/Core/BuzonTest.php, shared/src/Core/CorreoSync.php, shared/src/Core/CorreoApi.php, shared/src/Core/CorreoMicrosoft.php, shared/src/Core/CorreoZoho.php, shared/src/Core/CorreoEnvio.php, shared/src/Core/CorreoAdjuntos.php -->