Enviar y personalizar correos electrónicos transaccionales
Cada llamada a la API transaccional incluye el HTML completo de su correo electrónico directamente en el cuerpo de la solicitud. Esto le da un control total sobre el contenido y la estructura de cada mensaje que envía su aplicación.
Cómo funciona
Pasa el HTML (y opcionalmente el texto sin formato) directamente en el cuerpo de la solicitud a la API. Su aplicación genera el contenido del correo electrónico de forma dinámica y lo incluye en cada solicitud.
Personalización
La personalización le permite insertar valores dinámicos en su correo electrónico: el nombre del destinatario, un número de pedido, el nombre de un producto, un precio. Defina marcadores de posición en su HTML y pase los valores correspondientes en la llamada a la API.
La sintaxis exacta de los marcadores de posición y los parámetros de la API para pasar valores de variables están documentados en la documentación de la API de correo electrónico de Flexmail en email-api.flexmail.eu/documentation, en las secciones de personalización.
Variables de personalización habituales
Las variables típicas utilizadas en correos transaccionales incluyen:
- Nombre del destinatario (nombre, nombre completo)
- Número de pedido o referencia
- Nombres de productos y cantidades
- Precios y totales
- Fechas y plazos
- Enlaces de confirmación o restablecimiento
- URLs o códigos específicos de la cuenta
Probar la personalización
Antes de publicar en producción, pruebe su correo electrónico con valores de variables realistas para asegurarse de que todos los marcadores de posición se resuelven correctamente. La documentación de la API incluye orientación sobre el envío de mensajes de prueba con valores de variables personalizados.
Compruebe en particular que:
- Todos los marcadores de posición están reemplazados: no aparece ninguna sintaxis de variable sin procesar en el correo entregado.
- Los valores de reserva se muestran correctamente cuando no se pasa una variable opcional.
- Los enlaces se resuelven en las URL correctas tras la sustitución de variables.
Importante
Si falta una variable obligatoria en su llamada a la API y no se ha definido ningún valor de reserva, el marcador de posición puede aparecer literalmente en el correo entregado. Pruebe siempre con el mismo conjunto de variables que su aplicación enviará en producción.
Próximos pasos
- Consulte «Primeros pasos con la API transaccional» para la configuración de la cuenta y el primer envío.
- Revise la sección de plantillas en la documentación de la API en email-api.flexmail.eu/documentation para la referencia completa de parámetros.
- Consulte «Webhooks transaccionales» para rastrear la entrega y la interacción de sus envíos basados en plantillas.