With the Zendesk integration, you can synchronize your Help Center content and finished translations between Zendesk and Transifex. Allow your localization team to leverage Transifex's powerful tools and effortlessly translate your Help Center articles.

The following video will show you a step-by-step process for connecting, authorizing, and configuring the Zendesk Integration. Additionally, you will learn how to configure your Zendesk Help Center to support multiple languages. We have also included the same instructions below so you can reference them.

To connect your Zendesk and Transifex accounts, you need to be a Transifex administrator.

When creating the project, be sure to:

Authorizing integration with Transifex and getting back to Organization settings > Integrations, you will see the respective Zendesk integration box as active. This means the integration is ready to use, 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. You must do this in The Zendesk Admin Center and the Help Center Settings.

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

In the video below, you will learn how to connect specific Transifex Projects with Zendesk and 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 wizard's first step, 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 here, please follow the instructions on Configuring your Zendesk Help Center to support multiple languages.

When you finish 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 can view content per content type supported and search across Articles and Dynamic Content leveraging various criteria, such as title, categories, sections, status, etc. When you identify Zendesk content you want to sync to your Transifex project, mark it by checking the box on the left of the title. Any selections 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 content back to Zendesk happens automatically based on the following triggers:

In addition, you can choose the state in which translated articles will be pushed back to Zendesk: either as published or as a draft. By default, translations are published immediately.

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. Just so you know, this option can only be set during the initial setup of the integration, so you won't be able to change it later.

When you finish 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 updating 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 find information about Zendesk content on the subdomain you 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 the content displayed in the list, you can choose among the following criteria:

The content list can be filtered by pressing the Enter key or Search button based on the selected criteria.

To clear out a search term, delete it and press the Enter key or Search button; alternatively, you can use the X icon in the search area.

You can also sort the search results by the Updated at field or the title, either ascending or descending.

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.

In case you don’t see in the list the latest Zendesk content (the timestamp of which is shown under the list), even after filtering/sorting, you can click on the Refresh Content button to get the latest data from Zendesk. The search criteria are applied on top of the refresh functionality.

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

The brands allowed to be selected have an active Help Center in Zendesk. If you'd like 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 integration setup 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 use 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 five sentences, with the segmentation enabled, five strings will be added in the source language resource versus a single source string when the segmentation is disabled. When 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 three possible options for automatically sending localized content back to Zendesk:

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 for 100% translated/reviewed/proofread are triggered when the language reaches 100% completion and when there are updates to the translations that have already been completed, reviewed, or proofread. This ensures that any edits to the translations of an already reviewed language will be automatically sent to Zendesk.

Furthermore, you can control how the translated articles will be pushed to Zendesk. If you want the translated articles to be published immediately, check the option “Push translated articles as published”. If you leave this option unchecked, the translated articles will be saved in Zendesk as drafts.

All content synced from Zendesk to Transifex will create a resource following the Zendesk content name. For example, suppose you have two articles in Zendesk titled “Getting Started” and “Quick Installation”, syncing them to Transifex via the integration. In that case, you will get two resources with the 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 the Zendesk category and section as resource categories.

Once your content is inside Transifex, you have several translation options:

The synchronization of content from Zendesk to Transifex can occur either through manual actions by selecting the desired articles and clicking "Save & Synchronize" or automatically on an hourly basis. 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 being synced.

The integration automatically detects updated source content on Zendesk, provided you have selected “Auto-pull new articles” or “Auto-pull updated articles” for articles you've selected to sync with Transifex. Updates on other types of Zendesk content, e.g., categories, sections, etc., are not automatically fetched from Zendesk.

If you want to force a sync from Zendesk to Transifex, you can use the Update Settings & Synchronize button.

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

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

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

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

All target languages that are localized above that threshold will be synced with Zendesk using the Sync content options you have set up for the integration. For example, suppose you had set up Zendesk to Sync 100% translated resources. In that case, 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.

To check the most recent synchronization results, whether from Transifex to Zendesk or from Zendesk to Transifex, there is a popup that displays relevant information for each process and the syncing status report dialogue.

To view this modal, head 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 find the Transifex to Zendesk or Zendesk to Transifex sync activity, along with the date of the most recent sync. The modal displays the last five syncs (or fewer if there have been fewer than five since the integration was installed) for each direction.

If a syncing direction does not have a syncing status yet or there are no translations to sync back to Zendesk, an explanatory message will be displayed on the right side, informing you that there is nothing to report.

Expanding each syncing direction, you will be able to see:

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.

Finally, in case an article is not accessible in Zendesk anymore, an error message will be displayed in the sync report, similar to the example shown below, when attempting to send its translations back to Zendesk. The system will treat the specific source article as missing.

Although the article will still be listed in the wizard (reflecting the last synced snapshot) when you open it again, it will no longer appear in the list of articles for translation once you save the sync settings and manually trigger a sync with Zendesk. To make the article available again in the wizard for syncing, you will need to manually save the configuration after fetching the latest content from Zendesk.

As your Help Center evolves, you can either extend the Zendesk content you are syncing to Transifex or change the workflow of pushing localized content back to Zendesk. If you'd like to edit your options, you can 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:

You can learn more about all the different options in the Filtering and sorting content section of our Choose content for translation article.

The integration automatically handles language locale differences between the two services. This language mapping applies 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 follows the supported locales for Zendesk Help Center and the ones 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 can provide a different translation for identical source strings 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 ensure the workflow of all the Transifex - Zendesk integration is unaffected.

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

Switching to the new version of the integration is recommended, as the previous one will not be maintained and will gradually become 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 many articles and dynamic content.