Para qué sirve#
Aquí registras el servidor de correo (SMTP) desde el que Connecto envía los correos del sistema: la contraseña de un agente nuevo, los avisos de habilitar o inhabilitar una cuenta, el informe semanal del equipo y las campañas de correo masivo. Sin una conexión SMTP asignada, esos correos no salen.
Quién puede usarlo y cómo llegar#
- Solo administradores.
- Avatar → Ajustes de sistema → Configuración general → pestaña SMTP.
Conceptos#
- Conexión SMTP: los datos de un servidor de correo (servidor, puerto, usuario, contraseña, remitente). Puedes registrar varias.
- Categoría de envío: el tipo de correo que se manda. Cada categoría se envía por una sola conexión a la vez, y una conexión puede enviar varias categorías.
Las categorías que existen son:
| Categoría | Qué correos envía |
|---|---|
| Notificaciones a usuarios de sistema | Contraseña de un agente nuevo, restablecimiento de acceso, aviso de cuenta habilitada o inhabilitada, aviso de cambio de contraseña, informe semanal del equipo |
| Campañas de correo masivo | Los correos de las difusiones por correo electrónico (incluidos los correos de prueba y los de confirmación de suscripción) |
La tabla de conexiones#
Cada fila muestra:
| Columna | Qué muestra |
|---|---|
| Nombre | El nombre que le diste |
| Servidor | host:puerto |
| Usuario | El usuario de autenticación |
| Remitente | El correo que aparece como remitente |
| Seguridad | TLS, SSL o NINGUNA |
| Estado | «● Activa» o «○ Inactiva» |
| Categorías que envía | Una casilla por categoría |
| Botón Eliminar | Quita la conexión |
Si todavía no hay ninguna, verás «Todavía no hay ninguna conexión SMTP configurada.».
Agregar una conexión#
- Haz clic en Agregar conexión.
- Completa la ventana (tabla de abajo).
- Haz clic en Guardar conexión. Aparece «Conexión SMTP creada.».
- En la tabla, marca las categorías que enviará esa conexión.
| Campo | Obligatorio | Detalle |
|---|---|---|
| Nombre de la conexión | Sí | Por ejemplo «Gmail transaccional». Máximo 120 caracteres |
| Seguridad | — | STARTTLS (587) (por defecto), SSL/TLS implícito (465) o Ninguna |
| Servidor (host) | Sí | Por ejemplo smtp.gmail.com |
| Puerto | Sí | 587 por defecto |
| Usuario | Sí | Por ejemplo [email protected] |
| Contraseña | Sí | Se guarda cifrada y no se vuelve a mostrar |
| Correo remitente | Sí | Debe ser un correo válido |
| Nombre del remitente | No | Ejemplo: el nombre de tu empresa |
| Conexión activa | — | Casilla, marcada por defecto |
Si falta algo: «Completa nombre, host, usuario y un correo de remitente válido.».
Asignar categorías a una conexión#
En la columna Categorías que envía marca o desmarca cada categoría. El cambio se guarda al instante y la página se recarga.
- Una categoría que ya está asignada a otra conexión aparece atenuada y bloqueada («Ya asignada a otra conexión»). Para pasarla, primero desmárcala en la otra.
- Si desmarcas una categoría, queda sin conexión y esos correos no salen hasta que le asignes otra.
Eliminar una conexión#
Botón Eliminar → confirmación «¿Eliminar la conexión SMTP «…»? Las categorías que tenía asignadas quedarán sin conexión.» → «Sí, eliminar». Aparece «Conexión SMTP eliminada. Sus categorías quedaron sin conexión asignada.».
Qué pasa cuando no hay conexión#
- Crear un agente (u otras acciones con correo) sí se realiza; solo cambia el aviso: «… no se pudo enviar el correo (No hay una conexión SMTP configurada (o activa) para esta categoría de envío.)». En el caso de la contraseña temporal, esta se muestra en pantalla.
- El informe semanal del equipo y los correos de difusión no salen.
Reglas técnicas que conviene saber#
- Se usa autenticación AUTH LOGIN, que aceptan la mayoría de proveedores (Gmail, Outlook, SES…).
- El tiempo de espera para conectar es de 10 segundos.
- «Ninguna» seguridad es solo para pruebas locales.
- Los correos salen en formato HTML.
<!-- Fuente: tenant-app/public/configuracion/index.php (acciones smtp_guardar, smtp_eliminar, smtp_categoria_asignar; pestaña smtp), shared/src/Core/SmtpMailer.php, shared/src/Core/Secrets.php, db/migrations/0024_smtp_config.sql, db/migrations/0030_campanas_correo.sql -->
Cómo se arma el correo que sale#
Para que Gmail y Outlook lo acepten bien, cada correo sale con un Message-ID propio, en dos versiones (texto y HTML) y con el contenido codificado en líneas cortas (quoted-printable). Esto último evita que un servidor de correo con firma DKIM parta líneas largas después de firmar y la firma deje de verificar.