Integrations

Connect a Zendesk Account

This article is for Account Owners and Project Managers. You must be on a Zendesk "Professional" or "Enterprise" plan to use the Smartling Zendesk Connector.

The Smartling Zendesk connector allows you to translate Zendesk content with context. Translations are requested from within the Smartling platform, and translated content is automatically sent to your Zendesk instance.

The connector supports translation of Categories, Sections, Articles, and Dynamic Content.

To link your Zendesk Account to Smartling, complete all sections below.

Setup Languages in Zendesk Support

From within your Zendesk Support widget:

  1. Click on Admin > Account > Localization tab
  2. In the Languages section, click on Additional Languages
  3. Select the languages you want to make available to your end users using the checkboxes
  4. Click Save tab

Zendesk's supported languages may not align with Smartling language codes. Later, you will learn to map Zendesk languages to the languages in your Smartling project.

Setup Langauges in Zendesk Guide

From within your Zendesk Guide widget:

  1. Click on Settings > Guide Settings > Additional Languages
  2. Select the languages you want to make available to your end users using the checkboxes
  3. Enter a name to display to end users for each translated Help Center in the Help Center name field
  4. Click Update at the top of the page to save your changes or Cancel to exit the menu

The Help Center languages need to be enabled for translations to be publicly accessible. See our Tips for launching your translated Help Center.

Setup Smartling Zendesk Connector

Connect Zendesk Instance to Smartling

  1. Create a Zendesk Project type in your Smartling Account
  2. From within this Project, click on Project Settings > Zendesk Settings
  3. Click Connect to Zendesk
  4. Enter your Zendesk subdomain. For example, if your Zendesk homepage is smartling.zendesk.com, your subdomain is 'smartling'. Click Connect to Zendesk to save your subdomain or cancel to exit the menu.
  5. Click Allow to let Smartling connect to your Zendesk instance

Your Zendesk instance will now be connected to Smartling.

Configure Content Change Behavior

You can configure the behavior of the connector when content in your source articles change.

  1. From within your Smartling Zendesk Project, click on Project Settings > Zendesk Settings
  2. Click the Resubmit changed content dropdown to select your desired changed content behavior
  3. Click Save

Changed Content behaviors

  • Auto: detect changes to source content every 3 hours, and automatically submit the new content for translations. The connector will not automatically submit net new content, only updates to content that has been submitted for translation in the past.
  • Manual: detect changes to source content every 3 hours, but do not submit new content for translation. Changed content will be indicated by a checkmark in the Outdated column in Zendesk > Translation Progress
  • Disabled: do not detect changes or automatically submit new changes

Map Zendesk Languages to Smartling

  1. From within your Smartling Zendesk Project, click on Project Settings > Zendesk Settings
  2. In the Language Configuration section, you will see dropdown menus with your Zendesk lanaguages
  3. Click on a dropdown menu to map the language in your Smartling project to a Zendesk language
  4. Click Save

You cannot map a Smartling language to more than one Zendesk language

Launching a Translated Help Center

Help Center languages need to be enabled for translations to be sent to your Zendesk instance, and to be publicly accessible.

You can leave languages disabled while you translate your content, and enable them when you are ready to launch your translated Help Center. Keep in mind that when you enable the languages, you will need to initiate a on-time manual download of all translations to populate your translated Help Center.

Alternatively, you can enable the languages, but hide them in your Help Center until you are ready to launch. Using this method, you won't need to initiate a manual download of translated content.

Learn how to hide your Help Center in our Zendesk Developer Guide.

Ready to translate Zendesk Content? Learn how in our Zendesk translation guide

Was this article helpful?