Localización de emails

La CLI y la API de localización de Lingo.dev admiten dos enfoques para la localización de emails: traducir archivos de plantilla en tiempo de compilación para desplegar plantillas por idioma, o traducir el contenido en tiempo de ejecución antes del envío. Ambos pasan por un motor de localización configurado, con reglas de glosario, voz de marca y selección de modelo aplicadas automáticamente.

Elige tu enfoque#

Requisitos previos#

Cada traducción pasa por un motor de localización: la configuración que determina qué modelo de LLM, glosario, voz de marca y reglas se aplican. Crea uno en el panel de Lingo.dev y, después, instala y autentica la CLI:

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

La CLI requiere Node 22+. En CI, configura LINGO_API_KEY en lugar de ejecutar lingo login.

Localización en tiempo de compilación#

La CLI traduce el contenido de tus emails a partir de archivos de recursos JSON. Extrae el texto traducible a JSON, indica a la CLI dónde está y obtén archivos por idioma junto a los originales.

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

Para recuperar en cualquier momento los resultados de la última ejecución de push, usa lingo pull. Para comprobar que las traducciones están al día sin escribir cambios (por ejemplo, en CI), usa lingo check.

Localización en tiempo de ejecución#

Cuando el contenido del email es dinámico —notificaciones personalizadas, resúmenes de contenido generado por usuarios o copy de marketing almacenado en un CMS—, tradúcelo en tiempo de ejecución antes de enviarlo. Esto sigue el patrón descrito en la guía de la API de traducción.

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

Buenas prácticas#

Siguientes pasos#