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

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

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

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

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

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

CLI переводит файлы шаблонов писем напрямую. Настройте бакет под формат ваших шаблонов, запустите CLI и получите файлы шаблонов для каждой локали рядом с исходными шаблонами.

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

Запустите перевод командой:

npx lingo.dev@latest run

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

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

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

Что дальше#