Localizar correos electrónicos
Traduce juntos el asunto, el preencabezado y el cuerpo, y después genera el mensaje completo con el idioma del destinatario y los valores de la plantilla.
Un correo electrónico empieza antes de que quien lo recibe lo abra. El asunto y el preencabezado hacen una promesa que el cuerpo, el botón y los valores insertados deben cumplir en el mismo idioma. Mantén todos esos elementos juntos en el contenido de origen de la traducción y genera el mensaje usando ese mismo idioma del destinatario.
Para las plantillas transaccionales recurrentes, traduce los catálogos antes de enviar. El sistema de envío puede cargar un catálogo aceptado y generar el mensaje sin esperar a que se genere una nueva traducción. La traducción en tiempo de ejecución resulta útil cuando no se puede preparar el contenido con antelación; esta alternativa exige una política explícita de gestión de fallos y entrega, que se explica más adelante.
Separa el texto de los datos del destinatario y de entrega #
Crea emails/locales/en.json con textos como estos:
{
"subject": "Your order is on its way",
"preheader": "Track delivery for order {orderNumber}.",
"heading": "Your order has shipped",
"body": "Hello {name}, your order will arrive within {days} business days.",
"cta": "Track your order",
"footer": "You received this message because you placed an order."
}La plantilla proporciona name, orderNumber, days y la URL de seguimiento. Dejar los datos del destinatario fuera del contenido de origen de la traducción evita generar de nuevo el mismo mensaje para cada pedido y enviar valores privados sin necesidad. Si los datos personales influyen en la redacción, confirma que está autorizado enviarlos al servicio de traducción antes de hacerlo.
Usa una sintaxis de marcadores de posición compatible con el sistema de generación de mensajes existente. Traducir JSON no determina qué lenguaje de plantillas se utiliza. Aporta contexto sobre la relación con el destinatario, la promesa de entrega y el texto legal obligatorio. En este ejemplo, «llegará» expresa una promesa que un cambio de estilo no debe convertir en una mera posibilidad.
Traduce el catálogo #
Desde la raíz del proyecto, inicializa la CLI actual:
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es --files 'emails/locales/en.json' --yes
lingo link
lingo push --backfill-missing --waitVincula la organización y el motor de localización que vayas a utilizar. La primera carga retroactiva genera emails/locales/es.json; un primer envío sin más puede guardar una versión de referencia sin traducir los destinos que faltan. Espera a que el proceso se complete y revisa el asunto, el preencabezado, el cuerpo y los nombres de los marcadores de posición antes de usar la traducción de destino.
Con React Email, carga las cadenas del catálogo y pásalas a los componentes existentes. Con MJML, sustituye los textos a través de la capa de plantillas del proyecto antes de compilar el HTML; la CLI no lee archivos .mjml. En ambos casos, los sistemas de generación siguen encargándose de la maquetación, el escape de caracteres y los enlaces.
Traduce plantillas HTML simples #
Si tus plantillas son archivos HTML simples, la CLI los traduce directamente. Añade un patrón que incluya el idioma de origen en la ruta, como emails/en/*.html, y cada destino tendrá su propio archivo, como emails/es/order-shipped.html. El formato HTML incorpora el texto traducido y los atributos compatibles a una copia del original, conserva los enlaces y el marcado no modificado tal como están escritos y protege los tokens de plantilla {{...}}.
Genera un mensaje localizado completo antes de enviar #
Usa el sistema de previsualización existente de la aplicación con los mismos valores seguros para el origen y el destino. Un programa mínimo de prueba en Node también permite verificar una versión de texto sin formato sin enviar ningún correo. Guárdalo como un archivo temporal preview-email.mjs en la raíz del proyecto:
import { readFile, writeFile } from "node:fs/promises";
const locale = process.argv[2] ?? "es";
if (!["en", "es"].includes(locale)) {
throw new Error("Unsupported preview locale");
}
const messages = JSON.parse(await readFile(`emails/locales/${locale}.json`, "utf8"));
const values = { name: "Alexandra Example", orderNumber: "EXAMPLE-42", days: 3 };
const trackingUrl = "https://example.com/orders/EXAMPLE-42";
function message(key) {
if (typeof messages[key] !== "string" || messages[key].length === 0) {
throw new Error(`Missing message: ${key}`);
}
return messages[key].replace(/\{(\w+)\}/g, (_, name) => {
if (!Object.hasOwn(values, name)) {
throw new Error(`Unknown placeholder: ${name}`);
}
return String(values[name]);
});
}
const preview = {
subject: message("subject"),
preheader: message("preheader"),
text: [message("heading"), message("body"), `${message("cta")}: ${trackingUrl}`, message("footer")].join("\n\n"),
};
await writeFile(`email-preview-${locale}.json`, JSON.stringify(preview, null, 2) + "\n");Ejecuta node preview-email.mjs en y node preview-email.mjs es y compara las dos vistas previas guardadas. Este programa de prueba solo admite marcadores de posición simples con nombre; no implementa ICU, selección de plurales, escape de HTML ni envío de correo electrónico. Deja esas funciones al sistema de generación de plantillas de producción. Da formato a las fechas y los números según el idioma del destinatario antes de pasarlos a mensajes cuyas plantillas esperen valores ya formateados.
Genera también las versiones HTML y de texto sin formato con valores largos y vacíos. Comprueba que el preencabezado aparezca en el lugar previsto, que el botón lleve a la URL de seguimiento autorizada y que los identificadores legales y el funcionamiento de la baja de la suscripción se mantengan intactos. Revisa los clientes de correo compatibles, los recortes de texto en móviles, las etiquetas más largas y la maquetación de derecha a izquierda cuando sea necesario. Las recomendaciones sobre la longitud del asunto no sustituyen la comprobación en el cliente real.
Si el contenido necesita traducción en tiempo de ejecución #
Mantén las credenciales y las llamadas al servicio de traducción en el servidor. Envía los campos del mensaje como un documento JSON en línea, inicia el trabajo y descarga la traducción de destino completada antes de generar el correo. Pon este trabajo en cola antes de la entrega para que el sistema de envío pueda esperar a que terminen la traducción y cualquier revisión configurada.
Registra los idiomas de origen y destino, la revisión del contenido y la configuración del motor de localización para la solicitud. Gestiona los rechazos por separado de los trabajos que se aceptan y fallan después. Valida los campos obligatorios de asunto y cuerpo y la compatibilidad de los marcadores de posición antes de generar el mensaje. Si el flujo de trabajo seleccionado queda a la espera de una revisión, el proceso de envío debe respetar ese estado.
Decide qué hacer con la entrega si la traducción falla o sigue pendiente: volver a intentarlo más tarde, usar una alternativa revisada o retener el mensaje. Tras la validación, pasa el contenido aceptado a tu servicio de correo electrónico existente para enviarlo.
Conserva el texto aprobado junto con la revisión de la plantilla #
Cuando haya cambios posteriores en el contenido de origen, usa lingo push --wait y repite la comparación de los mensajes generados. Conserva juntos el catálogo, la plantilla, las traducciones de destino aceptadas y el Lockfile de la CLI. Guarda las correcciones existentes antes de actualizar. Para detectar cambios en las traducciones de destino realizados después del envío, omite --wait y revisa lingo pull --dry-run antes de recuperarlas. Consulta Conservar las traducciones revisadas para saber cómo gestionar los conflictos.
Cuando cambie una promesa en el contenido de origen, revisa los mensajes de destino correspondientes antes de configurar el sistema de envío para que use esa revisión. Planificar un lanzamiento multilingüe aborda esa decisión de entrega para los distintos idiomas.