Introduction

The TranslationOS connector for Zendesk allows you to outsource the professional translation of your articles, categories, sections (Guide) and dynamic content (Support) to Translated, with no need to manually import and export content or switch between tools.

This connector is fetch-based, meaning it checks Zendesk at a configurable interval for any content that you have marked for translation. To learn how to mark content for translation, see the section Using the connector.

Support

For general questions about functionality, our dedicated support team can be reached at [email protected].

If you need technical information or you’re ready to integrate your Zendesk instance with TranslationOS, feel free to reach out to us at [email protected] for assistance with onboarding.

The onboarding process may vary depending on your needs, but the following steps are a helpful guideline:

  1. Translated will ask you to provide authentication credentials (see below for instructions to retrieve them).
  2. Translated will enable you to test the connector in sandbox mode, which means that you will get back machine-translated content to test the user experience.
  3. You will agree with Translated on the required service levels, also known as service types. Translated will take care of configuring the connector for you.
  4. We will be ready to receive, process and deliver your translation requests!

Setting up the connector

You will need to retrieve authentication credentials and send them to us, as well as do some configuration in the Guide and Support modules, depending on the content you need to have translated.

To begin, log in to Zendesk with an account which has read and write access to the articles you intend to have translated. The connector will impersonate this user.

Retrieving authentication credentials

Before obtaining the necessary authentication credentials, identify your Zendesk domain, which corresponds to the bolded part of the Zendesk URL: https://domain.zendesk.com.

With that out of the way, you’ll need to decide whether the connector should use basic or OAuth authentication. We recommend OAuth for better security.

Basic authentication

For basic authentication, we require your email address and an API token. To generate an API token, navigate to Admin Center > Apps and integrations > Zendesk API > Settings.