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ý LLM model, glosář, hlas značky a instrukce se použijí. Vytvořte ho v dashboardu Lingo.dev a vygenerujte API key.

Lokalizace při buildu#

CLI překládá soubory e-mailových šablon přímo. Nastavte bucket, který odpovídá formátu vašich šablon, spusťte CLI a získejte soubory šablon pro každý jazyk vedle zdrojových šablon.

{
  "$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"]
    }
  }
}

Překlady spustíte pomocí:

npx lingo.dev@latest run

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#