Zendesk connector allows the downloading of source content and uploading of translations to/from Zendesk for the following content types:
Articles, Sections, and Categories in the Guide module.
Dynamic text in the Support module.
Note
The connector always imports the published version of the document even if there is a newer draft. The draft if only imported if the published version is missing.
There are a number of use cases for the connector:
Project Managers can add files directly to projects from an online repository.
Set up the Automation Widget to allow Submitters to add files to requests directly from the online repository.
-
Use Automated Project Creation (APC) to have Memsource automatically create new projects when a change in the last edited date (edited_at attribute) is detected for monitored files or an entire list. If the connector is configured to create jobs only for languages flagged for translation, then APC only creates jobs for the flagged article translations.
Selected files are imported the very first time APC runs.
The Connector API can be used to automate steps otherwise performed manually through the UI. Webhooks can be used to have Memsource notify 3rd party systems about certain events (for example, a job status change).
Zendesk Support: Go to Account in the Admin section and configure target languages.
Zendesk Guide: Go to Language settings in the Admin section and configure target languages.
-
Memsource connector languages are set according to the languages in Zendesk Guide.
English in Zendesk is actually English (United States) full locale.
Zendesk Guide offers more locales than Zendesk Support. Ensure the same list of locales is selected (e.g. Norwegian in Support and Norwegian(Bokmål) in Guide are considered different languages).
When adding new targets in Zendesk, re-save the connector settings in Memsource.
Important
If accessing Memsource from a custom domain (ex. mydomain.memsource.jp), open an incognito browser window and log in via cloud.memsource.com to apply the authentication required for the creation or saving of the connector. After saving, the connector can be accessed via the custom domain.
From the Setup
page, scroll down to the section.-
Click on Connectors.
The page opens.
-
Click New.
The page opens.
Provide a name for the connection and change the Type to Zendesk .
Enter the Host prefix.
In the , specify a label that flags an article to be processed by the connector. If specified, only articles with this label will be processed.
Select how jobs will be created.
Select how to save translations.
Define article workflow.
-
Click Connect to Zendesk.
Zendesk login page opens.
-
Log in to Zendesk.
A checkmark will appear if the connection was successful. A red exclamation point will appear if it wasn't. Mouse over the icon to see additional details.
-
Click Save.
The connector is added to the list on the Connectors page.
If a default project, branch, and folder is required when connecting, open the connector configuration and click the Select Remote Folder button to set it.
Translating Source Articles
To allow article authors to manually trigger translations:
In the , configure the connector to monitor articles by adding a specific label (e.g. translate) to the field. The author applies this label to articles when ready for translation. The label is automatically removed to prevent repeated import of the article.
To notify the author when article translation has started:
In the , configure the connector to add a label (e.g. in translation) in the field. This allows article authors can see when the article was pulled to Memsource for translation.
To notify the author when article translation is complete:
In the , configure the connector to add a label (e.g. review-
{targetLang}) in the field. Reviewers then use the applied label to filter articles in the Zendesk UI.
Combine the above with Automated Project Creation (APC) to maximize automation.
Submitting for Re-translations
To allow reviewers to submit existing translation for an update:
Configure the connector to create translations for flagged articles. The reviewer will set the flag for translation to trigger a new job in Memsource.
Select how jobs will be created by APC.
Note
If the connector is configured to monitor articles with a specific label, beyond flagging the translation, the article also needs to be tagged with that specific label in order for APC to identify it.