Usar la API de Locize con Emailify

Si usas Locize, Emailify puede subir los textos originales de tus diseños de email a un namespace de Locize e importar en Figma las variantes traducidas.

Antes de empezar

Necesitarás:

• Un proyecto de Locize con un idioma de referencia y al menos un idioma de destino.
• Una versión y un namespace ya creados para las traducciones de tus emails.
• Una clave de API de Locize limitada al proyecto.

Paso 1: conecta tu proyecto de Locize

1. Haz clic en el botón Localize de Emailify.
2. Elige Locize API en las opciones de localización.
3. Introduce tu Project ID y tu API Key.
4. Introduce la Version de Locize que quieres usar, como latest o production.
5. Introduce el Namespace que contiene las traducciones de tus emails, como emails.
6. Elige la opción Standard CDN o Pro CDN que corresponda a tu proyecto de Locize.
7. En String Key Source, elige cómo debe crear Emailify las claves de cadena de Locize.

Cuando Emailify se conecta, muestra el idioma de referencia y los idiomas de destino configurados en tu proyecto de Locize.

Asegúrate de que el tipo de CDN coincide con tu proyecto de Locize. La Standard CDN es pública y usa una caché fija de una hora, mientras que la Pro CDN admite la publicación privada y una caché configurable. Consulta la comparativa de CDN de Locize para saber más.

Elegir cómo se crean las claves de cadena de Locize

Figma Node ID (Default) mantiene el comportamiento actual de Emailify y usa los ID de nodo de Figma generados como claves de Locize. Los flujos de trabajo de Locize que ya tengas seguirán usando esta opción a menos que la cambies.

Elige Figma Text Layer Name cuando los nombres de tus capas de texto de Figma ya coincidan con las claves de cadena de tu namespace de Locize. Emailify conserva el nombre completo de la capa, puntos incluidos, así que una capa llamada templates.assistant_invited.h01 usa exactamente esa clave de Locize.

Todas las capas de texto incluidas deben tener nombre, y ese nombre debe ser único en todos los emails seleccionados. Emailify detiene la subida o la importación e indica las claves duplicadas antes de enviar ninguna cadena original a Locize. Las claves de los enlaces y del texto alternativo de las imágenes usan el nombre de la capa de texto o de imagen con el sufijo _LINK o _ALT_TEXT de Emailify. Las filas del asunto y del preencabezado siguen usando las claves que genera Emailify, porque son metadatos del email y no capas de texto de Figma.

Paso 2: selecciona tus emails y los idiomas de destino

Elige los frames de Emailify que quieres localizar y, después, selecciona los idiomas de destino de Locize que vas a importar más adelante.

Deja activada la opción Import Markdown Formatting si el texto de tu email contiene negrita, cursiva, enlaces o saltos de línea que quieras conservar durante todo el proceso de traducción.

Paso 3: sube el texto de referencia a Locize

Haz clic en Upload para enviar el texto de Emailify seleccionado a tu namespace con el idioma de referencia configurado en Locize. Si más adelante actualizas el texto original en Figma, vuelve a subirlo para actualizar las claves correspondientes de Locize.

Paso 4: traduce en Locize

Abre tu proyecto de Locize y traduce o revisa las claves subidas para cada idioma de destino.

Paso 5: importa los emails traducidos en Figma

Vuelve a Emailify, selecciona los idiomas de destino que quieras y haz clic en Import Translations. Emailify asocia las claves traducidas de Locize con los emails originales seleccionados y crea copias de los frames de email para cada idioma importado.

Emailify guarda tu clave de API de Locize en el almacenamiento local del cliente de Figma para tu usuario actual, en lugar de guardarla en el archivo de Figma compartido. Usa una clave de API limitada al proyecto en lugar de un token de acceso personal con permisos más amplios.