Enviar su primer correo
Para todos los usuarios
Fidelizador no compone ni dispara correos por su cuenta: el envío lo hace su sistema, llamando a la plataforma. Esta guía muestra ese primer envío por los dos caminos disponibles, con un ejemplo que se puede copiar y ejecutar tal cual.
Antes de empezar
Es necesario tener resueltos los pasos anteriores de Primeros pasos:
- Un dominio habilitado (los cuatro indicadores DNS en
verificado) — ver Configurar un dominio de envío. - Un remitente creado sobre ese dominio — ver Crear y gestionar remitentes.
- Una credencial, del tipo que corresponda al camino que elija en la sección siguiente.
Elegir el camino
Los dos caminos entregan al mismo sistema y producen los mismos reportes. La diferencia es cómo habla su sistema con la plataforma:
| API (HTTP) | SMTP | |
|---|---|---|
| Cuándo conviene | Está escribiendo la integración ahora, o quiere adjuntos, plantillas guardadas y confirmación inmediata del identificador del mensaje | Su software ya envía correo por SMTP (un WordPress, un ERP, un CRM) y solo hay que apuntarlo a otro servidor |
| Qué configura | Llamadas HTTP con una API key | Host, puerto, usuario y contraseña de una credencial SMTP |
| Hay que programar | Sí | No, si su software ya tiene la pantalla de configuración SMTP |
Si su software ya envía por SMTP, empiece por ahí: es el camino sin código.
Enviar por API
Necesita una API key con permiso de envío. Los ejemplos usan tres valores de su cuenta:
export API_HOST=cl2api.fidelizador.com
export API_KEY=FD.<key_id>.<token> # la credencial API, mostrada una sola vez al crearla
export SLUG=<su-slug> # el identificador de su instancia
El envío es una llamada:
curl -X POST "https://$API_HOST/v1/mails/send" \
-H "Authorization: Bearer $API_KEY" \
-H "X-Instance-Slug: $SLUG" \
-H "Content-Type: application/json" \
-d '{
"sender_email": "[email protected]",
"to": [{ "email": "[email protected]", "name": "Nombre" }],
"subject": "Su pedido fue confirmado",
"html": "<p>Su pedido fue confirmado.</p>"
}'
Una respuesta 200 significa que el correo fue aceptado, e incluye el identificador del mensaje. La entrega ocurre después: su estado se consulta en el panel o por la API, no en la respuesta del envío.
Si en el paso anterior creó una plantilla, se referencia con template_id en lugar de subject y html — ver Plantillas y contenido.
Referencia completa del envío, con todos los campos, límites y errores: POST /v1/mails/send.
Enviar por SMTP
Necesita una credencial SMTP. Los parámetros de conexión son los mismos que pondría en cualquier cliente de correo:
| Parámetro | Valor |
|---|---|
| Host | cl2relay.fidelizador.com |
| Puerto | 587 (STARTTLS) o 465 (TLS implícito) |
| Usuario | El usuario mostrado al crear la credencial |
| Contraseña | La contraseña mostrada (una sola vez) al crear la credencial |
Antes de tocar la configuración de su software, conviene comprobar la credencial sola. Con swaks, en una línea:
swaks --to [email protected] \
--from [email protected] \
--server cl2relay.fidelizador.com:587 \
--tls --auth -au "<usuario>" -ap "<contraseña>" \
--header "Subject: Prueba de credencial"
Un 250 final significa que el correo fue aceptado. Si en cambio recibe 550 5.7.1 Access denied, revise usuario, contraseña, si la credencial está revocada y la lista de IPs permitidas — el servidor devuelve el mismo error para los cuatro casos, a propósito.
Con la credencial comprobada, configúrela en su software. Si en cambio está escribiendo el código, el envío desde Python son unas pocas líneas: ver Enviar HTML desde Python.
Detalle completo del camino SMTP —opciones por header, límites y diferencias con la API—: Envío por SMTP.
Comprobar el resultado
Un envío aceptado no es todavía un correo entregado. Para seguirlo:
- El panel principal muestra la actividad reciente.
- El Seguimiento de Correo permite buscar un correo puntual y ver su recorrido — es la vista para diagnosticar un envío que no llegó.
- La actividad de envíos lista entregas, aperturas, clics y rebotes.
Si quiere probar sin llegar a un destinatario real, la plataforma tiene un entorno de pruebas que simula respuestas del mercado (entregas, rebotes, quejas) sin que el correo salga: ver Sandbox.
Comprobar la cuenta conversando con un agente
Existe además un servidor MCP que permite pedirle a un asistente de IA que envíe un correo de prueba y consulte los reportes, en lenguaje natural y sin escribir código. Sirve para comprobar que la cuenta envía antes de integrar nada.
No es una vía de integración: se autentica con la identidad de un usuario, así que necesita que una persona inicie sesión y no sirve para que un sistema envíe de forma desatendida. Para eso son los dos caminos de arriba.
Dudas frecuentes
¿Puedo usar la misma credencial para los dos caminos?
No. Una API key sirve para las llamadas HTTP y una credencial SMTP para el relay; son credenciales distintas y se crean por separado.
¿El correo se envía en el momento?
Sí. La plataforma no retiene el correo para enviarlo después: sale en cuanto se acepta. Si necesita que salga en un horario determinado, programe la llamada en su sistema.
¿Puedo enviar a varios destinatarios en una sola llamada?
Sí, to acepta varios. Ver los límites del envío.
¿Por qué mi envío fue rechazado con un error de remitente?
El remitente debe corresponder a un remitente registrado sobre un dominio habilitado, y coincidir exactamente con el que creó. Ver Crear y gestionar remitentes.