Primeros pasos con la API transaccional

La API transaccional de Flexmail le permite enviar correos electrónicos activados, de uno a uno, desde su aplicación: confirmaciones de pedido, restablecimientos de contraseña, facturas y cualquier otra cosa que se active en respuesta a una acción específica del usuario. Puede enviar a través de HTTP (API REST) o SMTP, usando las mismas credenciales y cuenta para ambos.

El producto transaccional funciona de forma independiente del producto de marketing de Flexmail. Puede usarlo por sí solo sin configurar campañas ni listas de contactos.

Atención La API transaccional solo admite un destinatario por mensaje. No puede usarse para envíos masivos o de marketing. Consulte «Correo de marketing frente a correo transaccional» para la explicación completa.

Requisitos previos

Una cuenta de Flexmail. La necesita para usar la API transaccional, incluso si solo envía correos transaccionales y no usa las funciones de marketing.
Acceso a los ajustes DNS de su dominio para configurar la autenticación de correo electrónico.
Acceso de desarrollador a su aplicación o sistema de envío para integrar la API o configurar SMTP.

Paso 1: Activar el producto transaccional

Si ya tiene una cuenta de Flexmail, active el producto transaccional desde el widget del panel. La prueba le ofrece hasta 1.000 envíos durante 30 días sin coste. Puede actualizar a una suscripción transaccional de pago en cualquier momento durante o después de la prueba.

Si aún no tiene una cuenta, regístrese en flexmail.be/en/signup. Sus suscripciones de marketing y transaccional se gestionan desde la misma cuenta.

Atención No necesita una suscripción de marketing para usar el producto transaccional. Si solo desea enviar correo transaccional, puede activar el producto transaccional y dejar las funciones de marketing sin usar.

Paso 2: Verificar su dirección de remitente

Antes de poder enviar, necesita verificar la dirección de correo electrónico que usará en el campo De.

Vaya a Ajustes y luego a Añadir o eliminar remitentes.
Añada la dirección de correo electrónico desde la que desea enviar.
Flexmail envía un correo de verificación a esa dirección; haga clic en el enlace para confirmar. Esto demuestra que es el propietario del buzón desde el que envía.

Screenshot of validation email

Paso 3: Configurar la autenticación de correo electrónico

Configure SPF, DKIM, DMARC y una ruta de retorno personalizada para el dominio de su dirección de remitente. Estos registros DNS demuestran que sus correos provienen genuinamente de usted, que es cómo los proveedores de bandeja de entrada como Gmail deciden si entregar su correo a la bandeja de entrada o rechazarlo.

Las instrucciones detalladas de configuración de DNS están en la documentación de la API de correo de Flexmail, en la sección de autenticación de correo electrónico.

Atención La autenticación de correo electrónico no es opcional para el correo transaccional. Sin registros SPF y DKIM correctamente configurados, sus correos transaccionales fallarán las comprobaciones de autenticación en los principales proveedores de bandeja de entrada y pueden ser rechazados o enviados a spam.

Paso 4: Crear un token de acceso personal

La API transaccional usa autenticación HTTP básica. El ID de su cuenta es el nombre de usuario; un token de acceso personal es la contraseña. Estas credenciales son solo para la API HTTP; SMTP usa credenciales separadas proporcionadas por Flexmail a petición.

Vaya a Ajustes, luego a API y luego a Tokens de acceso personal.
Haga clic en Crear nuevo token y asígnele un nombre descriptivo.
Copie el token y guárdelo de forma segura. No se mostrará de nuevo.

Paso 5: Elegir su método de envío

Flexmail admite dos formas de enviar correo transaccional. Ambas usan el mismo ID de cuenta y token de acceso personal.

API HTTP

La API REST le ofrece el máximo control. Puede enviar mensajes, gestionar plantillas, gestionar webhooks y recuperar datos de entrega de forma programática. Este es el enfoque recomendado para integraciones y aplicaciones personalizadas.

La documentación completa está en email-api.flexmail.eu/documentation. La sección de primeros pasos incluye un ejemplo de curl que puede ejecutar de inmediato para verificar su configuración.

SMTP

Los envíos SMTP están incluidos en el producto transaccional sin coste adicional. Use SMTP cuando su aplicación o plataforma ya lo admita, por ejemplo, un CMS, una plataforma de comercio electrónico o un sistema heredado que envía correo a través de un relay SMTP.

Consulte «Envíos SMTP para correo transaccional» para los ajustes de conexión e instrucciones de configuración.

Paso 6: Integrar en su aplicación

Con un envío de prueba exitoso confirmado, está listo para integrar la API en su aplicación. La documentación completa cubre:

Envío de mensajes: todos los parámetros para el endpoint de envío
Plantillas: creación y referencia de plantillas de correo reutilizables. Consulte «Plantillas transaccionales y personalización» para una visión general práctica.
Webhooks: notificaciones de eventos en tiempo real para envíos, entregas, rebotes, aperturas y clics. Consulte «Webhooks transaccionales» para la configuración y referencia de eventos.

Consejo de soporte Configure el manejo de webhooks al principio de su integración. Saber cuándo rebota un correo transaccional le permite actuar de inmediato: marcar la dirección en su sistema, activar una notificación de seguimiento o alertar a su equipo, en lugar de descubrir un problema de entrega días después.

Documentación de la API y soporte

La documentación completa de la API está disponible en email-api.flexmail.eu/documentation.

Si se queda bloqueado en algún punto, el equipo de soporte de Flexmail está disponible en support@flexmail.eu. Las preguntas sobre la API transaccional las gestiona el mismo equipo que da soporte a la interfaz de marketing.

Próximos pasos

Consulte «Correo de marketing frente a correo transaccional» para entender cuándo usar cada tipo.
Consulte «Envíos SMTP para correo transaccional» si desea enviar a través de SMTP en lugar de la API HTTP.
Consulte «Plantillas transaccionales y personalización» para configurar plantillas de correo reutilizables.
Consulte «Webhooks transaccionales» para recibir eventos de entrega en tiempo real.
Consulte «Solución de problemas de correo transaccional» si algo no funciona como se esperaba.
Revise la documentación completa de la API en email-api.flexmail.eu/documentation para todos los parámetros de los endpoints.