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 conector Braze 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 modelo.

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 Personalizado nas configurações do conector para códigos de local 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 código 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ção personalizada e multicanal.

  • Canvases:

    Jornadas do cliente de 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.

Casos de usar 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 drag-and-drop).

    • Modelos drag-and-drop 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 drag-and-drop.

    Campanhas e Canvases servem como a camada de entrega. Embora modelos drag-and-drop não possam ser localizados diretamente da Biblioteca de modelos, eles podem ser localizados quando são 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 drag-and-drop

Não visível como um modelo

Localize via Campanhas ou Canvases, e eles ficarão visíveis no Phrase TMS

Incompatibilidades de local

Podem causar erros de criação de trabalho

Mantenha os códigos de local consistente com sublinhados

Permissões ausentes

Pode bloquear a sincronização

Certifique-se de criar novas chaves de API, com acesso fornecido para modelo, Canvas e campanha

Blocos de conteúdo

Não há necessidade de localizar em um nível de bloco de conteúdo

Os blocos de conteúdo são resolvidos quando modelos, campanhas ou canvases são enviados para localização, o que significa que o conteúdo dos blocos de conteúdo ficará visível nas versões traduzidas.

Casos de uso

Existem vários casos de uso para o conector:

  • Os gerentes de projeto podem adicionar arquivos diretamente a projetos a partir de um repositório online.

  • Configure o portal de solicitações 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 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. Criar uma nova Rest API Key.

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

    Certifique-se de que estas permissões estejam selecionadas:

    • Modelos

    • Canvases

    • Campanhas

    Se uma chave tiver sido gerada para o conector de legado, isso não funcionará mais.

  5. Copie a URL do endpoint da API REST do Braze.

  6. Certifique-se de que os locais de idioma em Configurações do espaço de trabalho - Configurações de local de vários idiomas estejam no formato padrão com um sublinhado. Hifens ou outros formatos causarão erros.

  7. Para todos os modelos que exigem tradução, certifique-se de que o idioma múltiplo esteja especificado com todos os locais 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 forneça um nome para o conector.

  5. Selecione a URL do endpoint da API 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 com um código para tradução, clique em Mostrar configurações opcionais e forneça os IDs de código.

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

  10. Clique em Gravar.

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

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. Adicionar códigos de tradução:

    • Envolva a área traduzível em códigos Phrase:

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

      Dica

      Coloque o código de abertura na primeira linha e o código de fechamento na última linha do editor HTML. Frases não precisam ser envolvidas individualmente; o conversor Phrase analisa automaticamente tudo entre os dois códigos, preparando-o para tradução no espaço de trabalho do Phrase TMS. A formatação HTML, links e estilo permanecem totalmente intactos na versão localizada.

    • Para traduzir assunto e Preheader, envolva-os individualmente:

      {% translation phrase_subject %}Subject text{% endtranslation %}
      {% translation phrase_preheader %}Preheader text{% endtranslation %}
      
  3. gravar o modelo.

  4. Reabra o modelo e Selecionar Multi-language e escolha o idioma texto original e o idioma tradução. Certifique-se de que os idiomas sejam os mesmos da configuração do Phrase.

  5. gravar o modelo.

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

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

  7. Traduza e revise.

  8. Uma vez Aprovado, exportar as traduções de volta para o Braze.

    As versões localizadas aparecem automaticamente sob seus idiomas atribuídos. usar Preview & Test - Multi-language user para verificar a exibição e o layout.

Trabalhando com Campanhas e Canvases

Nota

A prévia em contexto não está disponível no CAT Editor para trabalhos importados de Campanhas ou Canvases. O Phrase TMS recebe múltiplos e-mails como parte desses tipos de conteúdo e não pode mesclar eles em um único HTML para renderização, portanto, nenhuma aba prévia aparece.

Para usar a prévia 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 em ativos de campanha ativos ou rascunhos 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, in-app) podem ser localizados se envolvidos com códigos do Phrase.

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

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

  2. Adicionar códigos de tradução:

    • Se estiver usando o editor HTML

      • Envolva a área traduzível em códigos Phrase:

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

        Dica

        Coloque o código de abertura na primeira linha e o código de fechamento na última linha do editor HTML. Frases não precisam ser envolvidas individualmente; o conversor Phrase analisa automaticamente tudo entre os dois códigos, preparando-o para tradução no espaço de trabalho do Phrase TMS. A formatação HTML, links e estilo permanecem totalmente intactos na versão localizada.

      • Para traduzir assunto e Preheader, 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 Phrase na parte superior e um na parte inferior do e-mail. Coloque o código de abertura {% translation phrase_body %} no bloco superior e o código 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 do código estiver configurado no nível do conector, marque a campanha ou canvas com o código de tradução.

  4. Importar para o Phrase TMS

    No Phrase TMS, vá para Importar da integração - Braze - Campanhas/Canvases. As campanhas marcadas com código 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 prévia

    Após concluir, exportar a versão localizada de volta para o Braze. Usar prévia & Teste - usuário de multi-idioma para alternar idiomas 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 um guia de migração completo.

Com a integração Phrase TMS para Braze, o engajamento do cliente pode ser aumentado e o crescimento impulsionado para novos mercados com localização contínua. A integração permite que usuários do Braze traduzam modelos de e-mail e blocos de conteúdo.

Elementos de conteúdo traduzível:

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 projeto podem adicionar arquivos diretamente a projetos a partir de um repositório online.

  • Configure o portal de solicitações 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. Criar uma nova Rest API Key.

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

  4. Copie a URL do endpoint da API 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 da API 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 com um código para tradução, clique em Mostrar configurações opcionais e forneça os IDs de código.

  9. Se especificado, selecione uma pasta padrão (apenas 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.