Aller au contenu principal

Variantes de langue

Une variante est un template à part entière, rattaché à son original. Elle a sa propre ligne, son propre source, et peut être rouverte dans l'éditeur, modifiée et recompilée comme n'importe quel autre template. Son nom reprend celui de l'original suivi du code de langue : Lettre du vendredi [EN].

Traduire un template

POST /api/v1/templates/:id/translate
Authorization: Bearer <token>
Content-Type: application/json

{ "languages": ["en", "es", "de"] }

Réponse :

{
  "data": {
    "created": [{ "id": "...", "language": "en", "name": "Lettre du vendredi [EN]" }],
    "skipped": ["es"],
    "failed": [{ "language": "de", "code": "model_error", "reason": "…" }]
  }
}
  • created — les variantes créées.
  • skipped — les langues qui avaient déjà une variante. Rien n'est écrasé.
  • failed — les langues qui ont échoué, avec leur motif. Les autres sont quand même créées : un échec sur une langue n'annule pas les autres.

Si aucune variante n'a pu être créée, la réponse est une erreur et non un succès vide.

Les 29 langues reconnues

ar bg cs da de en es et fi fr hr hu it ja ko lt lv nb nl pl pt ro ru sk sl sv tr uk zh

Une langue absente de cette liste est refusée explicitement.

Ce qui est envoyé au modèle, et ce qui ne l'est pas

Seul le texte part. Le balisage, les attributs, les couleurs et les URL ne quittent jamais la plateforme. Ce n'est pas qu'une économie de jetons : le modèle ne voit aucune balise, il ne peut donc pas en casser une, et la préservation de la structure ne dépend plus d'une consigne de prompt.

Ne sont pas traduits : les variables de personnalisation ({{contact.first_name}}), les URL, les adresses email et les noms de marque.

La traduction est compilée avant d'être enregistrée. Si le résultat ne compile pas, la variante n'est pas créée et la langue apparaît dans failed. Mieux vaut une langue manquante qu'une variante cassée découverte le jour de l'envoi.

Une variante ne peut pas être traduite à son tour. Partez toujours de l'original : traduire une traduction dégrade le texte à chaque passage.

Quelle variante reçoit un contact

La variante est choisie automatiquement dans les workflows uniquement. Une campagne envoie le template que vous avez sélectionné, sans chercher de variante — pour adresser plusieurs langues par campagne, créez une campagne par langue, ciblée sur un segment.

Dans une étape « Envoyer un email » d'un workflow, la langue est déterminée dans cet ordre :

  1. la langue fixée sur l'étape, si vous en avez choisi une ;
  2. la langue portée par l'exécution en cours ;
  3. l'attribut language du contact.

Sans variante pour la langue retenue, c'est l'original qui est servi — jamais un échec d'envoi.

La langue d'un contact vient de son attribut language. Comme l'import CSV ne reconnaît que email, first_name et last_name, une colonne language devient un attribut personnalisé : c'est bien ce qui est attendu ici.

Limites connues

  • Relisez les variantes avant un envoi réel. La traduction est automatique : elle est structurellement sûre (la compilation le vérifie), pas éditorialement validée.
  • La fonction dépend d'une clé configurée par l'opérateur de la plateforme, pas par votre organisation — contrairement à l'assistant IA. Si elle n'est pas configurée, la traduction renvoie une erreur explicite.
  • Un quota de 30 requêtes par heure et par organisation s'applique aux endpoints qui appellent un modèle. Une requête couvre toutes les langues demandées : groupez-les plutôt que d'appeler l'endpoint langue par langue.