Para qué sirve#
El SMTP es el servidor desde el que Connecto envía los correos del sistema y los de difusiones y pruebas de templates. Es distinto de los buzones de Conectar buzones: los buzones sirven para leer y responder correos de clientes en la pantalla de Correo electrónico; el SMTP sirve para los envíos automáticos y masivos.
Cada tipo de envío (llamado categoría) usa la conexión SMTP que le asignes:
| Categoría | Para qué se usa |
|---|---|
| Notificaciones a usuarios de sistema | Correos como «Tu cuenta fue creada: datos de conexión», «Tu cuenta fue habilitada / inhabilitada» y «Tu contraseña fue actualizada», y el informe semanal del equipo. |
| Campañas de correo masivo | Difusiones por correo, el botón Enviar prueba del editor de templates, los correos de confirmación de suscripción de los formularios y los correos automáticos de las acciones de oportunidades. |
Quién puede usarlo y cómo llegar#
- Cómo llegar: Configuración → Configuración general → pestaña SMTP. Título de la pantalla: «Conexiones SMTP».
- Ver la lista: quienes entran a esa pantalla. Agregar, eliminar y asignar categorías: solo administradores («Solo un administrador puede modificar la configuración de correo SMTP.»).
La tabla de conexiones#
| Columna | Qué muestra |
|---|---|
| Nombre | El nombre de la conexión. |
| Servidor | servidor:puerto. |
| Usuario | El usuario de autenticación. |
| Remitente | El correo desde el que se envía. |
| Seguridad | TLS, SSL o NINGUNA. |
| Estado | ● Activa u ○ Inactiva. |
| Categorías que envía | Una casilla por cada categoría. Marcarla asigna esa categoría a la conexión. |
| Botón Eliminar | Elimina la conexión (solo administradores). |
Cada categoría puede estar asignada a una sola conexión a la vez. Si ya la tiene otra, su casilla aparece atenuada («Ya asignada a otra conexión»); desmárcala allá primero. Para los no administradores las casillas están desactivadas. Al marcar o desmarcar, la página se recarga y aparece «Asignación actualizada.».
Si no hay conexiones: «Todavía no hay ninguna conexión SMTP configurada.».
Agregar una conexión#
Pulsa Agregar conexión y completa «Agregar conexión SMTP»:
| Campo | Qué hace | Valores / límites | Por defecto |
|---|---|---|---|
| Nombre de la conexión | Para reconocerla (ej. «Gmail transaccional»). Obligatorio. | Hasta 120 caracteres | Vacío |
| Seguridad | Cómo se cifra la conexión. | STARTTLS (587), SSL/TLS implícito (465), Ninguna (solo para pruebas locales) | STARTTLS (587) |
| Servidor (host) | Dirección del servidor (ej. smtp.gmail.com). Obligatorio. | Hasta 200 caracteres | Vacío |
| Puerto | Puerto del servidor. | Número | 587 |
| Usuario | Usuario de autenticación. Obligatorio. | Hasta 200 caracteres | Vacío |
| Contraseña | Obligatoria al crear. Se guarda cifrada. | — | Vacío |
| Correo remitente | Dirección desde la que se envía. Obligatoria y válida. | Hasta 200 caracteres | Vacío |
| Nombre del remitente | Nombre que ve quien recibe (ej. «Mi Empresa»). | Hasta 150 caracteres | Vacío |
| Conexión activa | Solo las conexiones activas se usan para enviar. | Casilla | Marcada |
Pulsa Guardar conexión. Mensajes: «Conexión SMTP creada.»; «Completa nombre, host, usuario y un correo de remitente válido.»; «La contraseña es obligatoria para una conexión nueva.».
Paso a paso#
- Pide a quien administra tu correo el servidor, el puerto, el tipo de seguridad, el usuario y la contraseña. Con Gmail u Outlook suele hacer falta una contraseña de aplicación.
- Pulsa Agregar conexión y llena los campos.
- Guarda.
- Marca en la tabla las categorías que enviarán por esta conexión.
- Comprueba: en el editor de templates pulsa Enviar prueba y revisa que te llegue el correo.
Eliminar una conexión#
Pulsa Eliminar y confirma: «¿Eliminar la conexión SMTP «Nombre»? Las categorías que tenía asignadas quedarán sin conexión.» → Sí, eliminar. Aviso «Conexión SMTP eliminada. Sus categorías quedaron sin conexión asignada.».
Reglas y comportamientos#
- La pantalla no tiene botón para editar una conexión ni para probarla. Si cambias de contraseña o de servidor, elimina la conexión y créala de nuevo (y vuelve a asignar sus categorías).
- El sistema se autentica con usuario y contraseña (método AUTH LOGIN, el que aceptan la mayoría de los proveedores) y espera hasta 10 segundos al conectarse.
- Los correos salen en formato HTML.
- Los mensajes de error de un envío incluyen la causa, por ejemplo «No se pudo conectar a servidor:puerto…», «Autenticación SMTP rechazada…» o «El servidor rechazó el destinatario.».
<!-- Fuente: tenant-app/public/configuracion/index.php, shared/src/Core/SmtpMailer.php, tenant-app/public/api/correo_editor.php, db/migrations/0024_smtp_config.sql, db/migrations/0030_campanas_correo.sql -->