Utiliser l’API Locize avec Emailify

Si vous utilisez Locize, Emailify peut envoyer les textes source de vos designs d’email vers un namespace Locize, puis réimporter les variantes traduites dans Figma.

Avant de commencer

Il vous faut :

• un projet Locize avec une langue de référence et au moins une langue cible ;
• une version et un namespace existants pour les traductions de vos emails ;
• une clé API Locize limitée au projet.

Étape 1 : connecter votre projet Locize

1. Cliquez sur le bouton Localize dans Emailify.
2. Choisissez Locize API dans les options de localisation.
3. Saisissez votre Project ID et votre API Key.
4. Saisissez la Version Locize à utiliser, par exemple latest ou production.
5. Saisissez le Namespace qui contient les traductions de vos emails, par exemple emails.
6. Choisissez l’option Standard CDN ou Pro CDN qui correspond à votre projet Locize.
7. Sous String Key Source, choisissez comment Emailify doit créer les clés de chaîne Locize.

Une fois connecté, Emailify affiche la langue de référence et les langues cibles configurées dans votre projet Locize.

Vérifiez que le type de CDN correspond à votre projet Locize. Le Standard CDN est public et utilise un cache fixe d’une heure, tandis que le Pro CDN permet la publication privée et un cache configurable. Consultez la comparaison des CDN de Locize pour en savoir plus.

Choisir comment les clés de chaîne Locize sont créées

Figma Node ID (Default) conserve le comportement existant d’Emailify et utilise les ID de nœud Figma générés comme clés Locize. Les workflows Locize existants continuent d’utiliser cette option tant que vous ne la modifiez pas.

Choisissez Figma Text Layer Name si les noms de vos calques de texte Figma correspondent déjà aux clés de chaîne de votre namespace Locize. Emailify conserve le nom de calque complet, points compris : un calque nommé templates.assistant_invited.h01 utilise donc exactement cette clé Locize.

Chaque calque de texte inclus doit avoir un nom, et ce nom doit être unique dans l’ensemble des emails sélectionnés. Emailify interrompt l’envoi ou l’import et signale les clés en double avant d’envoyer la moindre chaîne source à Locize. Les clés des liens et des textes alternatifs d’image reprennent le nom du calque de texte ou d’image, suivi du suffixe _LINK ou _ALT_TEXT d’Emailify. Les lignes d’objet et de texte d’aperçu (preheader) continuent d’utiliser les clés générées par Emailify, car il s’agit de métadonnées de l’email et non de calques de texte Figma.

Étape 2 : sélectionner vos emails et les langues cibles

Choisissez les frames Emailify à localiser, puis sélectionnez les langues cibles Locize que vous importerez plus tard.

Laissez Import Markdown Formatting activé si le texte de votre email contient du gras, de l’italique, des liens ou des retours à la ligne que vous voulez conserver tout au long de l’aller-retour de traduction.

Étape 3 : envoyer le texte de référence vers Locize

Cliquez sur Upload pour envoyer le texte Emailify sélectionné dans votre namespace, avec la langue de référence configurée dans Locize. Si vous modifiez plus tard le texte source dans Figma, envoyez-le de nouveau pour mettre à jour les clés Locize correspondantes.

Étape 4 : traduire dans Locize

Ouvrez votre projet Locize, puis traduisez ou relisez les clés envoyées pour chaque langue cible.

Étape 5 : importer les emails traduits dans Figma

Revenez dans Emailify, sélectionnez les langues cibles souhaitées, puis cliquez sur Import Translations. Emailify fait correspondre les clés Locize traduites aux emails source sélectionnés et crée des copies des frames d’email pour chaque langue importée.

Emailify enregistre votre clé API Locize dans le stockage client local de Figma pour votre utilisateur actuel, et non dans le fichier Figma partagé. Utilisez une clé API limitée au projet plutôt qu’un jeton d’accès personnel aux droits plus larges.