Resumen de los servicios

Un servicio es una conexión entre Frontmail y un proveedor de correo. Frontmail nunca envía correos desde su propia infraestructura en tu nombre: renderiza tu plantilla y entrega el mensaje a tu proveedor, así que la entregabilidad, la reputación del remitente y los precios del proveedor siguen bajo tu control.

Proveedores compatibles

Proveedor	Tipo	Ideal para	Webhooks de entrega
SMTP (Seznam, Zoho, personalizado)	`smtp`	Buzones existentes, servidores de correo propios	–
Mailgun	`mailgun`	Correo transaccional, región UE o EE. UU.	✓
Amazon SES	`ses`	Grandes volúmenes a bajo coste, usuarios de AWS	✓ (a través de SNS)
Postmark	`postmark`	Entrega transaccional rápida	✓
Mailjet	`mailjet`	Transaccional con sede en la UE	✓
Brevo	`brevo`	Con sede en la UE, plan gratuito generoso	✓
Resend	`resend`	API pensada para desarrolladores	✓
Gmail (OAuth)	`gmail`	Buzones personales / de Google Workspace	–
Outlook / Microsoft 365 (OAuth)	`outlook`	Buzones de Outlook.com y Microsoft 365	–

Los servicios personales (buzones SMTP, Gmail, Outlook) se configuran rápido y envían desde tu buzón real, pero tienen límites diarios bajos y no permiten seguir la entrega. Los proveedores transaccionales requieren configurar el DNS, pero escalan, te dan eventos de entrega, rebote y apertura, y ofrecen mejor entregabilidad.

Añadir un servicio

Los propietarios, administradores y desarrolladores gestionan los servicios en Servicios de correo.

Haz clic en Añadir servicio y elige el proveedor.
Para Gmail y Outlook, haz clic en Conectar Gmail / Conectar Outlook / Microsoft 365 y permite el acceso en la ventana del proveedor. Para los demás, introduce las credenciales y haz clic en Verificar y guardar: Frontmail las verifica con el proveedor (sin enviar ningún correo) antes de guardarlas. Si prefieres comprobarlas más tarde, tienes Guardar sin verificar. Las credenciales se cifran con AWS KMS (cifrado de sobre, AES-256-GCM) y no se vuelven a mostrar nunca: solo puedes sustituirlas.
En la página del servicio, Probar conexión vuelve a ejecutar la misma comprobación cuando quieras.
Si quieres, configura la URL del webhook que aparece en la página del servicio (ver más abajo).
Tu primer servicio pasa a ser el predeterminado automáticamente; usa Marcar como predeterminado para cambiarlo. Lo usan las plantillas sin un servicio explícito y las llamadas a la API sin service_id. Si eliminas un servicio que usan plantillas, estas pasan a usar el servicio predeterminado.

Remitente predeterminado (From)

Cada servicio puede tener un Correo del remitente predeterminado y un Nombre del remitente predeterminado (en el formulario para añadirlo y en la página del servicio, en Ajustes). La dirección From de cada correo se determina en este orden:

Correo del remitente / Nombre del remitente en los ajustes de la plantilla (pueden usar parámetros),
el Correo / Nombre del remitente predeterminado del servicio,
en Gmail y Outlook, la cuenta conectada; en SMTP, el usuario si es una dirección de correo.

Mientras el correo del remitente de la plantilla esté vacío, el editor de plantillas muestra qué remitente se usará. Cambiar solo el remitente predeterminado no vuelve a ejecutar la prueba de conexión. Si ningún paso da una dirección, los envíos de prueba fallan con sender_not_configured y los envíos reales fallan de forma permanente (se devuelve el crédito).

Servicio de respaldo (failover)

Cada plantilla tiene un servicio principal y, opcionalmente, un servicio de respaldo; ambos se eligen en el editor de plantillas, en Ajustes → Entrega (Servicio y Servicio de respaldo). El remitente prueba primero con el principal. Si falla con un error de autenticación o permanente, el mismo mensaje se envía de inmediato por el de respaldo. La cronología del mensaje muestra un evento failover y el Historial indica qué servicio lo envió realmente.

Los errores transitorios (tiempos de espera agotados, limitación, 5xx) no activan el failover: primero se reintentan con el servicio principal, porque suelen resolverse solos.

Cómo se gestionan los errores del proveedor

Frontmail clasifica cada error del proveedor en uno de tres grupos:

Clase	Ejemplos	Qué hace Frontmail
Autenticación	clave de API no válida o revocada, token de OAuth caducado (Google `invalid_grant`), SMTP `535`	Marca el servicio como no operativo (No funciona), envía un correo al propietario y a los administradores y muestra un aviso en el panel. Envía por el servicio de respaldo si lo hay; si no, devuelve el crédito y deja el mensaje como `held_service_error`.
Permanente	destinatario no válido, remitente o dominio sin verificar, mensaje rechazado por política	Prueba con el servicio de respaldo si lo hay; si no, el mensaje pasa a `failed` y se devuelve el crédito. Los rebotes permanentes añaden la dirección a la lista de supresión.
Transitorio	tiempo de espera agotado, conexión reiniciada, `5xx` del proveedor, limitación `429`, SMTP `421`/`450`/`451`	Reintenta con espera exponencial (respetando los límites de envío del proveedor). Si fallan todos los reintentos, el mensaje pasa a `failed` y se devuelve el crédito.

Cada guía de proveedor incluye sus errores habituales y cómo se clasifican.

Mensajes retenidos por un error del servicio

Los mensajes en held_service_error esperan en la cola de correos retenidos junto con los retenidos por falta de créditos, marcados con el motivo servicio. En cuanto el servicio vuelve a funcionar (después de actualizar las credenciales, reconectar OAuth o de una comprobación de estado correcta), se liberan automáticamente: se vuelve a reservar un crédito y se envían en el orden original. También puedes liberarlos o descartarlos manualmente. Caducan como los demás correos retenidos (Free, 3 días; planes de pago, 14 días) y recibes un correo antes de que ocurra.

Comprobaciones de estado

A diario: Frontmail verifica todos los servicios (la misma comprobación que Probar conexión).
De inmediato tras un error de autenticación durante el envío.
Al guardar: cada vez que editas las credenciales o reconectas OAuth.

Un servicio puede estar healthy (Funciona), unhealthy (No funciona) o unknown (Sin comprobar). Cuando un servicio deja de funcionar, los propietarios y administradores reciben un correo y el panel muestra el aviso Un servicio de correo no funciona con un botón Arreglar servicio hasta que se recupera; recibes otro correo cuando vuelve a funcionar y se han liberado sus correos retenidos.

Webhooks de entrega

Los proveedores transaccionales pueden informar de lo que pasó después de aceptar el mensaje. Copia la URL del webhook de la página del servicio (que también indica qué eventos activar) en la consola de tu proveedor:

https://api.frontmail.dev/webhooks/providers/<type>/<token>

<type> es el tipo de proveedor de la tabla de arriba (p. ej. mailgun) y <token> es un token aleatorio único del servicio: trata la URL completa como un secreto. Frontmail también verifica la firma del proveedor cuando este la admite.

Los eventos se traducen en estados de mensaje y estadísticas:

Evento del proveedor	Frontmail
entregado	estado `delivered`
rebote permanente	estado `bounced` + dirección añadida a la lista de supresión
rebote temporal	solo evento (el proveedor reintenta)
queja por spam	estado `complained` + dirección añadida a la lista de supresión
apertura / clic	eventos `opened` / `clicked` en la cronología y las estadísticas

Sin webhooks, un mensaje termina en sent, lo que significa que el proveedor lo aceptó.