Mensagens multilíngues
Depois de adicionar locais ao seu espaço de trabalho, você pode direcionar usuários em diferentes idiomas, tudo dentro de um único push, e-mail, webhook, banner, mensagem no app ou Content Block.
Pré-requisitos
| Recurso | Permissões de usuário obrigatórias |
|---|---|
| Localidades multilíngues | Você precisa dessas permissões para criar e gerenciar localidades multilíngues:
|
| Recurso | Permissões de usuário necessárias |
|---|---|
| Tipos de mensagem | Você precisa destas permissões para adicionar locais e traduções a Campaigns e Canvas:
|
| Recurso | Permissões de usuário necessárias |
|---|---|
| Modelos | Você precisa destas permissões para o tipo de modelo ao qual deseja adicionar locais e traduções:
|
Usar localidades
Etapa 1: Configurar localidades
Antes de adicionar traduções a uma mensagem, você precisa criar as localidades que deseja suportar. As localidades definem as variantes de idioma (e, opcionalmente, de região) disponíveis para o envio de mensagens.
Etapa 2: Marcar o conteúdo para tradução
Envolva o texto que você deseja traduzir com as Liquid tags de tradução {% translation your_id_here %} e {% endtranslation %} e atribua um ID de tag. Os IDs das tags de tradução precisam ser únicos dentro de uma mensagem. Use nomes de ID semânticos que descrevam o texto de forma clara, como {% translation header %}. Se a mensagem incluir Content Blocks, consulte Content Blocks com tradução para saber como a exclusividade se aplica.
Veja um exemplo de mensagem marcada para tradução: {% translation greeting %}Hello!{% endtranslation %}

Destaque o texto que deseja traduzir e use o atalho de teclado Cmd + Alt + L (macOS) ou Ctrl + Alt + L (Windows) para envolvê-lo em tags de tradução.
Esse atalho funciona em todos os canais que suportam mensagens multilíngues, exceto nos editores de arrastar e soltar para e-mail e Content Blocks. Nesses casos, use o botão Adicionar personalização para adicionar tags de tradução.
Localizar URLs
Ao traduzir conteúdo, as URLs exigem um cuidado especial para evitar links quebrados.
URLs padrão (estáticas)
URLs estáticas são inseridas manualmente no editor (por exemplo, https://example.com). Também recomendamos o seguinte:
| Recomendação | Motivo |
|---|---|
Mantenha o protocolo (https://) fora das tags de tradução. Envolva apenas o domínio e o caminho (por exemplo, example.com/en). |
Os tradutores podem alterar ou remover caracteres especiais por engano, quebrando os links. |
Não inclua parâmetros de consulta dentro das tags de tradução (por exemplo, ?utm_source=promo). |
Os tradutores podem alterar ou remover caracteres especiais por engano, resultando em links quebrados. |
Veja uma URL padrão que segue as duas recomendações:
<a href="https://{% translation id_1 %}example.shop.com{% endtranslation %}">Visit our store</a>
URLs geradas por Liquid
Se a sua URL for gerada com Liquid (por exemplo, {% landing_page_url %}), recomendamos o seguinte:
| Recomendação | Motivo |
|---|---|
| Envolva a URL gerada por Liquid em tags de tradução somente se ela precisar ser localizada. | A sintaxe Liquid precisa ser preservada com cuidado para ser renderizada corretamente. |
Não inclua parâmetros de consulta (por exemplo, ?utm_source=promo) dentro das tags de tradução. |
Os tradutores podem alterar ou remover caracteres especiais por engano, resultando em links quebrados. |
Veja uma URL gerada por Liquid que segue as duas recomendações:
<a href="{% translation id_1 %}{% landing_page_url xyz %}{% endtranslation %}">View details</a>

Se você estiver usando o rastreamento de links de e-mail (aliasing de links ou modelos de link), será necessária uma configuração adicional quando as URLs estiverem envolvidas em tags de tradução.
Atributos e estrutura HTML
Envolva em tags de tradução apenas o texto legível por pessoas. Evite envolver atributos HTML (como class, style ou id) ou outros códigos estruturais. Os atributos HTML controlam o layout, o estilo e a funcionalidade. Envolvê-los em tags de tradução pode quebrar a formatação ou os estilos nas versões localizadas da sua mensagem.
Este texto está envolvido corretamente:
<p class="headline" style="color: red;">
{% translation id_1 %}Welcome to our sale{% endtranslation %}
</p>
Texto envolvido incorretamente
Este texto está envolvido incorretamente:
{% translation id_1 %}
<p class="headline" style="color: red;">
Welcome to our sale
</p>
{% endtranslation %}
Etapa 3: Adicionar localidades à sua mensagem
Depois de adicionar as tags de tradução à sua mensagem, selecione Gerenciar idiomas no editor (Idiomas nos editores de arrastar e soltar para e-mail e Content Blocks) e selecione pelo menos uma localidade para a qual deseja adicionar traduções.

Content Blocks com tradução
Content Blocks com tags de tradução se comportam de forma diferente dependendo de o bloco ter ou não suas próprias traduções salvas:
| Estado do Content Block | Onde as traduções são gerenciadas |
|---|---|
| Tags de tradução, mas sem localidades ou traduções salvas | CSV de Gerenciar idiomas da mensagem principal |
| Tags de tradução com localidades e traduções salvas | CSV próprio do Content Block ou API de tradução |
Content Blocks com traduções salvas
Se a sua mensagem contiver Content Blocks que já têm traduções salvas, não é preciso fazer upload dessas traduções novamente. As traduções salvas são aplicadas automaticamente quando o Content Block é adicionado à sua mensagem. Esses blocos mantêm seus próprios IDs de tag, que não precisam ser únicos em relação à mensagem principal. Para saber como salvar traduções no próprio bloco, consulte Salvar traduções em Content Blocks.
No modal Gerenciar idiomas, os Content Blocks com traduções salvas aparecem na lista, junto com as localidades que suportam. Assim, você consegue ver quais partes da sua mensagem já estão localizadas antes de adicionar novas traduções.


Confira se cada Content Block inclui traduções para todas as localidades adicionadas à sua mensagem. Se faltarem traduções em um Content Block para uma das localidades adicionadas, ele será exibido no idioma original para os usuários dessa localidade.
Content Blocks apenas com tags de tradução
Quando um Content Block tem tags de tradução, mas não tem localidades nem traduções salvas, suas tags são tratadas como conteúdo de origem não traduzido na mensagem principal. A exportação de Gerenciar idiomas da mensagem principal inclui essas tags, e o CSV da mensagem principal precisa fornecer as traduções delas. Essas tags precisam ser únicas em relação às outras tags da mensagem principal.
Se você reutilizar um Content Block não traduzido em outra mensagem, essa segunda mensagem também precisará fornecer traduções para as tags do bloco. Para não ter que fornecer traduções em cada mensagem que usa um Content Block, adicione localidades e traduções diretamente ao próprio Content Block.
Etapa 4: Adicionar traduções
Depois de selecionar as localidades, adicione traduções à sua mensagem usando um dos seguintes métodos:

Selecione Baixar modelo para baixar um CSV com uma matriz dos IDs de tradução e das localidades selecionadas.

Para evitar problemas de exibição com caracteres que não sejam do inglês, não use o Excel para o CSV de tradução.
Ao preencher o modelo, traduza apenas o conteúdo de texto de cada localidade. Se houver tags HTML no modelo baixado, mantenha-as inalteradas e traduza apenas o texto dentro das tags.
Por exemplo, se o modelo contiver:
<p style="margin:0;margin-bottom:0">A charming bakery dedicated to crafting artisanal breads.</p>
Traduza apenas o texto A charming bakery dedicated to crafting artisanal breads. e mantenha as tags HTML <p style="margin:0;margin-bottom:0"> e </p> como estão.
Depois, faça upload do arquivo preenchido, e as traduções serão aplicadas à sua mensagem.

Use uma API de tradução de parceiro para gerenciar e atualizar as traduções em Campaigns, Canvas, Content Blocks, modelos de e-mail e modelos de webhook. Isso é útil se você usa um sistema externo de localização ou quer se conectar diretamente a um parceiro de tradução.
Para usar os endpoints de tradução com Canvas, inclua os seguintes parâmetros:
workflow_idstep_idmessage_variation_id

Ao usar a API de tradução com etapas do Canvas criadas depois do lançamento do Canvas, o message_variation_id que você passar para a API ficará vazio ou em branco.
Etapa 5: Fazer a prévia das traduções
Para fazer a prévia da sua mensagem, selecione a opção Usuário multilíngue no menu suspenso Prévia como usuário. Assim, você pode alternar entre diferentes definições de localidade para ver a prévia de todas as traduções da sua mensagem.

Gerenciar traduções
Duplicar etapas do Canvas ou Campaigns e traduções
Quando você duplica uma etapa do Canvas, uma Campaign ou uma variação, as traduções são incluídas. Isso também vale ao copiar entre espaços de trabalho, desde que as localidades estejam definidas no espaço de trabalho de destino. Revise e atualize as traduções sempre que fizer modificações no seu Canvas ou Campaign.
Salvar traduções em Content Blocks
Os Content Blocks oferecem suporte a vários idiomas da mesma forma que as mensagens. Ao criar ou editar Content Blocks, você pode marcar conteúdo para tradução, adicionar localidades e fazer upload de traduções usando um CSV ou a API de tradução.
As traduções salvas continuam associadas ao Content Block. Quando o bloco é adicionado a uma mensagem, as traduções dele são incluídas automaticamente.
Mensagens da direita para a esquerda
Ao preencher o arquivo de tradução para idiomas escritos da direita para a esquerda (como o árabe), envolva a tradução com span para que ela seja formatada corretamente:
{% translation your_id_here %}<span dir='rtl'>default text</span>{% endtranslation %}
Rastreamento de links de e-mail
Em Campaigns de e-mail, a Braze rastreia links adicionando informações de rastreamento (parâmetros de consulta) a cada URL. Esse comportamento oferece suporte tanto ao aliasing de links quanto ao modelo de links.
Quando uma URL está envolvida em tags de tradução, a Braze pode não conseguir determinar onde adicionar essas informações de rastreamento. Para que isso funcione corretamente, você precisa incluir um caractere especial no final da URL para indicar onde o rastreamento deve ser adicionado.
As URLs usam dois caracteres especiais para controlar esse funcionamento:
?adiciona rastreamento a uma URL que ainda não o tem.&adiciona rastreamento extra se já houver um?na URL. Uma URL só pode conter um?.
| URL | Contém ? |
Descrição | Exemplo |
|---|---|---|---|
| URL padrão | Não | Adicione ? depois da tag de tradução de fechamento se a URL ainda não contiver um. |
<a href="https://{% translation id_1 %}example.com{% endtranslation %}?">Shop Now</a> |
| URL padrão | Sim | Use & no final da URL (depois da tag de tradução de fechamento) se ela já contiver ?. |
<a href="https://{% translation id_1 %}example.com{% endtranslation %}?ref=4&">Shop Now</a> |
| Gerada por Liquid | Não | Use ? depois das tags de tradução de fechamento se a URL gerada ainda não contiver um. |
<a href="{% translation id_1 %}{{ product_url }}{% endtranslation %}?">Shop Now</a> |
| Gerada por Liquid | Sim | Use & depois da tag de tradução de fechamento se a URL gerada já contiver um ?. |
<a href="{% translation id_1 %}{% landing_page_url xyz %}{% endtranslation %}&">Shop Now</a> |
Configurações de idioma e acessibilidade
Comece por Idioma de acessibilidade em Acessibilidade para entender o contexto das WCAG, o comportamento por canal e editor (incluindo landing pages) e as configurações de Acessibilidade no nível da mensagem.
Ao usar mensagens em vários idiomas, alinhe o idioma de acessibilidade a cada localidade para que os envios localizados declarem o idioma adequado.
Configurar o idioma de acessibilidade
Você pode definir o idioma de acessibilidade em dois níveis:
Nível da mensagem
No nível da mensagem, defina o idioma de acessibilidade na seção Acessibilidade das configurações da mensagem. Para saber como selecionar um idioma, usar Liquid e conhecer as limitações por canal, consulte Idioma de acessibilidade.
Nível da localidade
Em mensagens em vários idiomas, defina o idioma de acessibilidade de cada localidade em Configurações de localização. Você pode usar {{accessibility_language}} na seção Acessibilidade para que o idioma do documento ou do cartão corresponda aos valores dessas localidades.
Se esse token aparece por padrão em novas mensagens depende do canal e do editor. Por exemplo, mensagens no app e banners se comportam de forma diferente de landing pages e e-mails criados no editor de arrastar e soltar. Consulte Idioma de acessibilidade para mais detalhes.
Perguntas frequentes
Quais são os limites para tags de tradução?
Ao usar tags de tradução, os seguintes limites se aplicam:
- Cada mensagem pode ter até 200 tags de tradução.
- Cada texto padrão (o conteúdo entre as tags de tradução) pode ter até 2.000 caracteres.
- As traduções por localidade podem ter até 409.600 bytes (aproximadamente 409,6 KB).
Por que estou recebendo um erro ao baixar modelos de e-mail multilíngues?
Se você encontrar erros ao baixar modelos de e-mail multilíngues, as tags de tradução podem estar envolvendo atributos HTML ou estilos CSS que entram em conflito com a forma como a Braze processa o corpo dos e-mails.
A Braze trata o corpo em HTML e o corpo em texto simples como componentes separados da mesma mensagem. Quando as tags de tradução incluem referências href e estilos CSS, isso pode gerar tags conflitantes que impedem o download correto do modelo.
Para resolver isso:
- Exclua referências
hrefe estilos CSS das tags de tradução. - Envolva apenas o conteúdo de texto legível por humanos nas tags de tradução, conforme descrito em Atributos e estrutura HTML.
- Para URLs, siga as orientações em Localizar URLs.
Posso fazer uma alteração no texto traduzido em uma das minhas localidades?
Sim. Primeiro, faça a edição no CSV. Depois, faça upload do arquivo novamente para alterar o texto traduzido.
A Braze fornece traduções?
Não. Você precisa fornecer suas próprias traduções, seja fazendo upload de um CSV ou usando a API de tradução.
Posso aninhar tags de tradução?
Não.
Posso envolver mensagens HTML inteiras em uma tag de tradução?
Não. Como prática recomendada, envolva apenas o texto legível por humanos ou o conteúdo que precisa ser localizado. Isso ajuda a evitar problemas de formatação, links quebrados ou falhas em outros elementos que não são texto.
Além disso, considere envolver trechos menores de texto que tenham relação semântica entre si. Assim, você cria traduções precisas e evita limitações de performance ou tamanho.
Posso fazer uma alteração no texto traduzido em uma das minhas localidades?
Sim. Se estiver usando um CSV, primeiro faça a edição no arquivo. Depois, faça upload dele novamente para alterar o texto traduzido. Se estiver usando a API de tradução, use os endpoints de atualização para fazer as alterações.
Quais validações ou verificações extras a Braze faz?
| Cenário | Validação na Braze |
|---|---|
| Uma mensagem contém dois ou mais IDs de tradução correspondentes que mapeiam para textos diferentes. | Não será feito o download deste arquivo de tradução. |
| Um arquivo de tradução não contém um ou mais IDs de tags de tradução. | Não será feito o upload deste arquivo de tradução. |
| Um arquivo de tradução contém localidades que não existem na mensagem. | Não será feito o upload deste arquivo de tradução. |
| As tags de tradução precisam ser adicionadas a uma mensagem antes do download do modelo de tradução. | Não será feito o download deste arquivo de tradução. |
| As tags de tradução encontradas no arquivo enviado não existem na sua mensagem. | As traduções extras não serão salvas na mensagem. |
Uma mensagem contém uma ou mais Liquid tags quebradas. Para abrir tags, use {% translation your_id_here %}. Para fechar tags de tradução, use {% endtranslation %}. |
Não será feito o download deste arquivo de tradução. |
| Um arquivo de tradução contém um texto padrão que não corresponde ao que está na mensagem. | As traduções são adicionadas, mas o texto original da mensagem não é atualizado. |
| Uma ou mais localidades de uma mensagem foram excluídas nas configurações e não existem mais. | As traduções já adicionadas continuam existindo na mensagem. Se forem excluídas da mensagem, as traduções serão perdidas. |
| As tags de tradução contêm URLs completas ou URLs geradas por Liquid. | As tags de tradução que contêm URLs são identificadas caso ocorram problemas com links quebrados ou com o rastreamento de links. |
| As tags de tradução incluem parâmetros de consulta. | As tags de tradução que contêm parâmetros de consulta são identificadas caso ocorram problemas com links quebrados ou com o rastreamento de links. |
| As tags de tradução contêm atributos ou estruturas HTML. | As tags de tradução que contêm atributos ou estruturas HTML são identificadas caso ocorram problemas com estilos e formatação. |