Help Scout (TMS)

Content is machine translated from English by Phrase Language AI.

Notice

This integration will be deprecated as of December 15, 2023. If requiring an alternate solution, communicate with your Customer Service Manager and consider either a custom solution or using an API.

Help Scout connector allows the downloading of source content and uploading of translations to/from Help Scout.

Use Cases

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 submitter portal to allow Submitters to add files to requests directly from the online repository.
Use automated project creation (APC) to have new projects automatically created when a change in the last modified date is detected for monitored files or a folder.
- Selected files are imported the very first time APC runs.

When an article is first translated and exported back to Help Scout, the article appears as a draft and must be published manually. If a previously published article is translated, it is immediately published when exported back into Help Scout.

Help Scout Settings

Select Your Profile from the Account dropdown list in the top right-hand corner of the dashboard.
Select Authentication on the right side of the screen and then the API Keys tab. Copy the Docs API Key.

Generate this key it if it doesn't exist yet.

Phrase TMS Settings

From the Settings page, scroll down to the Integrations section.
Click on Connectors.

The Connectors page opens.
Click New.

The Create page opens.
Provide a name for the connection and change the Type to Help Scout .
Paste the API key into the Help Scout Docs API key field.
In the Help Scout Target Collection field, type the name of an existing Help Scout collection or the name of a collection to be created.

New collections appear in the collection list of the Help Scout account.
Click Test connection.
- For a Basic or Standard Help Scout account, a message will appear to confirm the connection to the single site on Help Scout.
- For a Plus Help Scout account, a list of multilingual sites will be displayed. Select the language of each site from the drop-down lists and which site will be the source for the translation.
Click Save.

The connector is added to the list on the Connectors page.

Saving Help Scout Collections

To view a Help Scout collection created via the connector, the collection must first be saved.

To save a collection, follow these steps:

In Help Scout, go to Manage and Docs.
Select the target site for the collection (Basic or Standard accounts have only one site. Plus accounts have multiple sites).
Select Collections on the left-hand side and click on the collection created by the connector.
Click Save Collection.