E-Mail-Lokalisierung

Die Lingo.dev CLI und die localization API unterstützen zwei Ansätze für die E-Mail-Lokalisierung: Übersetze Vorlagendateien beim Build, um Vorlagen pro Sprache auszuliefern, oder übersetze Inhalte vor dem Versand zur Laufzeit. Beide laufen über eine konfigurierte Lokalisierungs-Engine, auf die Glossarregeln, Markenstimme und Modellauswahl automatisch angewendet werden.

Wähle deinen Ansatz#

Voraussetzungen#

Jede Übersetzung läuft über eine Lokalisierungs-Engine – die Konfiguration, die festlegt, welches LLM-Modell, Glossar, welche Markenstimme und welche Regeln verwendet werden. Erstellen Sie sie im Lingo.dev-Dashboard und installieren und authentifizieren Sie anschließend die CLI:

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

Die CLI setzt Node 22+ voraus. Setze in CI LINGO_API_KEY, statt lingo login auszuführen.

Lokalisierung beim Build#

Die CLI übersetzt E-Mail-Content aus JSON-Ressourcendateien. Extrahiere deinen übersetzbaren Text in JSON, richte die CLI darauf aus und erhalte für jede Sprache eigene Dateien neben deiner Quelldatei.

{
  "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

Um Ergebnisse aus dem letzten Push-Durchlauf jederzeit abzurufen, verwende lingo pull. Um zu prüfen, ob die Übersetzungen auf dem neuesten Stand sind, ohne Änderungen zu schreiben (zum Beispiel in CI), verwende lingo check.

Lokalisierung zur Laufzeit#

Wenn E-Mail-Inhalte dynamisch sind – etwa personalisierte Benachrichtigungen, Zusammenfassungen nutzergenerierter Inhalte oder in einem CMS gespeicherte Marketingtexte –, übersetze sie vor dem Versand zur Laufzeit. Das baut auf dem Muster auf, das im Leitfaden zur Translation API beschrieben ist.

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),
  });
}

Best Practices#

Nächste Schritte#