Локализация email-писем

CLI и API локализации Lingo.dev поддерживают два сценария локализации email-писем: перевод файлов шаблонов на этапе сборки с выпуском отдельных шаблонов для каждой локали или перевод контента во время выполнения перед отправкой. В обоих случаях используется настроенный движок локализации, который автоматически применяет правила глоссария, тональность бренда и выбранную модель.

Выберите подход#

Что понадобится#

Каждый перевод работает через движок локализации — это конфигурация, которая задаёт модель LLM, глоссарий, тональность бренда и правила перевода. Создайте его в панели управления Lingo.dev, затем установите и авторизуйтесь в CLI:

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

CLI требует Node 22+. В CI задайте LINGO_API_KEY вместо запуска lingo login.

Локализация на этапе сборки#

CLI переводит контент писем из JSON-файлов ресурсов. Извлеките переводимые тексты в JSON, укажите CLI путь к ним — и рядом с исходником появятся файлы для каждой локали.

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

Чтобы получить результаты последнего запуска push в любой момент, используйте lingo pull. Чтобы проверить актуальность переводов без записи изменений (например, в CI) — используйте lingo check.

Локализация во время выполнения#

Если контент писем динамический — персонализированные уведомления, сводки пользовательского контента или маркетинговые тексты из CMS, — переводите его во время выполнения перед отправкой. Этот сценарий основан на подходе, описанном в руководстве по 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),
  });
}

Рекомендации#

Что дальше#