Personnalisation transactionnels
Chaque appel API transactionnel inclut le HTML complet de votre e-mail directement dans le corps de la requête. Cela vous donne un contrôle total sur le contenu et la structure de chaque message envoyé par votre application.
Comment ça fonctionne
La personnalisation vous permet d'insérer des valeurs dynamiques dans votre template : le prénom du destinataire, un numéro de commande, un nom de produit, un prix. Vous définissez des espaces réservés dans le template et transmettez les valeurs correspondantes dans l'appel API.
La syntaxe exacte des espaces réservés et les paramètres API pour transmettre des valeurs variables sont documentés dans la documentation de l'API Flexmail Email sur email-api.flexmail.eu/documentation, dans les sections Templates et Personnalisation.
Variables de personnalisation courantes
Les variables typiques utilisées dans les templates transactionnels comprennent :
- Nom du destinataire (prénom, nom complet)
- Numéro de commande ou de référence
- Noms et quantités de produits
- Prix et totaux
- Dates et échéances
- Liens de confirmation ou de réinitialisation
- URLs ou codes spécifiques au compte
Tester la personnalisation
Avant de passer en production, testez votre email avec des valeurs variables réalistes pour vous assurer que tous les espaces réservés sont correctement remplacés. La documentation de l'API contient des conseils pour envoyer des messages de test avec des valeurs variables personnalisées.
Vérifiez en particulier que :
- Tous les espaces réservés sont remplacés — aucune syntaxe de variable brute n'apparaît dans l'e-mail livré.
- Les valeurs de remplacement s'affichent correctement lorsqu'une variable optionnelle n'est pas transmise.
- Les liens pointent vers les bonnes URLs après la substitution des variables.
Attention Si une variable obligatoire est absente de votre appel API et qu'aucune valeur de remplacement n'est définie, l'espace réservé peut apparaître littéralement dans l'e-mail livré. Testez toujours avec le même ensemble de variables que celui que votre application enverra en production.
Étapes suivantes
- Consultez « Premiers pas avec l'API transactionnelle » pour la configuration du compte et le premier envoi.
- Consultez « Webhooks transactionnels » pour suivre la livraison et l'engagement de vos envois basés sur des templates.