Localiser un modèle d'e-mail via l'API
Un modèle d'e-mail est un contenu HTML incluant une syntaxe de modèle. Envoyez le corps du message à l'API, lancez un workflow pour toutes vos langues et récupérez le même code HTML pour chaque langue : vos variables sont protégées tout au long du processus et le résultat est prêt à être collé dans votre ESP.
Sur cette page
Comment envoyer un modèle ?
POST /documents avec content_type: "html" et vos langues cibles. Le code HTML est transmis tel quel ; la mise en forme, les liens et les variables de modèle sont tous préservés lors de la traduction.
Ensuite, estimez et lancez l'exécution exactement comme indiqué dans Automatiser Transept avec l'API : l'estimation est gratuite et l'exécution traite toutes les versions linguistiques en un seul appel.
# BASE="https://app.transept.ai/api/public/v1"; KEY from Settings → Developer
curl -s -X POST $BASE/documents \
-H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"title": "Trial welcome", "content_type": "html", "source_language": "en",
"target_languages": ["de", "fr"],
"content": "<h1>Welcome, {{ first_name | default:\"friend\" }}!</h1><p>Your trial starts today.</p>"}'
# → { document_id, language_group: [ {id, target_language}, … ] }Que deviennent les variables ?
{{ first_name | … }} est masqué avant que le modèle ne voie le texte, puis restauré tel quel. Chaque réponse est comparée à la source : ainsi, toute variable perdue ou altérée est réparée plutôt que livrée. Une exception délibérée : le texte de secours à l'intérieur d'une balise (le mot friend dans default:"friend") est ce que lisent réellement les destinataires dont le nom n'est pas renseigné ; il est donc traduit, contrairement à la balise qui l'entoure. Les règles complètes de protection des variables sont disponibles dans les fichiers de chaînes.
Comment récupérer chaque langue ?
GET /documents/{id}/content?format=html sur chaque version linguistique renvoie la même structure HTML avec le texte traduit, prêt à être collé dans la variante linguistique de l'ESP.
curl -s "$BASE/documents/<de-version-id>/content?format=html" \
-H "Authorization: Bearer $KEY"
# → the same HTML with German copy, Liquid intactLe cycle complet peut-il s'exécuter sans mon intervention ?
Oui. Un déclencheur par webhook configuré sur « le corps de la requête est le contenu » récupère le modèle directement depuis votre ESP ou une étape Zapier/n8n, lance le workflow dès sa réception, puis un webhook sortant envoie un événement signé lorsque les traductions sont prêtes. Votre automatisation peut ainsi récupérer le code HTML sans avoir à interroger l'API en boucle. Plus besoin de charger quoi que ce soit manuellement.
Les balises Liquid, Handlebars ou les variables de fusion sont-elles préservées lors de la traduction ?
Oui. Les variables de modèle sont masquées avant que le modèle ne voie le texte, puis restaurées telles quelles. Chaque réponse est comparée à la source : ainsi, toute variable perdue est réparée plutôt que livrée. La seule exception délibérée est le texte de secours à l'intérieur d'une balise, que les destinataires lisent réellement ; il est donc traduit, contrairement à la balise qui l'entoure.
Ma plateforme d'e-mailing peut-elle envoyer des modèles sans aucun code ?
Oui. Configurez la cible d'un déclencheur de workflow sur « le corps de la requête est le contenu » et faites pointer la plateforme, ou une étape Zapier/n8n, vers l'URL du déclencheur. Chaque envoi devient un document et le workflow se lance dès sa réception. Voir les déclencheurs par webhook.
Qu'en est-il des modèles localisés via des balises Braze ou Mailchimp ?
Les modèles dont la localisation repose sur des balises de traduction ou des conditions de langue disposent de leur propre flux d'importation qui lit et remplit directement ces balises. Voir modèles d'e-mail de Braze et Mailchimp.
Un problème persiste ? Demandez à Literess dans l'application, ou écrivez à [email protected].