Integrações

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 (Legacy)

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. Ele 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 de idioma unificado que alinha automaticamente os códigos de idioma do Phrase TMS com os 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 separador (en-US vs en_us), são resolvidas automaticamente, reduzindo a configuração manual. Os administradores podem definir mapeamentos personalizados nas configurações do conector para códigos de localidade não padrão ou exclusivos, 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 multicanal.

  • 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 tempo. 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 in-app (não é possível 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 adicionais de mensagem 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 via Campanhas ou Canvases, e eles ficarão visíveis no Phrase TMS

Incompatibilidades de localidade

Podem causar erros na criação de tarefas

Mantenha os códigos de localidade consistentes com sublinhados

Permissões ausentes

Pode bloquear a sincronização

Certifique-se de criar novas chaves de API, com acesso concedido para o Template, o Canvas e a Campaign.

Casos de uso

Existem vários casos de uso para o conector:

  • Os gerentes de projetos podem adicionar arquivos diretamente aos 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 de projeto automatizado (APC) para que novos projetos sejam criados automaticamente quando uma alteração no conteúdo for detectada em documentos monitorados ou em uma pasta.

    • Apenas conteúdo traduzível novo ou atualizado aciona a APC; exportar traduções ou alterações em conteúdo não traduzível não cria 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 de vários idiomas do Braze

  1. Faça login na sua conta do Braze.

  2. Navegue até APIs and Identifiers em Setttings no Console do Desenvolvedor.

  3. 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.

  4. Crie uma nova Rest API Key.

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

    A Rest API Key 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.

  5. Copie a Braze REST Endpoint URL.

  6. Certifique-se de que as localidades de idiomas em Workspace Settings - Multi-Language Locale Setttings estejam no formato padrão com um sublinhado. Hífens ou outros formatos causarão erros.

  7. Para todos os modelos que exigem tradução, certifique-se de que a funcionalidade multi-language esteja especificada com todas as localidades necessárias.

Configurações do Phrase TMS

  1. Na página de configurações Setup_gear.png role para baixo até a seção de Integrações.

  2. Clique em Conectores.

    A página Conectores é aberta.

  3. Clique em Novo conector.

    A página Criar conector é aberta.

  4. Altere o Type para Braze e forneça um nome para o conector.

  5. Selecione a Braze REST Endpoint URL na lista suspensa.

  6. Forneça a Rest API Key encontrada em Braze Settings → APIs and Identifiers → API Keys.

  7. Clique em Testar conexão.

    • Se for bem-sucedido, uma pequena marca de verificação aparecerá ao lado do botão Test connection.

  8. Se o conteúdo estiver marcado para tradução, clique em Show optional settings e forneça os IDs das tags.

  9. Se especificado, selecione uma pasta padrão (só é possível após salvar).

  10. Clique em Gravar.

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

Localizando modelos de e-mail em HTML

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

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

  1. Em Template - Email Templates - HTML Editor, abra o modelo.

  2. Adicione tags de tradução:

    • Envolva a área traduzível em tags do Phrase:

      {% translation phrase_body %}
      ...seu conteúdo de e-mail aqui...
      {% endtranslation %}

      Dica

      Coloque a tag de abertura na primeira linha e a tag de fechamento na última linha do editor HTML. As frases não precisam ser envolvidas individualmente; o conversor do Phrase analisa automaticamente tudo entre as duas tags, preparando-o 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 %}Texto do assunto{% endtranslation %}
      {% translation phrase_preheader %}Texto do pré-cabeçalho{% endtranslation %}
      
  3. Salve o modelo.

  4. Reabra o modelo, selecione Multi-language e escolha os idiomas de origem e destino. Certifique-se de que os idiomas sejam os mesmos da configuração do Phrase.

  5. Salve o modelo.

  6. No Phrase TMS, selecione Import from Integration - Braze - Templates.

    O modelo HTML aparece como um trabalho de tradução.

  7. Traduza e revise.

  8. Após a aprovação, exporte as traduções de volta para o Braze.

    As versões localizadas aparecem automaticamente em suas respectivas localidades atribuídas. Use Preview & Test - Multi-language user para verificar a exibição e o layout.

Trabalhando com Campanhas e Canvases

Nota

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

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

Ao localizar dentro de campanhas ou canvases, o fluxo de trabalho difere ligeiramente. Em vez de localizar um modelo HTML autônomo, trabalha-se com ativos de campanha (vivos ou em rascunho) que podem incluir conteúdo de arrastar e soltar.

  • As localizações não são da biblioteca de modelos, mas diretamente dentro de campanhas ou canvases.

  • Os modelos de arrastar e soltar tornam-se localizáveis assim que são usados nesses contextos.

  • Todos os tipos de mensagem (e-mail, push, in-app) podem ser localizados se estiverem envoltos em tags do Phrase.

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

  1. Em Campanhas ou Canvases, abra o ativo necessário.

  2. Adicione tags de tradução:

    • Se estiver usando o editor de HTML

      • Envolva a área traduzível em tags do Phrase:

        {% translation phrase_body %}
        ...seu conteúdo de e-mail aqui...
        {% endtranslation %}

        Dica

        Coloque a tag de abertura na primeira linha e a tag de fechamento na última linha do editor HTML. As frases não precisam ser envolvidas individualmente; o conversor do Phrase analisa automaticamente tudo que estiver entre as duas tags, preparando-as para a 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 %}Texto do assunto{% endtranslation %}
        {% translation phrase_preheader %}Texto de pré-cabeçalho{% endtranslation %}
        
      • Para e-mails de arrastar e soltar, adicione um bloco Parágrafo na parte superior e um 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.

  3. 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.

  4. Importar para o Phrase TMS

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

    Antes de importar, certifique-se de que cada localidade de destino seja adicionada à Campanha ou ao Canvas no Braze (configurações multilíngues). Se uma localidade de destino estiver ausente no item, a importação falhará com um erro no histórico do APC, mesmo quando o formato de localidade configurado no conector estiver correto.

  5. Traduza e revise

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

  6. Exportar e visualizar

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

Braze Legacy (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 (Legacy)

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

Importante

O conector Braze (Legacy) 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 Legacy Connector Deprecation para obter um guia completo de migração.

Com a integração do Phrase TMS para o Braze, o engajamento do cliente pode ser aumentado e o crescimento impulsionado para novos mercados por meio de uma localização sem falhas. 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:

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 de projeto automatizado (APC) para ter novos projetos criados automaticamente quando uma alteração no conteúdo for detectada para documentos monitorados ou uma pasta.

    • Apenas conteúdo traduzível novo ou atualizado aciona a APC; exportar traduções ou alterações em conteúdo não traduzível não cria 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

  1. Faça login na sua conta do Braze.

  2. Navegue até o Console do Desenvolvedor e clique em Configurações de API.

  3. Crie uma nova Rest API Key.

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

  4. Copie a Braze REST Endpoint URL.

Configurações do Phrase TMS

  1. Na página de configurações Setup_gear.png role para baixo até a seção de Integrações.

  2. Clique em Conectores.

    A página Conectores é aberta.

  3. Clique em Novo conector.

    A página Criar conector é aberta.

  4. Altere o Type para Braze e forneça um nome para o conector.

  5. Selecione a Braze REST Endpoint URL na lista suspensa.

  6. Forneça a chave da API REST encontrada em Braze Settings → APIs and Identifiers → API Keys.

  7. Clique em Testar conexão.

    • Se for bem-sucedido, uma pequena marca de verificação aparecerá ao lado do botão Test connection.

  8. Se o conteúdo estiver marcado para tradução, clique em Exibir configurações opcionais e forneça os IDs das tags.

  9. Se especificado, selecione uma pasta padrão (só é possível após salvar).

  10. Clique em Gravar.

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

Esse artigo foi útil?
★ ★ ★ ★ ★

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.