Phrase

Phrase is a cloud-based software for localization management. Phrase enables automated translation workflows and supports continuous localization for agile teams.

The Phrase and Braze integration allow you to translate email templates and Content Blocks without leaving the Braze interface. With the Phrase TMS integration for Braze, you can increase customer engagement and drive growth into new markets with seamless localization.

Prerequisites

Requirement	Description
Phrase TMS account	A Phrase TMS Ultimate or Enterprise account is required to take advantage of this partnership.
Braze REST API key	A Braze REST API key with all permissions. This can be created in the Braze dashboard from Settings > API Keys.
Braze REST endpoint	Your REST endpoint URL. Your endpoint will depend on the Braze URL for your instance.

Integration

Step 1: Phrase TMS Settings

In Phrase, navigate to Settings > Integrations > Connectors > New.

1. Provide a name for the connection and change the type to Braze.
   
   
2. Enter the REST API key and the Braze REST endpoint.
   
   
3. Select how the connector should import email templates with linked Content Blocks.
   • Selected email template only
   • Include Content Blocks
     
     
4. Select how the connector should export email template translations.
   • Create new item
   • Original item
     • Original item exports translations to the same template/block. Language segments are defined by the provided attribute.
       
       

   Provide the language attribute if original item is selected. The language attribute defines the language of the if/elsif argument. If you are using the original item option, it must be structured as shown below:

   1
   2
   3
   4
   5
   6
   7
   8
   9
    {% if {{custom_attribute.${attribute_name}}} == 'da-DK' %}
    danish content
    {% elsif {{custom_attribute.${attribute_name}}} == 'pt-PT' %}
    portuguese content
    {% elsif {{custom_attribute.${attribute_name}}} == 'sv-SE' %}
    swedish content
    {% else %}
    Original content
    {% endif %}
   

   Or using the assign keys/values mapping:

   1
   2
   3
   4
   5
   6
   7
   8
   9
    {% if {{custom_attribute.${attribute_name}}} == 'da-DK' %}
      {% assign abc_key1 = "danish_value1" %}
    {% elsif {{custom_attribute.${attribute_name}}} == 'pt-PT' %}
      {% assign abc_key = "portuguese value" %}
    {% elsif {{custom_attribute.${attribute_name}}} == 'sv-SE' %}
      {% assign abc_key = "swedish value" %}
    {% else %}
      {% assign abc_key = "Source language value" %}
    {% endif %}
   

   The above Liquid must be strictly followed, but the language attribute and language, keys, and value are adjustable.
   
   Each language code can only be used once, However, multiple languages can be used for one segment, for example:

   1
   2
    {% elsif {{custom_attribute.${attribute_name}}} == 'de-DE' or {{custom_attribute.${attribute_name}}} == 'de-AT' or {{custom_attribute.${attribute_name}}} == 'de-CH' %}
       
   

5. Click Test connection. A checkmark will appear if the connection is successful. Hover over the icon to see additional details.
   
   
6. Lastly, click Save. This connector will be available on the Connectors page.

Step 3: Send content to Phrase and export back to Braze

1. First, set up the submitter portal to allow submitters to add files to requests directly from the online repository.
   
   
2. Use Automated Project Creation (APC) to have Phrase TMS automatically create new projects when a change in the specified workflow states is detected.
   
   
3. Selected content items are imported the very first time APC runs.

The Connector API can automate steps otherwise performed manually through the UI. Webhooks can be used to have Phrase TMS notify 3rd party systems about certain events (for example, a job status change).