Phrase
O Phrase é uma plataforma de localização. Ele traduz conteúdo, automatiza fluxos de trabalho de tradução e gera relatórios sobre esse conteúdo para que você alcance pessoas em diferentes idiomas e culturas.
Essa integração é mantida pelo Phrase.
Sobre a integração
Traduza o conteúdo de Campaigns e Canvas da Braze e receba as traduções concluídas de volta na mesma mensagem. A Phrase relata que enviar e-mails para tradução a partir da Braze pode reduzir o trabalho de preparação em até 98% em comparação com outras integrações.
Na Phrase, fluxos de trabalho automatizados, traduções por IA que seguem a identidade da sua marca e colaboração com provedores de tradução trazem o conteúdo de volta para a Braze. Para e-mails em HTML, os tradutores visualizam uma prévia para que a tradução corresponda ao layout.
A integração ajuda você a:
- Pular importações, exportações e configuração manual de projetos
- Reduzir o tempo entre o rascunho e o lançamento
- Manter as traduções alinhadas com a voz da sua marca
- Verificar se as traduções se encaixam no layout da mensagem
Canais compatíveis
A integração traduz o seguinte conteúdo em Campaigns e Canvas, no editor de arrastar e soltar ou no editor de HTML tradicional:
- Push
- Mensagens no app
- Banners
Demonstração
Para ver um passo a passo, assista à demonstração da integração entre Phrase e Braze.
Pré-requisitos
| Requisito | Descrição |
|---|---|
| Conta na Phrase | Uma conta na Phrase com o complemento de integração com a Braze. |
| Chave da API REST da Braze | Uma chave da API REST da Braze com as seguintes permissões: - templates.translations.get- templates.translations.update- templates.email.list- campaigns.list- campaigns.details- campaigns.translations.get- campaigns.translations.update- canvas.list- canvas.details- canvas.translations.get- canvas.translations.updateCrie essa chave no dashboard da Braze em Configurações > APIs e identificadores > Chaves de API. Para saber mais, consulte Criação de chaves da API REST. |
| Endpoint REST da Braze | URL do seu endpoint REST. Seu endpoint depende da URL da Braze para a sua instância. |
Integração
Etapa 1: Adicionar locais na Braze
Antes de conectar o Phrase, adicione os locais que você deseja traduzir.
- Na Braze, acesse Configurações > Configurações de localização.
- Selecione Adicionar local e adicione cada idioma que você deseja suportar. Para saber mais, consulte Configurações de localização.
- Nomeie cada local com o mesmo código que você usa no Phrase e use underscores (por exemplo,
en_US,de_DEoufr_FR).

A Braze armazena a chave do local como o nome do local em letras minúsculas. Um local chamado en_US é armazenado como en_us. Use essa chave de local no Phrase.
Etapa 2: Criar uma chave da API REST da Braze
O Phrase usa uma chave da API REST para ler suas mensagens e gravar as traduções de volta.
- Na Braze, acesse Configurações > APIs e identificadores > Chaves de API.
- Selecione Criar chave de API.
- Insira um nome para a chave (por exemplo,
Phrase integration). - Selecione as permissões listadas em Pré-requisitos.
- Copie a chave de API e a URL do endpoint REST (por exemplo,
https://rest.iad-03.braze.com).
Etapa 3: Configurar o conector no Phrase TMS
- No Phrase, acesse Phrase TMS > Settings > Connectors e selecione New.
- Selecione Braze como o tipo de conector.
- Insira um nome para o conector.
- Cole a URL do endpoint REST e a chave da API REST da Etapa 2.
- Selecione Test connection. Uma marca de verificação aparece quando a conexão é bem-sucedida.
- (Opcional) Em Show optional settings, insira os IDs das tags de tradução se quiser importar apenas o conteúdo da Braze que utiliza esses IDs.
- Selecione Save.
Etapa 4: Marcar conteúdo para tradução
O Phrase identifica conteúdo traduzível com tags de tradução Liquid. Cada ID de tag deve ser único na mensagem. Para saber mais, consulte Mensagens multilíngues.
Editor de HTML
Envolva o conteúdo que você deseja traduzir. Isso se aplica a e-mails, push e mensagens no app compostas no editor de HTML.
Para o conteúdo do corpo:
{% translation body %}
Your email content here...
{% endtranslation %}
Para o assunto e o pré-cabeçalho:
{% translation subject %}Your subject{% endtranslation %}
{% translation preheader %}Your preheader{% endtranslation %}
Editor de arrastar e soltar
Adicione a mensagem de arrastar e soltar a uma Campaign ou Canvas antes de importá-la. O Phrase importa mensagens de arrastar e soltar de Campaigns e Canvas.
- Abra a mensagem da Campaign ou Canvas.
- Adicione um bloco de Parágrafo no topo da mensagem contendo
{% translation body %}. - Adicione um bloco de Parágrafo na parte inferior da mensagem contendo
{% endtranslation %}.
Escolher locais na mensagem
- Salve a mensagem.
- Abra a mensagem novamente. Selecione Manage languages (Languages no editor de arrastar e soltar) e adicione os locais que correspondem ao seu projeto no Phrase.
Etapa 5: Importar conteúdo e exportar traduções
Importar
No Phrase TMS, acesse Jobs > New > Import from online repository. Selecione o conector da Braze e, em seguida, selecione os modelos, Campaigns ou Canvas para traduzir. Use essa importação para testar a conexão. Após a validação, você pode importar conteúdo com o Automated Project Creation.
Traduzir
Para um teste, traduza no editor de tradução assistida por computador (CAT) do Phrase. Para e-mails em HTML, use o Live Preview. Você pode adicionar tradução por IA, pontuação de qualidade e uma etapa de revisão humana ao fluxo de trabalho.
Exportar
Para enviar as traduções de volta para a Braze, selecione Export to online repository ou configure a automação para entregar as traduções quando estiverem prontas.
Pré-visualizar na Braze
Abra a mensagem, acesse Prévia e teste e selecione Usuário multilíngue. Alterne entre os locais para verificar as traduções. Para saber mais, consulte Pré-visualizar personalização.
Solução de problemas
Por que meu modelo não está listado no Phrase TMS?
- Adicione pelo menos um par de tags de tradução. O Phrase lista as mensagens que incluem essas tags.
- Use um ID de tradução diferente para cada par de tags na mensagem. Se o mesmo ID aparecer duas vezes (por exemplo, no assunto e no corpo), a Braze retorna um erro e o Phrase omite a mensagem.
- Se você inseriu um ID de tag de tradução nas configurações do conector, o Phrase importa o conteúdo que usa esse ID.