Integrations

Braze (TMS)

Available for

  • Ultimate and Enterprise plans

Get in touch with Sales for licensing questions.

With the Phrase TMS integration for Braze, customer engagement can be increased and growth driven into new markets with seamless localization. The integration enables Braze users to translate email templates and content blocks.

Translatable content elements:

  • Email templates

  • Content blocks

Note

Due to continuous improvements, the user interface may not be exactly the same as presented in the video.

Use Cases

There are a number of use cases for the connector:

  • Project managers can add files directly to projects from an online repository.

  • Set up the submitter portal to allow Submitters to add files to requests directly from the online repository.

  • Use automated project creation (APC) to have new projects automatically created when a change in the specified workflow states is detected.

    • Selected content items are imported the very first time APC runs.

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

Braze Settings

  1. Log in to your Braze account.

  2. Navigate to Developer Console and click API Settings.

  3. Create a new Rest API Key.

    This key is required for the connector configuration.

  4. Copy the Braze REST Endpoint URL.

Phrase TMS Settings

  1. From the Settings Setup_gear.png page, scroll down to the Integrations section.

  2. Click on Connectors.

    The Connectors page opens.

  3. Click New.

    The Create page opens.

  4. Provide a name for the connection and change the Type to Braze.

  5. Enter the Rest API Key obtained from the Braze site.

  6. Enter the Braze REST Endpoint URL obtained from the Braze dashboard.

    See the list of endpoints here: https://www.braze.com/docs/api/basics/

    Please verify which URL is present in the Braze instance's dashboard.

  7. Select how the connector should import email templates with linked content blocks.

    • Email templates import mode

      • Selected email template only

      • Include content blocks

  8. Select how the connector should export email template translations.

    • Export mode

      • Create new item

      • Original item

    Note

    Original item exports translations to the same template/block. Language segments are defined by provided custom attribute.

  9. If Original item is selected for the export mode, provide the Language attribute.

    Note

    Language attribute defines language of if/elsif - structured segment.

    In order to use the Original item option, structure if/elsif/else/endif content like this:

    {% 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 like this:

    {% 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 bold formatting of thecontent must be strictly followed otherwise it won’t work. Language attribute (in this case attribute_name) and languages/keys/values are of course modifiable.

    Each language code can be used only once in the entire document in order to find where to export translations but multiple languages can be used for one segment.

    Example:

    {% elsif {{custom_attribute.${attribute_name}}} == 'de-DE' or

    {{custom_attribute.${attribute_name}}} == 'de-AT' or

    {{custom_attribute.${attribute_name}}} == 'de-CH' %}

  10. Click Test connection.

    A checkmark will appear if the connection was successful. A red exclamation point will appear if it wasn't. Mouse over the icon to see additional details.

  11. Click Save.

    The connector is added to the list on the Connectors page.

Was this article helpful?

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.