La plupart des expéditeurs d'emails transactionnels ne rendent que du HTML brut. POST /api/v1/send en mode modèle rend à la place l'un de vos propres projets studio, moteur d'alternatives complet et blocs interactifs inclus. Un reçu ou une confirmation déclenché par votre backend peut porter un bloc Notation ou une vente incitative de Produit exactement comme le ferait un envoi marketing.
Un reçu est l'un des emails au taux d'ouverture le plus élevé qu'une entreprise envoie — et presque toujours le plus dépouillé, parce qu'il est généralement généré par la bibliothèque transactionnelle la plus simple à brancher, pas par quelque chose disposant d'un système de design.
Concevez-le une fois, déclenchez-le depuis votre backend
Construisez le reçu ou la confirmation comme un projet studio normal, avec les blocs qui font sens — une Notation pour un CSAT post-achat, une vente incitative de Produit d'article associé. Votre backend appelle ensuite l'API d'envoi en mode modèle avec l'ID du projet et un objet mergeData se substituant aux valeurs dynamiques de cette commande précise.
Marquez-le correctement comme transactionnel
Régler type sur "transactional" contourne la suppression par désabonnement — un reçu doit quand même atteindre quelqu'un qui s'est désabonné du marketing — mais jamais la suppression par rebond, puisqu'une adresse véritablement défaillante ne devrait pas continuer à recevoir des envois, quel que soit le type d'email.
C'est authentifié comme n'importe quelle intégration API
Une clé API nommée par propriétaire, authentifiée par Bearer, se génère et se révoque depuis la section Developers du tableau de bord. Un en-tête Idempotency-Key empêche une requête retentée d'envoyer le reçu deux fois.
Ce qui ne se reporte pas
Le mode libre (pas de projectId, seulement du html/text brut) saute entièrement le pipeline de rendu — pas de balises de fusion, pas de moteur d'alternatives, envoyé exactement tel que fourni. C'est le bon choix pour quelque chose comme un code OTP ponctuel ; le mode modèle est celui qui vaut la peine dès que l'email lui-même profite d'un bloc interactif.
Pour commencer
Construisez le modèle transactionnel comme un projet studio avec les blocs interactifs voulus, générez une clé API sous Developers, et appelez POST /api/v1/send en mode modèle avec votre mergeData et type: "transactional".