This integration is available from the Pro plan and above.

Zendesk Dynamic content (ZDC) allows you to create special types of content that can then be referenced via a placeholder in automations, macros, triggers, and by many of the system generated messages such as those sent in email notifications when a user creates an account. Dynamic content is a powerful tool for streamlining multiple language support because the appropriate version of content is automatically displayed to users based on their language. The content is represented by a placeholder such as {{dc.my_placeholder}}.

Please note that Dynamic content is available only on the Zendesk Professional plan and above.

Index

Preparations

To get started, you have to decide which languages you want to translate your dynamic content into. To achieve that, switch to Zendesk Support in the top right corner:

Then proceed to Admin > Settings > Account > Localization:

Click Additional languages and choose one or more items from the list:

Once you are ready, click Save tab.

Integrating Zendesk Dynamic Content with Lokalise

To set up the integration, proceed to Lokalise, open your project and click More > Integrations:

Find Zendesk Dynamic Content in the list of integrations and click Connect. Then click Connect again:

In the dialog box provide your Zendesk subdomain. For example, if your help center URL is mycorp.zendesk.com then the subdomain will be mycorp:

Click Authorize.

You will be presented with a list of all ZDC items:

Importing items from ZDC to Lokalise

Once the items were synchronized, you have to import them to Lokalise to start translating. You can filter the items using the Filter dropdown or perform synchronization again by clicking the Refresh icon.

To start the import process, tick one or more items in the list and click Import selected:

You'll be presented with a dialog box to choose the languages to import:

If a language does not exist in your current Lokalise project, it will be created automatically for you. If the Overwrite updated translations option is enabled, then the existing translations on Lokalise will be overwritten with the new values from Zendesk.

Click OK. The import process will be performed in the background and you can check its status on the Activity page:

Once the process has finished, you can proceed to Lokalise project editor and perform translations as usual.

Performing translations

After the items were imported to Lokalise, you can translate them:

For each item a separate translation key will be created. Each translation key will be assigned with the following tags:

  • Zendesk Dynamic Content.

  • Name of the ZDC item (for example, forgot_password).

  • Name of the ZDC placeholder (for example {{dc.forgot_password}}).

You can use these tags to filter the keys.

Exporting items from Lokalise to ZDC

Once you have finished translating your dynamic content, it's time to export it back to Zendesk. To achieve that, return to the ZDC integration page on Lokalise and choose the items that you would like to export. Then click Export selected:

Choose the languages that you would like to export:

Enable the Mark new content as active option if needed and click OK. The export process will be performed in the background, and you can check its status on the Activity page:

Now you can return to Zendesk and make sure that your dynamic content was translated properly:

Did this answer your question?