Crear y gestionar credenciales SMTP
Una credencial SMTP es un usuario y contraseña que le permiten conectar su propio software de envío (su aplicación, su librería de correo, su CRM) directamente al servidor de relay SMTP de Fidelizador, en lugar de usar la API HTTP. Sirve para integraciones que ya hablan el protocolo SMTP estándar y no necesitan (o no pueden) hacer llamadas HTTP.
Cada credencial queda asociada a un único dominio habilitado de su cuenta: todo correo enviado con esa credencial usa ese dominio como remitente.
Antes de empezar
Es necesario:
- Tener al menos un dominio habilitado (los cuatro indicadores MX, SPF, DKIM y DMARC en
verified). Si aún no es el caso, siga primero Configurar un dominio de envío. - Tener acceso a la sección Configuración → Credenciales SMTP del panel. Cualquier usuario con un asiento en la instancia puede ver el listado de credenciales; crear, editar o revocar requiere un asiento con rol Administrador dentro de la aplicación de correo — con un rol de asiento inferior esos botones no aparecen y debe pedir a un administrador de la instancia que realice la acción.
Crear una credencial SMTP
- Acceda al panel y abra Configuración → Credenciales SMTP.
- Pulse Crear.
- Complete los campos:
- Dominio (obligatorio): elija de la lista. Solo aparecen los dominios habilitados de su instancia.
- Lista blanca de IPs (opcional): una IP o rango CIDR por línea (IPv4 o IPv6). Si la deja vacía, la credencial acepta conexiones desde cualquier IP.
- Pulse Crear.
El usuario de la credencial lo genera automáticamente la plataforma (combina su instancia, un identificador de la credencial y el dominio elegido) y no se puede elegir ni editar. La contraseña también la genera la plataforma — no se puede definir una propia.
Guardar la contraseña
Al crear la credencial, el panel muestra una sola vez el usuario, el dominio y la contraseña completa, con un botón para copiar la contraseña. Este es el único momento en que la contraseña completa está disponible:
Esta es la única vez que podrá ver la contraseña completa. Cópiela y guárdela en un lugar seguro antes de cerrar esta ventana.
Si cierra la ventana sin copiarla, la contraseña no se puede recuperar después por ningún medio — ni desde el panel ni pidiéndola a soporte, porque la plataforma solo almacena su huella (hash), nunca el valor en texto plano. La única forma de obtener una contraseña nueva es crear otra credencial.
Configurar su software de envío
Con el usuario y la contraseña de la credencial, configure su cliente SMTP con estos parámetros de conexión:
| Parámetro | Valor |
|---|---|
| Host | El host de relay SMTP de su cuenta (patrón <dc>relay.<su-dominio-de-plataforma>, por ejemplo cl1relay.fidelizador.com; confirme el valor exacto con soporte si tiene dudas) |
Puerto 587 | Submission con STARTTLS — conexión sin cifrar que se actualiza a TLS, más el usuario y contraseña de la credencial |
Puerto 465 | SMTPS con TLS implícito — conexión cifrada desde el inicio, más el usuario y contraseña de la credencial |
| Usuario | El usuario mostrado al crear la credencial |
| Contraseña | La contraseña mostrada (una sola vez) al crear la credencial |
Use el puerto que su software soporte: 587 (STARTTLS) es el más común; 465 (TLS implícito) es una alternativa equivalente para clientes que solo soportan ese modo. Ambos puertos exigen autenticación con la credencial — no existe un puerto SMTP sin autenticación.
Restringir por IP
Si al crear la credencial definió una lista blanca de IPs, solo las conexiones que provengan de esas IPs o rangos serán aceptadas; cualquier otra conexión con el mismo usuario y contraseña será rechazada. Es un control adicional para limitar desde dónde se puede usar la credencial, útil cuando su software de envío corre desde una o pocas direcciones fijas conocidas.
Editar una credencial
Desde la pantalla de credenciales puede editar una credencial existente, pero solo la lista blanca de IPs es editable. El usuario, el dominio y la contraseña no se pueden modificar una vez creada la credencial — si necesita cambiarlos, debe revocar la credencial y crear una nueva.
Revocar una credencial
Desde la pantalla de credenciales puede revocar una credencial activa. Efectos:
- Deja de autenticar envíos de inmediato: cualquier sistema que la use no podrá seguir enviando.
- Queda registrada en el listado con estado Revocada, para auditoría.
La revocación no es reversible: una vez revocada, la única forma de volver a enviar por SMTP con ese dominio es crear una credencial nueva (con una contraseña nueva).
Dudas frecuentes
¿Puedo recuperar la contraseña de una credencial ya creada?
No. Solo se muestra una vez, al momento de crearla. Si la perdió, cree una credencial nueva.
¿Puedo cambiar el dominio de una credencial?
No. El dominio (igual que el usuario) queda fijo desde la creación; para usar otro dominio cree una credencial nueva.
¿Qué pasa si el dominio de una credencial pierde la validación DNS?
La credencial queda asociada a un dominio que ya no está habilitado; revísela y corrija la validación del dominio en Configurar un dominio de envío.
¿Puedo usar la misma credencial para enviar desde varios dominios?
No. Cada credencial SMTP está atada a un único dominio.
¿Necesito configurar algo distinto si mi software solo soporta un puerto?
No — use el puerto que soporte (587 con STARTTLS o 465 con TLS implícito); ambos aceptan la misma credencial.
Más preguntas en Preguntas frecuentes.