Enviar su primer correo
Para administradores e integradores
Envíe su primer correo por API o SMTP, con ejemplos listos para copiar. Los envíos reales los solicita su sistema. Desde el panel se configura y supervisa el servicio.
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
Elija el camino según cómo envía hoy su sistema:
- «Mi programa ya envía por SMTP» (un WordPress, un ERP, un CRM) → Enviar por SMTP. Es el camino sin código.
- «Tengo apoyo de un desarrollador o usaré la API» → Enviar por API.
Si solo quiere comprobar que la cuenta envía, sin integrar nada, puede hacerlo conversando con un agente de IA.
Los dos caminos usan la misma plataforma de envío y producen los mismos reportes. La diferencia es cómo se comunica 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 |
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=<su-api-key> # se muestra 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 ya tiene una plantilla guardada, use 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 habituales de 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 configurar su software, pruebe la credencial por separado. Con swaks puede hacerlo con un solo comando:
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 recibe 550 5.7.1 Access denied, el servidor no indica la causa. Revise:
- el usuario y la contraseña,
- que la credencial no esté revocada,
- la lista de IPs permitidas.
Después de probar la credencial, configúrela en su software. Si desarrolla su propia integración, consulte Enviar HTML desde Python.
Las opciones de encabezado, los límites y las diferencias con la API se detallan en Envío por SMTP.
Agregar enlaces de baja, abuso y ver en el navegador
Si arma su propio HTML y lo envía por API o SMTP sin pasar por el editor de plantillas, escriba estos enlaces con un href fijo. Al enviar, la plataforma cambia cada uno por un enlace propio de cada destinatario:
<a href="fide:unsubscribe">Darse de baja</a>
<a href="fide:complaint">Reportar abuso</a>
<a href="fide:browser-view">Ver en el navegador</a>
- Funcionan en cualquier enlace del correo: texto, botones e imágenes, también en Outlook de escritorio.
- En la versión de texto plano, escriba el token solo:
Darse de baja: fide:unsubscribe. Si no envía versión de texto plano, la plataforma la genera a partir del HTML y conserva los enlaces. - Escriba el token exacto, sin agregar nada. Un error de tipeo (
fide:unsuscribe) o un parámetro (fide:unsubscribe?lang=es) deja el enlace sin destino en el correo enviado. - Si su HTML viene de la plataforma anterior de Fidelizador, los enlaces marcados con una clase (
class="fide-remove-subscriber",class="fide-complaint",class="fide-browser-view") ya no se reconocen: se envían como un enlace normal. Reemplácelos por suhrefequivalente, por ejemplo<a href="fide:unsubscribe">.
Antes de enviar a sus contactos, haga un envío de prueba. Abra cada enlace. En la vista previa de una plantilla los enlaces no responden al clic, así que no sirve para probarlos.
Si un enlace no abre ninguna página, descargue el respaldo .eml desde Seguimiento de Correo. Un enlace reconocido apunta a una dirección de la plataforma. Uno sin destino indica que el token no se reconoció. Los tipos de enlace especial están en Enlaces especiales.
Enviar a varios destinatarios
Ambos caminos aceptan varios destinatarios en un mismo envío. Cada destinatario recibe su propia copia, con un identificador y una fila propios en los reportes.
Por API, to acepta varias direcciones. También puede usar cc y bcc:
{
"to": [
],
"subject": "Su pedido fue confirmado",
"html": "<p>Su pedido fue confirmado.</p>"
}
Por SMTP, indique Para y CC en los encabezados del mensaje. Indique CCO solo en la entrega. Consulte Varios destinatarios.
Qué ve cada destinatario, por los dos caminos:
- Para (
to) y CC (cc) quedan a la vista de todos. El mensaje se arma una vez con esas direcciones en el header. Después se entrega así a cada destinatario. - CCO (
bcc) no es visible para nadie. Se quita del mensaje antes de entregarlo, como establece el estándar de correo.
Si los destinatarios no deben verse entre sí, use CCO o haga un envío por destinatario.
Puede enviar hasta 50 destinatarios por mensaje, tanto por API como por SMTP. El límite incluye las direcciones repetidas. Si lo supera, el envío se rechaza. Consulte el error en los límites de POST /v1/mails/send y de 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.
Para probar sin llegar a un destinatario real, use el entorno de pruebas. Simula entregas, rebotes y quejas sin que el correo salga. Consulte Sandbox.
Comprobar la cuenta conversando con un agente
Existe además un servidor MCP que permite pedirle a un asistente de IA, en lenguaje natural, que envíe un correo de prueba y consulte los reportes. Sirve para comprobar que la cuenta envía antes de desarrollar la integración.
No es una vía de integración. Se autentica con la identidad de un usuario, por lo que una persona debe iniciar sesión. Para que un sistema envíe de forma desatendida, use la API o SMTP.
Dudas frecuentes
¿Puedo usar la misma credencial para los dos caminos?
No. Una API key sirve para las llamadas HTTP. Una credencial SMTP sirve para enviar por SMTP. Son credenciales distintas y se crean por separado.
¿El correo se envía en el momento?
Sí. La plataforma no lo retiene: sale en cuanto lo acepta. Para enviarlo en un horario determinado, programe la llamada en su sistema.
¿Puedo enviar a varios destinatarios en una sola llamada?
Sí, y también por SMTP. Ver Enviar a varios destinatarios.
¿Por qué mi envío fue rechazado con un error de remitente?
El remitente debe estar registrado sobre un dominio habilitado y coincidir exactamente con el que creó. Consulte Crear y gestionar remitentes.