La mayoría de los remitentes de correo transaccional solo renderizan HTML plano. POST /api/v1/send en modo de plantilla, en cambio, renderiza uno de tus propios proyectos del estudio, con el motor de alternativas completo y los bloques interactivos incluidos. Un recibo o confirmación que dispare tu backend puede llevar un bloque de Calificación o una venta adicional de Producto exactamente igual que lo haría un envío de marketing.
Un recibo es uno de los correos con mayor tasa de apertura que envía una empresa — y casi siempre el más plano, porque normalmente lo genera la primera librería transaccional que fue fácil de conectar, no algo con un sistema de diseño detrás.
Diséñalo una vez, dispáralo desde tu backend
Construye el recibo o la confirmación como un proyecto normal del estudio, con los bloques que tengan sentido — una Calificación para el CSAT posterior a la compra, un Producto de venta adicional de un artículo relacionado. Tu backend entonces llama a la API de envío en modo de plantilla con el ID del proyecto y un objeto mergeData que hace las veces de los valores dinámicos de ese pedido específico.
Márcalo como transaccional, correctamente
Configurar type como "transactional" omite la supresión por cancelación de suscripción — un recibo aún debe llegar a alguien que canceló su suscripción de marketing — pero nunca la supresión por rebote, ya que una dirección realmente inválida no debería seguir recibiendo correos sin importar el tipo de envío.
Está autenticado como cualquier integración por API
Una clave de API con nombre por cuenta, autenticada con Bearer, se genera y revoca desde la sección Desarrolladores del panel. Un encabezado Idempotency-Key evita que una solicitud reintentada envíe el recibo dos veces.
Lo que no se traslada
El modo de formato libre (sin projectId, solo html/text en bruto) omite el pipeline de renderizado por completo — sin etiquetas de combinación, sin motor de alternativas, enviado exactamente como se indica. Esa es la opción correcta para algo como un código OTP puntual; el modo de plantilla es el que vale la pena usar en cuanto el propio correo se beneficia de un bloque interactivo.
Primeros pasos
Construye la plantilla transaccional como un proyecto del estudio con los bloques interactivos que quieras, genera una clave de API bajo Desarrolladores, y llama a POST /api/v1/send en modo de plantilla con tu mergeData y type: "transactional".