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 (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 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 disparadas, oferecendo suporte a comunicação personalizada 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 no aplicativo (não 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 mensagens 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 fornecido ao Template, ao 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 automated project creation (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 o 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 Configurações no Console do desenvolvedor.

  3. Selecione Opt in to Braze IP allowlisting se você planeja criar webhooks de Braze para Braze.

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

  5. Copie a URL do Endpoint REST do Braze.

  6. Certifique-se de que as localidades de idiomas em Configurações do Workspace - Configurações de Localidade de Vários Idiomas estejam no formato padrão com um sublinhado. Hífens ou outros formatos causam erros.

  7. Para todos os modelos que exigem tradução, certifique-se de que o atributo multilíngue esteja especificado com todos os idiomas necessários.

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 Tipo para Braze e atribua um nome ao conector.

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

  6. Forneça a chave da REST API encontrada em Configurações do Braze → 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 Testar conexão.

  8. Se o conteúdo estiver marcado para tradução, clique em Mostrar 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.

Excluir um conector

Para excluir um conector:

  1. Na página Integrações, selecione o conector a ser excluído.

  2. Clique em Excluir.

    A janela Excluir conector será aberta.

  3. Digite "delete" e clique em Excluir.

    O conector é excluído e a lista de conectores é exibida.

Nota

Um conector não pode ser excluído enquanto ainda estiver vinculado a trabalhos incompletos em um projeto, incluindo trabalhos que estejam na Lixeira. Tentar excluir esse conector retorna um erro de \"Falha ao excluir conector\".

Resolução: Abra o projeto associado ao conector e conclua ou exclua quaisquer trabalhos restantes. Vá para Configurações/Lixeira e esvazie-a para remover quaisquer trabalhos ainda vinculados ao conector. Tente excluir o conector novamente.

Localizando Modelos de E-mail HTML

Ao usar o editor 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 HTML, siga estas etapas:

  1. Em Modelo - Modelos de E-mail - Editor HTML, 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 Multilíngue 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. Uma vez aprovado, exporte as traduções de volta para o Braze.

    Versões localizadas aparecem automaticamente sob seus respectivos idiomas. Use Preview & Test - Usuário multilíngue 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 pode mesclá-los em um único HTML para renderização, portanto, nenhuma guia de Visualizaçã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 nos ativos de campanha — ao vivo 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.

  • Modelos de arrastar e soltar tornam-se localizáveis uma vez usados nesses contextos.

  • Todos os tipos de mensagem (e-mail, push, no aplicativo) podem ser localizados se estiverem envolvidos com 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 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 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 %}
        
      • Para e-mails de arrastar e soltar, adicione um bloco Parágrafo no topo 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.

  5. Traduzir e Revisar

    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 os 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 Descontinuação do Conector Legado para obter um guia de migração completo.

Com a integração do Phrase TMS para o Braze, o engajamento do cliente pode ser aumentado e o crescimento impulsionado para novos mercados com uma localização perfeita. 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 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 o 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 o conteúdo traduzível novo ou atualizado aciona o APC; exportar 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 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 Chave de API REST.

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

  4. Copie a URL do Endpoint REST do Braze.

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 Tipo para Braze e forneça um nome para o conector.

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

  6. Forneça a chave da API REST encontrada em Configurações do Braze → APIs e Identificadores → Chaves de API.

  7. Clique em Testar conexão.

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

  8. Se o conteúdo estiver marcado para tradução, clique em Mostrar 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.

Excluir um conector

Para excluir um conector:

  1. Na página Integrações, selecione o conector a ser excluído.

  2. Clique em Excluir.

    A janela Excluir conector será aberta.

  3. Digite "delete" e clique em Excluir.

    O conector é excluído e a lista de conectores é exibida.

Nota

Um conector não pode ser excluído enquanto ainda estiver vinculado a trabalhos incompletos em um projeto, incluindo trabalhos que estejam na Lixeira. Tentar excluir esse conector retorna um erro de \"Falha ao excluir conector\".

Resolução: Abra o projeto associado ao conector e conclua ou exclua quaisquer trabalhos restantes. Vá para Configurações/Lixeira e esvazie-a para remover quaisquer trabalhos ainda vinculados ao conector. Tente excluir o conector novamente.

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.