Usar a API do Locize com o Emailify

Se você usa o Locize, o Emailify pode fazer o upload dos textos de origem dos seus designs de e-mail para um namespace do Locize e importar as variantes traduzidas de volta para o Figma.

Antes de começar

Você vai precisar de:

• Um projeto do Locize com um idioma de referência e pelo menos um idioma de destino.
• Uma versão e um namespace já existentes para as traduções dos seus e-mails.
• Uma chave de API do Locize com escopo de projeto.

Etapa 1: conectar seu projeto do Locize

1. Clique no botão Localize no Emailify.
2. Escolha Locize API nas opções de localização.
3. Insira seu Project ID e sua API Key.
4. Insira a Version do Locize que você quer usar, como latest ou production.
5. Insira o Namespace que contém as traduções dos seus e-mails, como emails.
6. Escolha a opção Standard CDN ou Pro CDN que corresponde ao seu projeto do Locize.
7. Em String Key Source, escolha como o Emailify deve criar as chaves de string do Locize.

Depois que o Emailify se conecta, ele mostra o idioma de referência e os idiomas de destino configurados no seu projeto do Locize.

Confira se o tipo de CDN corresponde ao seu projeto do Locize. A Standard CDN é pública e usa um cache fixo de uma hora, enquanto a Pro CDN permite publicação privada e cache configurável. Veja a comparação de CDNs do Locize para mais detalhes.

Escolher como as chaves de string do Locize são criadas

Figma Node ID (Default) mantém o comportamento atual do Emailify e usa os IDs de nó gerados pelo Figma como chaves do Locize. Os fluxos de trabalho existentes com o Locize continuam usando essa opção, a menos que você a altere.

Escolha Figma Text Layer Name quando os nomes das suas camadas de texto do Figma já correspondem às chaves de string do seu namespace do Locize. O Emailify preserva o nome completo da camada, inclusive os pontos, então uma camada chamada templates.assistant_invited.h01 usa exatamente essa chave do Locize.

Todos os nomes das camadas de texto incluídas precisam existir e ser únicos entre os e-mails selecionados. O Emailify interrompe o upload ou a importação e aponta as chaves duplicadas antes de enviar qualquer string de origem ao Locize. As chaves de links e de texto alternativo de imagens usam o nome da camada de texto ou de imagem com o sufixo _LINK ou _ALT_TEXT do Emailify. As linhas de assunto e de preheader continuam usando as chaves geradas pelo Emailify, porque são metadados do e-mail, e não camadas de texto do Figma.

Etapa 2: selecionar seus e-mails e as localidades de destino

Escolha os frames do Emailify que você quer localizar e selecione os idiomas de destino do Locize que você vai importar depois.

Mantenha a opção Import Markdown Formatting ativada se os textos do seu e-mail tiverem negrito, itálico, links ou quebras de linha que você quer preservar durante o ciclo de tradução.

Etapa 3: fazer upload do texto de referência para o Locize

Clique em Upload para enviar o texto selecionado do Emailify para o seu namespace, usando o idioma de referência configurado no Locize. Se você atualizar o texto de origem no Figma depois, faça o upload de novo para atualizar as chaves correspondentes no Locize.

Etapa 4: traduzir no Locize

Abra seu projeto do Locize e traduza ou revise as chaves enviadas para cada idioma de destino.

Etapa 5: importar os e-mails traduzidos para o Figma

Volte ao Emailify, selecione as localidades de destino que você quer e clique em Import Translations. O Emailify associa as chaves traduzidas do Locize aos e-mails de origem selecionados e cria frames de e-mail clonados para cada localidade importada.

O Emailify armazena sua chave de API do Locize no armazenamento local do cliente do Figma, para o seu usuário atual, em vez de salvá-la no arquivo compartilhado do Figma. Use uma chave de API com escopo de projeto em vez de um token de acesso pessoal mais abrangente.