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 LLM, le glossaire, la voix de marque et les instructions à appliquer. Créez-en un dans le tableau de bord Lingo.dev, puis générez une clé API.

Localisation au moment du build#

La CLI traduit directement les fichiers de modèles d’e-mails. Configurez un bucket adapté au format de votre modèle, exécutez la CLI, puis récupérez des fichiers de modèles par langue à côté de vos modèles sources.

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": {
    "source": "en",
    "targets": ["es", "fr", "de", "ja"]
  },
  "buckets": {
    "json": {
      "include": ["emails/locales/[locale].json"]
    }
  }
}

Lancez les traductions avec :

npx lingo.dev@latest run

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#