With the Zendesk integration, you can synchronize Help Center content and finished translations between Zendesk and Transifex. Use this integration so that your localization team can leverage the most of Transifex services while translating your Help Center.

Here is a quick video showing how to do the next 2 steps:

In order to connect your Zendesk and Transifex accounts you need to be a Transifex administrator and follow the steps described below:

When creating the project, be sure to:

Authorizing integration with Transifex and getting back to Organization settings > Manage integrations you will see the respective Zendesk integration box as active. This means that the integration is now active and you can start syncing content between Transifex and Zendesk.

By default, your Zendesk Help Center only supports one language. You have to configure it to support additional languages. There are two places you have to do this: the Support Agent and the Help Center.

Next, we’ll repeat the same setup inside the Help Center:

Here is a quick video showing how to link a specific Transifex project with Zendesk and how to sync content between Zendesk and Transifex.

Navigate to the project of your choice or create a new project and visit the Project settings page. In there, you will see a tab reading Integrations.

If the integration is set up as described in the previous step, you will see the Zendesk option along with a button to Link Help Center. Clicking on that button, the Zendesk Integration wizard will pop up to manage the setup.

On the first step of the wizard, select the Zendesk subdomain that holds the content you want to sync with the project for localization.

Keep in mind that only subdomains with a Help Center set and multiple languages enabled will be displayed in the list. If you don’t see your subdomain in here, please follow the instructions on Configuring your Zendesk Help Center to support multiple languages. When you are done with this step, hit Next to choose the Zendesk content you want to sync with Transifex. The content currently synced between Zendesk and Transifex includes Articles, Dynamic Content, Categories, and Sections.

In the wizard interface shown you have the ability to view content per content type supported and search across Articles and Dynamic Content. When you identify Zendesk content that you want to sync to your Transifex project, mark it by checking the box on the left of the content title. Any selections that you have made are persistent, so you can keep searching and navigating on the displayed content list without losing your selections. You can learn more about the functionality of this wizard’s step by checking the respective section to Choose content for translation below.

When you are done selecting your content, click Next to move to the final step of the setup wizard, where you will define how the syncing between Transifex and Zendesk will happen.

Pushing of content back to Zendesk happens automatically based on your selected criteria; upon 100% translated, 100% translated or updated (for 100% translated), reviewed or proofread content.

For dynamic content, you will get an option to split it into phrases. This is very convenient for cases where dynamic content is hosting Zendesk macros that you use for your emails. Please note that this option can be set only during the first setup of the integration, you will not be able to change it later on.

When you are done with this setup step click the Update Settings & Synchronize button to start syncing content from Zendesk to Transifex.

Some steps described above are also accessible when you want to update the integration settings. Check Editing the Transifex Project - Zendesk content link section below for more.

In this subsection, we are expanding on the full functionality provided in the content selection step of the wizard.

In this step, you will see information about Zendesk content found on the subdomain you have linked to the specific Transifex project. More specifically you will see a list of either:

When content is selected, a ribbon appears at the top of the list informing of the total selected items. Select or deselect content at will and the item counter will update accordingly. There is also an option to clear the whole selection using the quick action Clear Selection which appears in the ribbon area.

For each item in the list you can see some additional information depending on the sync status for that content:

To filter content displayed in the list, choose the dropdown to select the content type and type in the search box; filtering is available for articles and dynamic content only. The content list can be filtered by pressing either the Enter key or the Search button. Search will look in the title and content for articles or dynamic content. To make searching more focused, you can use double quotes around the search terms. To clear out a search term, delete it and press the Enter key or Search button; alternatively, you can use the X icon displayed in the search area.

Items in the list have pagination. You can change the page size using the dropdown displayed under the content list and navigate through the different pages using the left and right arrows located in the same area under the content list.

The synchronization wizard allows the linking of the current project in Transifex with a brand (subdomain) in Zendesk. This can be done in the first step of the wizard when creating the integration in the project settings.

The brands allowed to be selected are those that have an active Help Center in Zendesk, if you want to link a brand without Help Center activated, please follow the steps in this link.

Linking a Transifex project with a Zendesk brand/subdomain can only be set during the setup of the integration and cannot be changed in subsequent edits. The only way to change the brand is to unlink the project from the current brand and start over with the project integration.

If you are using complex dynamic content to create macros, there is an item in the synchronization options to split long content into separate sentences. This is called String segmentation. You can only set this option on the integration setup as all synced content will be handled differently based on your setting.

Here is an example to showcase the result of the segmentation: In a case of dynamic content that contains 5 sentences, with the segmentation enabled 5 strings will be added in the source language resource versus a single source string when the segmentation is disabled. In the case where translations are available and the segmentation is enabled, the pre-processing manipulation will try to match every sentence in the translation with the respective string from the source language.

This match is not 100% fail-safe, and there are two possible drawbacks:

For both cases, it is suggested to manually move translations to the appropriate source sentences.

Syncing localized content back to Zendesk can work automatically per Zendesk content entry (article, dynamic content, category, or section) on each target language. The integration offers four possible options for automatically sending localized content back to Zendesk on:

Depending on the setting selection this will apply to individual content entries as they are localized in each target language.​

For example, once an article is fully translated into French, the French article will be sent to Zendesk. If the Chinese translation of the article is not fully translated it will not be sent to Zendesk.​

The sync options 100% translated, 100% reviewed, and 100% proofread are triggered at the time the language reaches 100%. This means that if, for example, an already reviewed language is edited, the updated reviewed translation won't be sent to Zendesk automatically. In this case, you can use the "Send to Zendesk" option to send the updated reviewed content from Transifex to Zendesk.

All content that is synced from Zendesk to Transifex will create a resource following the Zendesk content name. For example, if you have two articles in Zendesk titled “Getting started” and “Quick installation”, syncing them to Transifex via the integration, you will get two resources with the exact same names “Getting started” and “Quick installation”.

The Zendesk content type is passed as a resource category in Transifex, visible on the resources page. Especially for Zendesk articles, the integration migrates Zendesk category and section as resource categories.

Once your content is inside Transifex, you have a number of translation options:

Syncing content from Zendesk to Transifex happens either upon saving or updating the integration settings on the project level. When a syncing process is initiated, you will be able to see that syncing is in progress in your Project settings > Integrations tab inside the Zendesk card. This process could take some time, depending on the number and size of the files that are syncing.

At this time the integration does not automatically detect updated content on Zendesk. If you want to force a sync from Zendesk to Transifex, please use the Update Settings & Synchronize button.

If you want to re-sync existing contents from Zendesk to the respective resources in Transifex, then you should click on Edit Settings in the project integration in order to show the Integration Wizard, then push the Update Settings & Synchronize button in order to start a new sync process.

If you want to add new content for synchronization, then repeat the same process described previously, but before pushing the Update Settings & Synchronize button, check all the new contents you want to sync.

There is an option to send localised content to Zendesk manually, without waiting for a resource to be 100% translated or reviewed. There is a Send to Zendesk option available on the Projects settings > Integrations tab in the Zendesk card.

By clicking on Send to Zendesk, a modal will appear requesting the threshold localisation percentage that Transifex will check on all your project's resources.

All target languages that are localised above that threshold will be synced with Zendesk using the Sync content options you have set up for the integration. For example, if you had set up Zendesk to Sync 100% translated resources, the manual process will identify all target languages whose translation percentage is equal to or above the threshold percentage you set on the modal and sync all content back to Zendesk.

In order to check the latest synchronization results, either from Transifex to Zendesk or from Zendesk to Transifex, there is a popup that shows the relevant information of each process, and the syncing status report dialogue.

To view this modal head over to your Project settings > Integrations tab and click on the more... link next to the Last sync status in the Zendesk card.

When the modal opens, you will see the latest activity in the Transifex to Zendesk or Zendesk to Transifex sync direction. For each of the two sections you will see directly on the title when the last syncing took place as well as an indicator for syncing errors.

In case a syncing direction doesn’t have a syncing status yet, an explanatory message will appear on the right side of the tab letting you know that there is nothing to report.

Expanding each section, you will be able to see:

It is worth noting that you will see details about the most recent syncing action between Transifex and Zendesk and not a full sync log for all attempts. Each sync action will attempt to sync all out-of-sync content, so any syncing errors that were previously found will either be repeated or fixed.

As your Help Center evolves, you might want to either extend the Zendesk content you are syncing to Transifex or change the workflow of pushing localized content back to Zendesk. To edit your options visit your Projects settings > integrations tab and click on the ellipsis in the Zendesk card, then Edit Settings. The interface to make the changes is the same as the one of the initial setup, but you will only be able to:

Please note that if you deselect already synced Zendesk content, the associated resource(s) will no longer be synced with Zendesk. Also, that resource in Transifex will not be deleted.

You can check out more about the available options to choose content in the section Filtering content of Choose content for translation.

The integration automatically handles language locale differences between the two services. This language mapping applies both to the source and target languages of your linked Transifex project. In cases where more than two similar locales are available in your Transifex project, the most common locale is selected.

For example, if your Zendesk Help Center supports German (de), and the linked Transifex project has both de and de_DE as target locales, the Zendesk content will be linked with the de locale in Transifex.

The automatic mapping applied follows the supported locales for Zendesk Help Center and the locales that Transifex supports. You can find a complete list of the supported language mapping in Transifex to Zendesk locales language mapping.

Through the Zendesk integration, you have the option to provide a different translation for identical source strings that are included in the same article. For example, if your Zendesk article contains the following strings:

Once this article is synced with your Transifex project, all the above strings will be available for translation in Transifex Web Editor. The identical strings can easily be found in the editor using the "repeated_strings:yes" filter.

The key for the first string, as shown above, is "A continuous process that I could completely leave on autopilot." while the key for the second string is "A continuous process that I could completely leave on autopilot._1". These keys are automatically generated by Transifex that way so that repeated strings can be handled as different entries in the editor.

Once the translations are completed in Transifex, the corresponding article in Zendesk will be updated accordingly.

If you are using the previous version of the Zendesk integration, you can easily migrate to the new version by following the instructions to “Authenticate Zendesk to your Transifex organization” and “Linking a specific Transifex project with Zendesk content” for the Transifex project you have already linked with Zendesk using the previous Zendesk Integration.

All your translations and localization status will remain intact by this action. We took extra care to make sure that the workflow of all the Transifex - Zendesk integration is not affected.

Finally, you will have to remove the previous integration from your Zendesk account by:

It is recommended to switch to the new version of the integration as the previous one will not be maintained and will gradually, totally deprecated.

The main reason for building the new integration with Zendesk was to offer a better experience and improved performance when syncing content between the two services, affecting integrations and syncing on a big number of articles and dynamic content.

Content Management

Design

Development

Help Center

Notifications

Translations