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 define qué modelo de LLM, glosario, voz de marca y reglas se aplican. Crea uno en el panel de Lingo.dev y luego instala y autentica el CLI:

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

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

Localización en tiempo de compilación#

El CLI traduce el contenido del email a partir de archivos de recursos JSON. Extrae tu contenido traducible a JSON, apunta el CLI a esos archivos y obtén archivos por idioma junto a tu archivo fuente.

{
  "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 verificar que las traducciones estén actualizadas 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#