Localisation des e-mails

La CLI de Lingo.dev et l’API de localisation prennent en charge deux approches pour localiser les e-mails : traduire les fichiers de modèles au moment du build afin de déployer un modèle par langue, ou traduire le contenu à l’exécution avant l’envoi. Dans les deux cas, tout passe par un moteur de localisation configuré, avec les règles du glossaire, la voix de marque et la sélection du modèle appliquées automatiquement.

Choisissez votre approche#

Prérequis#

Chaque traduction passe par un moteur de localisation : c’est la configuration qui détermine le modèle de LLM, le glossaire, la voix de marque et les règles à appliquer. Créez-en un dans le tableau de bord Lingo.dev, puis installez et authentifiez le CLI :

npm install -g @lingo.dev/cli
lingo login

La CLI nécessite Node 22+. En CI, définissez LINGO_API_KEY au lieu d’exécuter lingo login.

Localisation au moment du build#

La CLI traduit le contenu des e-mails à partir de fichiers de ressources JSON. Extrayez votre contenu traduisible en JSON, pointez la CLI dessus, et obtenez des fichiers par langue à côté de votre source.

{
  "orgId": "org_abc123",
  "engineId": "eng_abc123",
  "sourceLocale": "en",
  "targetLocales": ["es", "fr", "de", "ja"],
  "files": [{ "pattern": "emails/locales/en.json" }]
}

lingo push --backfill-missing   # first run / new locale
lingo push                      # delta on later runs

Pour récupérer à tout moment les résultats du dernier push, utilisez lingo pull. Pour vérifier que les traductions sont à jour sans écrire de modifications (par exemple en CI), utilisez lingo check.

Localisation à l’exécution#

Lorsque le contenu de l’e-mail est dynamique — notifications personnalisées, résumés de contenu généré par les utilisateurs ou texte marketing stocké dans un CMS — traduisez-le à l’exécution avant l’envoi. Cette approche s’appuie sur le modèle décrit dans le guide de l’API de traduction.

async function sendLocalizedEmail(userId, templateId, content) {
  const user = await db.users.findById(userId);

  const response = await fetch("https://api.lingo.dev/process/localize", {
    method: "POST",
    headers: {
      "X-API-Key": process.env.LINGODOTDEV_API_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      engineId: "eng_abc123",
      sourceLocale: "en",
      targetLocale: user.locale,
      data: {
        subject: content.subject,
        preheader: content.preheader,
        body: content.body,
      },
    }),
  });

  const { data } = await response.json();

  await emailProvider.send({
    to: user.email,
    subject: data.subject,
    html: renderTemplate(templateId, data),
  });
}

Bonnes pratiques#

Étapes suivantes#