Lokalizace e-mailů

Lingo.dev CLI a localization API podporují dva způsoby lokalizace e-mailů: překlad souborů šablon při buildu, abyste mohli nasadit šablony pro každý jazyk, nebo překlad obsahu za běhu před odesláním. Obojí prochází přes nakonfigurovaný lokalizační engine, který automaticky použije pravidla glosáře, hlas značky a výběr modelu.

Vyberte si přístup#

Co budete potřebovat#

Každý překlad prochází přes lokalizační engine — konfiguraci, která určuje, jaký model LLM, glosář, hlas značky a pravidla se použijí. Vytvořte si ho v dashboardu Lingo.dev a pak nainstalujte a autentizujte CLI:

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

CLI vyžaduje Node 22+. V CI nastavte LINGO_API_KEY místo spouštění lingo login.

Lokalizace při buildu#

CLI překládá obsah e-mailů z JSON resource souborů. Vyčleňte překládatelný text do JSON, namiřte na něj CLI a získejte soubory pro jednotlivé jazyky vedle zdrojových souborů.

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

Kdykoli si chcete stáhnout výsledky z posledního push běhu, použijte lingo pull. Pokud chcete ověřit, že jsou překlady aktuální, aniž by se zapisovaly změny (například v CI), použijte lingo check.

Lokalizace za běhu#

Když je obsah e-mailů dynamický – personalizované notifikace, souhrny obsahu vytvořeného uživateli nebo marketingové texty uložené v CMS – přeložte ho za běhu před odesláním. Tento přístup vychází ze vzoru popsaného v průvodci Translation API.

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

Osvědčené postupy#

Další kroky#