Envíos SMTP para correo electrónico transaccional

Además de la API HTTP, Flexmail admite el envío de correo electrónico transaccional a través de SMTP. Esto es útil cuando su aplicación o plataforma ya tiene compatibilidad con SMTP integrada: un CMS, una plataforma de comercio electrónico o un sistema heredado que envía correo electrónico a través de un relay SMTP.

El envío SMTP está incluido en el producto transaccional sin coste adicional. Proporciona la misma fiabilidad de entrega y capacidades de seguimiento que la API, con algunas diferencias en los valores predeterminados y las funciones admitidas.

Nota

El envío SMTP no está habilitado de forma predeterminada. Debe solicitar acceso explícitamente. Consulte «Solicitar acceso» a continuación.

Solicitar acceso

El acceso SMTP no se habilita automáticamente al activar el producto transaccional. Para solicitar credenciales SMTP para su cuenta, póngase en contacto con el soporte de Flexmail en support@flexmail.eu e incluya su ID de cuenta en la solicitud. Su nombre de usuario y contraseña SMTP se proporcionarán como parte de la respuesta de credenciales.

Nota

Sus credenciales SMTP son independientes de su token de acceso personal. El nombre de usuario y la contraseña para SMTP son proporcionados por Flexmail a petición: no use su ID de cuenta y token de acceso personal como credenciales SMTP.

Ajustes de conexión

Una vez concedido el acceso SMTP, use los siguientes ajustes:

Ajuste

Valor

Servidor

submission.flexmail.eu

Puerto

587

Seguridad de conexión

STARTTLS

Nombre de usuario

Proporcionado por Flexmail a petición

Contraseña

Proporcionada por Flexmail a petición

Encabezados personalizados

Los envíos SMTP admiten varios encabezados personalizados opcionales que controlan el comportamiento del mensaje y el seguimiento. Funcionan de manera similar a las opciones disponibles en la API HTTP.

Encabezado

Descripción

X-Flexmail-Tag

Añada una etiqueta para categorizar los mensajes y acumular estadísticas. Debe estar en formato snake_case (1–50 caracteres, por ejemplo, order_confirmation).

X-Flexmail-Metadata-{clave}

Añada metadatos personalizados como pares clave/valor. Reemplace {clave} con el nombre de su campo en snake_case. El valor debe tener entre 1 y 80 caracteres.

X-Flexmail-Open-Tracking

Establezca en true para habilitar el seguimiento de aperturas. Deshabilitado de forma predeterminada.

X-Flexmail-Link-Tracking

Establezca en true para habilitar el seguimiento de enlaces. Deshabilitado de forma predeterminada.

Ejemplo:

X-Flexmail-Tag: order_confirmation X-Flexmail-Metadata-order_id: 12345 X-Flexmail-Metadata-customer_id: C-789 X-Flexmail-Open-Tracking: true X-Flexmail-Link-Tracking: true

Nota

El seguimiento de aperturas y de enlaces está deshabilitado de forma predeterminada tanto para los envíos SMTP como para la API HTTP. Añada los encabezados correspondientes si desea tener el seguimiento habilitado.

ID de mensaje y correlación de webhooks

El encabezado Message-ID original de su correo electrónico enviado se almacena automáticamente como metadatos bajo la clave original_message_id. Esto le permite correlacionar los eventos de entrega de webhooks con los mensajes que envió desde su propio sistema.

SMTP frente a la API HTTP

Los dos métodos tienen algunas diferencias en los valores predeterminados y las capacidades:

Función

API HTTP

Envío SMTP

Seguimiento de aperturas

Deshabilitado de forma predeterminada

Seguimiento de enlaces

Deshabilitado de forma predeterminada

Message-ID original

No aplicable

Conservado como metadatos original_message_id

Archivos adjuntos en línea

Admitido

No admitido

Correo electrónico solo texto sin formato

Admitido

No admitido

Funciones admitidas

Correos electrónicos HTML con o sin texto sin formato multiparte.
Seguimiento de aperturas y de enlaces (a través de encabezados personalizados).
Destinatarios en CC y CCO.
Archivos adjuntos: deben estar codificados en base64. Los archivos adjuntos en línea no están admitidos.
Limitación de velocidad por destinatario, coherente con los límites de velocidad de la API.

Requisitos

La dirección De debe ser un remitente verificado en su cuenta de Flexmail.
El dominio de envío debe estar autenticado con SPF, DKIM y DMARC, y debe estar configurado un return-path. Estos requisitos son los mismos que para la API HTTP.

Gestión de errores

Los errores de envío se notifican a través de un NDR (Informe de no entrega) enviado a la dirección del remitente del sobre. Los eventos de rebote y todos los demás eventos de mensajes también están disponibles a través del punto de conexión de detalles del mensaje y los webhooks, de la misma manera que los envíos de la API.

Próximos pasos

Consulte «Primeros pasos con la API transaccional» para el proceso completo de configuración de la cuenta.
Consulte «Webhooks transaccionales» para recibir eventos de entrega y seguimiento en tiempo real.
Consulte «Solución de problemas transaccionales» si su conexión SMTP o su entregabilidad no funcionan como se esperaba.