Braze (TMS)

O conteúdo de toda a Central de Ajuda é traduzido automaticamente de inglês pelo Phrase Language AI.

Disponível para

Planos Team, Professional, Business e Enterprise

Entre em contato com Comércio para perguntas de licenciamento.

Disponível para

Planos Ultimate e Enterprise (legado)

Entre em contato com o departamento de Vendas para perguntas sobre o licenciamento.

O Braze Connector permite que profissionais de marketing localizem campanhas, canvases e modelos do Braze sem trabalho manual. Ao conectar o Phrase TMS à API multilíngue do Braze, o conteúdo multilíngue é trocado automaticamente entre ambas as plataformas para tradução.

Esta integração foi projetada para profissionais de marketing, não para desenvolvedores. Ela elimina a necessidade de edições de código, exportações de arquivos ou duplicação de modelos.

O conector inclui uma funcionalidade de mapeamento unificado de idiomas que alinha automaticamente os códigos de idioma do Phrase TMS aos códigos de idioma do Braze. Variações comuns, como diferenças de maiúsculas e minúsculas (de-DE vs de-de) e formatos de separadores (en-US vs en_us), são resolvidas automaticamente, reduzindo a necessidade de configuração manual. Os administradores podem definir mapeamentos personalizados nas configurações do conector para códigos de localidade exclusivos ou não padrão, que terão prioridade sobre o mapeamento automático.

Alertas automáticos podem ser configurados para que os tradutores sejam notificados quando um novo trabalho chegar e os profissionais de marketing recebam uma notificação quando esse trabalho for concluído.

O Braze exige que cada tradução tenha um ID de tag exclusivo.

Guia de localização do Braze

Nota

Devido a melhorias constantes, a interface do usuário pode não ser exatamente a mesma que é apresentada no vídeo.

Estrutura de conteúdo do Braze

Modelos:

Layouts de mensagem reutilizáveis — e-mails, mensagens no aplicativo ou notificações push — que servem como base para suas campanhas e canvases.
Campanhas:

Usadas para enviar mensagens direcionadas a públicos por meio de um ou mais canais (e-mail, push ou no aplicativo). As campanhas podem ser únicas, recorrentes ou acionadas, oferecendo suporte a comunicações personalizadas e multicanais.
Canvases:

Jornadas do cliente com várias etapas que enviam mensagens por vários canais usando gatilhos, segmentos de público e lógica de temporização. Os canvases são ideais para orquestrar fluxos de engajamento automatizados baseados em comportamento.
Blocos de conteúdo:

Trechos de conteúdo reutilizáveis que podem ser incorporados em modelos, campanhas e canvases.

Casos de uso de localização

Localização em nível de modelo

Localize modelos antes de vinculá-los a campanhas ou canvases.

Limitações:
- Suporta apenas modelos HTML para e-mail, push e mensagens no aplicativo (não modelos de arrastar e soltar).
- Modelos de arrastar e soltar são suportados por meio de Campanhas e Canvases.
Localização em nível de campanha e canvas

Ao trabalhar em Campanhas ou Canvases, tipos de mensagem adicionais podem ser localizados, incluindo modelos de arrastar e soltar.

Campanhas e Canvases servem como a camada de entrega. Embora modelos de arrastar e soltar não possam ser localizados diretamente da Biblioteca de Modelos, eles podem ser localizados quando usados dentro de Campanhas ou Canvases. Isso significa que todos os tipos de mensagem podem ser traduzidos na camada apropriada.

Limitações

Limitação	Descrição	Solução alternativa
Modelos de arrastar e soltar	Não visível como um modelo	Localize os modelos por meio de Campanhas ou Canvases, e eles ficarão visíveis no Phrase TMS
Incompatibilidades de localidade	Podem causar erros na criação de trabalhos	Mantenha os códigos de localidade consistentes com sublinhados
Permissões ausentes	Podem bloquear a sincronização	Certifique-se de criar novas chaves de API, com acesso fornecido para Template, Canvas e Campaign

Casos de uso

Existem vários casos de uso para o conector:

Os gerentes de projetos podem adicionar arquivos diretamente a projetos a partir de um repositório online.
Configure o portal do solicitante para permitir que os solicitantes adicionem arquivos às solicitações diretamente do repositório online.
Use a criação automatizada de projetos (APC) para que novos projetos sejam criados automaticamente quando for detectada uma alteração no conteúdo de documentos monitorados ou de uma pasta monitorada.
- Apenas conteúdo traduzível novo ou atualizado aciona a APC; a exportação de traduções ou alterações em conteúdo não traduzível não criam novos projetos.
A API do conector pode ser usada para automatizar etapas que, de outra forma, seriam realizadas manualmente por meio da interface do usuário. Os webhooks podem ser usados para fazer com que sistemas de terceiros sejam notificados sobre determinados eventos (por exemplo, uma alteração do estado do trabalho).

Configurações multilíngues do Braze

Faça login na sua conta do Braze.
Navegue até APIs and Identifiers em Setttings no Console do Desenvolvedor.
Selecione Opt in to Braze IP allowlisting if you plan to make Braze-to-Braze webhooks.

Se a restrição for necessária:
1. Navegue até Templates no Console do Desenvolvedor.
2. Abra as opções de Templates e selecione templates.translations.get e templates.translations.update.
Crie uma nova Rest API Key.

Esta chave é necessária para a configuração do conector.

A chave da API REST está vinculada à conta de usuário do Braze que a gerou.

Certifique-se de que estas permissões estejam selecionadas:
- Modelos
- Canvases
- Campanhas
Se uma chave tiver sido gerada para o conector legado, ela não funcionará mais.
Copie a Braze REST Endpoint URL.
Certifique-se de que as localidades de idiomas em Workspace Settings - Multi-Language Locale Setttings estejam no formato padrão com um sublinhado. Hifens ou outros formatos causarão erros.
Para todos os modelos, campanhas e etapas de canvas que exigem tradução, certifique-se de que a opção multilíngue esteja configurada para todas as localidades necessárias, incluindo a localidade de origem.

Configurações do Phrase TMS

Na página de configurações role para baixo até a seção de Integrações.
Clique em Conectores.

A página Conectores é aberta.
Clique em Novo conector.

A página Criar conector é aberta.
Altere o Type para Braze e forneça um nome para o conector.
Selecione a URL do endpoint da API REST do Braze na lista suspensa.
Forneça a chave da API REST encontrada em Braze Settings → APIs and Identifiers → API Keys.
Clique em Testar conexão.
- Se a conexão for bem-sucedida, uma pequena marca de verificação aparecerá ao lado do botão Test connection.
Clique em Show optional settings para configurar opções adicionais:
- Códigos para tradução
  
  Forneça os IDs das tags do conteúdo a ser importado. Os códigos precisam corresponder aos do Braze.
- Mapeamento de idiomas
  
  Clique em Add language mapping para mapear os idiomas do Braze para os idiomas do TMS.
  
  Cada idioma do Phrase pode ser mapeado para apenas um código de localidade do Braze por vez. Se dois códigos do Braze (por exemplo, da e visitor_da) forem mapeados para o mesmo idioma do Phrase, o conector seleciona um dos códigos automaticamente e não há como controlar qual código é escolhido. O trabalho para o código que não foi selecionado falha ao ser criado, e o conector registra um erro para esse idioma.
  
  A criação do trabalho exige que a localidade de origem e cada localidade de destino configurada no conector ou no mapeamento de idiomas da APC já existam no item individual de canvas ou campanha do Braze. Configurar uma localidade no nível do conector ou da APC não é suficiente. Se uma localidade estiver ausente de um canvas, a importação falhará com um erro indicando que a localidade de origem ou de destino não está configurada no item do Braze. Adicione as localidades ausentes diretamente ao canvas no Braze antes de tentar a importação novamente.
- Filtro de recência da importação
  
  Defina maximum days since last update para importar apenas o conteúdo atualizado dentro do número de dias especificado. Defina como 0 para importar todo o conteúdo, independentemente de quanto tempo tenha passado desde a última atualização.
Clique em Gravar.

O conector está adicionado à lista na página de conectores.

Localização de modelos de e-mail HTML

Ao usar o editor de HTML do Braze, o conteúdo pode ser localizado diretamente no nível do modelo. Essa opção é ideal para e-mails reutilizáveis.

Para localizar um modelo de e-mail HTML, siga estas etapas:

Em Template - Email Templates - HTML Editor, abra o modelo.
Adicione tags de tradução:
- Envolva a área traduzível em tags do Phrase:
```
{% translation phrase_body %}
...your email content here...
{% endtranslation %}
```
  Dica
  
  Coloque a tag de abertura na primeira linha e a tag de fechamento na última linha do editor de HTML. As frases não precisam ser envolvidas individualmente; o conversor do Phrase analisa automaticamente tudo entre as duas tags e prepara o conteúdo para tradução no espaço de trabalho do Phrase TMS. A formatação HTML, os links e o estilo permanecem totalmente intactos na versão localizada.
- Para traduzir o Assunto e o Pré-cabeçalho, envolva-os individualmente:
```
{% translation phrase_subject %}Subject text{% endtranslation %}
{% translation phrase_preheader %}Preheader text{% endtranslation %}
```
Salve o modelo.
Reabra o modelo, selecione Multilíngue e escolha as localidades de origem e destino. Certifique-se de que as localidades sejam as mesmas da configuração do Phrase.
Salve o modelo.
No Phrase TMS, selecione Importar da integração - Braze - Modelos.

O modelo HTML aparece como um trabalho de tradução.
Traduza e revise.
Após a aprovação, exporte as traduções de volta para o Braze.

As versões localizadas aparecem automaticamente nas respectivas localidades. Use Pré-visualizar e testar - Usuário multilíngue para verificar a exibição e o layout.

Como trabalhar com campanhas e canvas

Nota

A visualização em contexto não está disponível no editor CAT para trabalhos importados de campanhas ou canvas. O Phrase TMS recebe vários e-mails como parte desses tipos de conteúdo e não pode mesclá-los em um único HTML para renderização, portanto, a guia Pré-visualização não aparece.

Para usar a visualização em contexto, localize o modelo de e-mail diretamente.

Ao localizar dentro de campanhas ou canvases, o fluxo de trabalho difere ligeiramente. Em vez de localizar um modelo HTML independente, trabalha-se com ativos de campanhas publicadas ou em rascunho, que podem incluir conteúdo de arrastar e soltar.

As localizações não vêm da biblioteca de modelos, mas são feitas diretamente nas campanhas ou nos canvas.
Os modelos de arrastar e soltar podem ser localizados quando usados nesses contextos.
Todos os tipos de mensagem (e-mail, notificações push e mensagens no aplicativo) podem ser localizados se estiverem envolvidos por tags do Phrase.

Para trabalhar com uma campanha ou um canvas, siga estas etapas:

Em Campanhas ou Canvas, abra o ativo necessário.
Adicione tags de tradução:
- Se estiver usando o editor HTML
  Envolva a área traduzível em tags do Phrase:
  
  {% translation phrase_body %} ...your email content here... {% endtranslation %}
  
  Dica
  
  Coloque a tag de abertura na primeira linha e a tag de fechamento na última linha do editor de HTML. As frases não precisam ser envolvidas individualmente; o conversor do Phrase analisa automaticamente tudo entre as duas tags e prepara o conteúdo para tradução no espaço de trabalho do Phrase TMS. A formatação HTML, os links e o estilo permanecem totalmente intactos na versão localizada.
  
  Para traduzir o Assunto e o Pré-cabeçalho, envolva-os individualmente:
  
  {% translation phrase_subject %}Subject text{% endtranslation %} {% translation phrase_preheader %}Preheader text{% endtranslation %}
  - Para e-mails de arrastar e soltar, adicione um bloco Parágrafo na parte superior e outro na parte inferior do e-mail. Coloque a tag de abertura {% translation phrase_body %} no bloco superior e a tag de fechamento {% endtranslation %} no bloco inferior. Isso cobre todo o e-mail; não é necessário envolver cada frase individualmente.
Marcar para tradução

Se o uso da tag estiver configurado no nível do conector, marque a campanha ou o canvas com a tag de tradução.
Importar para o Phrase TMS

No Phrase TMS, vá para Importar da integração - Braze - Campanhas/Canvas. As campanhas marcadas aparecem para seleção.

Antes de importar, certifique-se de que a localidade de origem e todas as localidades de destino estejam adicionadas à campanha ou ao canvas no Braze (configurações de vários idiomas) e de que a localidade de origem contenha o conteúdo de origem. Se uma localidade de destino estiver ausente no item, a importação falhará com um erro no histórico do APC, mesmo que o formato de localidade configurado no conector esteja correto. Se a localidade de origem estiver ausente ou vazia, a mensagem será omitida do trabalho sem gerar erro.
Traduzir e revisar

Os linguistas traduzem no espaço de trabalho do Phrase. O HTML e a formatação são preservados automaticamente.
Exportar e visualizar

Assim que terminar, exporte a versão localizada de volta para o Braze. Use Pré-visualizar e testar - Usuário multilíngue para alternar entre localidades e confirmar.

Braze legado (TMS)

Disponível para

Planos Team, Professional, Business e Enterprise

Entre em contato com Comércio para perguntas de licenciamento.

Disponível para

Planos Ultimate e Enterprise (legado)

Entre em contato com o departamento de Vendas para perguntas sobre o licenciamento.

Importante

O conector Braze (legado) será descontinuado em 30 de novembro de 2026. Novas instâncias deste conector podem ser criadas até 17 de agosto de 2026. Migre para o novo conector antes da data de descontinuação.

Consulte Descontinuação do Conector Legado para obter um guia de migração completo.

Com a integração do Phrase TMS com o Braze, é possível aumentar o engajamento dos clientes e impulsionar o crescimento em novos mercados por meio de uma localização integrada. A integração permite que os usuários do Braze traduzam modelos de e-mail e blocos de conteúdo.

Elementos de conteúdo traduzíveis:

Modelos de e-mail criados com o editor HTML
Blocos de conteúdo

Nota

Devido a melhorias constantes, a interface do usuário pode não ser exatamente a mesma que é apresentada no vídeo.

Casos de uso

Existem vários casos de uso para o conector:

Os gerentes de projetos podem adicionar arquivos diretamente a projetos a partir de um repositório online.
Configure o portal do solicitante para permitir que os solicitantes adicionem arquivos às solicitações diretamente do repositório online.
Use a criação automatizada de projetos (APC) para criar novos projetos automaticamente quando for detectada uma alteração no conteúdo de documentos monitorados ou de uma pasta monitorada.
- Apenas conteúdo traduzível novo ou atualizado aciona a APC; a exportação de traduções ou as alterações em conteúdo não traduzível não criam novos projetos.
A API do conector pode ser usada para automatizar etapas que, de outra forma, seriam realizadas manualmente por meio da interface do usuário. Os webhooks podem ser usados para fazer com que sistemas de terceiros sejam notificados sobre determinados eventos (por exemplo, uma alteração do estado do trabalho).

Configurações do Braze

Faça login na sua conta do Braze.
Acesse o Console do Desenvolvedor e clique em Configurações da API.
Crie uma nova chave de API REST.

Esta chave é necessária para a configuração do conector.
Copie o Braze REST Endpoint URL.

Configurações do Phrase TMS

Na página de configurações role para baixo até a seção de Integrações.
Clique em Conectores.

A página Conectores é aberta.
Clique em Novo conector.

A página Criar conector é aberta.
Altere o Type para Braze e forneça um nome para o conector.
Selecione a Braze REST Endpoint URL na lista suspensa.
Forneça a chave da API REST encontrada em Braze Settings → APIs and Identifiers → API Keys.
Clique em Testar conexão.
- Se a conexão for bem-sucedida, uma pequena marca de verificação aparecerá ao lado do botão Test connection.
Clique em Show optional settings para configurar opções adicionais:
- Códigos para tradução
  
  Forneça os IDs de tag para o conteúdo a ser importado. Os códigos precisam corresponder aos do Braze.
- Mapeamento de idiomas
  
  Clique em Add language mapping para mapear os idiomas do Braze para os idiomas do TMS.
  
  Cada idioma do Phrase pode ser mapeado para apenas um código de localidade do Braze por vez. Se dois códigos do Braze (por exemplo, da e visitor_da) forem mapeados para o mesmo idioma do Phrase, o conector seleciona um dos códigos automaticamente e não há como controlar qual código é escolhido. O trabalho para o código que não foi selecionado falha ao ser criado, e o conector registra um erro para esse idioma.
  
  A criação do trabalho exige que a localidade de origem e todas as localidades de destino configuradas no conector ou no mapeamento de idiomas da APC já existam no respectivo item de campanha ou canvas do Braze. Configurar uma localidade no nível do conector ou do APC não é suficiente. Se uma localidade estiver ausente de um canvas, a importação falhará com um erro indicando que a localidade de origem ou de destino não está configurada no item do Braze. Adicione as localidades ausentes diretamente ao canvas no Braze antes de tentar a importação novamente.
- Filtro de recência da importação
  
  Defina número máximo de dias desde a última atualização para importar apenas o conteúdo atualizado nos últimos dias, conforme o número especificado. Defina como 0 para importar todo o conteúdo, independentemente de quando foi atualizado.
Clique em Gravar.

O conector está adicionado à lista na página de conectores.