Connect Integration to Phrase

This setup connects Phrase with Parta.io using OAuth 2.0 and involves two steps on both the Phrase and Parta.io sides. To establish connection follow the steps below.

How the Integration Works

The integration between Parta.io and Phrase lets you send courses for translation and receive them back ready for polishing or publishing. Here’s the high-level flow:

1. Create a course in Parta.io that needs localization.

2. Push content to Phrase with one click.

   • Verify the integration is set up in Parta.io.

   • Confirm the 'Push to Parta' workflow step exists in Phrase.

3. On the Phrase side, translate the content and mark the workflow step as complete.

4. In Parta.io, retrieve the translated course for final edits or LMS publishing.

---

Step 1: Set Up OAuth in Phrase

1. In your Phrase organization, navigate to TMS → Settings → scroll down to the Integrations → Registered OAuth Apps.

2. Click New and enter the following details:

   • Name: Any name (e.g., 'Parta.io').

   • Redirect URL (Callback): required

     • Copy this URL from your Parta.io account:

       • Go to Company Settings → Localization → Connect.

       • In the modal window, copy the Redirect URL.

   • Description: required field.

   • Click Save.

3. Retrieve the Client ID

   • After saving, find the new OAuth connection in the Registered OAuth Apps list.

   • Copy the Client ID.

   

   Phrase -> Settings -> Registered OAuth apps

Step 2: Connect OAuth in Parta.io

1. Go to Parta.io → Company Settings → Localization → Connect.

   • In the modal:

     • Select your Data Center (US or EU—based on your Phrase account).

     • Paste the Client ID.

Additional Information

• The Client ID is not stored until all integration steps are successfully completed. Do not exit the setup process prematurely.

• If you encounter the error 'No auth found by client_id' in Phrase, ensure that:

  • You are using a valid Client ID.

  • You repeat the integration steps correctly.

Step 3: Create Webhook

1. Copy the Redirect URL in the modal window.

1. In Phrase, go to TMS → Settings → Webhooks.

2. Click Add webhook and:

   • Paste the URL into the URL field.

   • Enable the event: Job status changed.

   • Click Create Webhook to save.

   

Important

Enable the event in Phrase before saving your webhook: Job status changed.

1. Click Save to connect the integration.

Step 4: Authorize the Integration:

• Follow the authorization process in Phrase.

• Click Allow to confirm and complete the connection.

If you haven't seen this page revise your integration setup.

Configure the Workflow Step in Phrase

To send translated courses back to Parta.io, a specific workflow step must be set up:

1. In Phrase, go to TMS → Settings → Project settings → Workflow steps.

   • Click New workflow step and fill in:

     • Name: Push to Parta (must match exactly)

     • Abbreviation and Order: Based on your internal process.

2. Click 'New workflow step' and fill in:

   1. Name: Push to Parta (must match exactly)

   2. Abbreviation and Order: Based on your internal process.

3. Add the Push to Parta step to any localization templates used for Parta.io.

Important:

• The workflow step must be named exactly Push to Parta—otherwise, Parta.io won’t recognize it.

• The step’s status must be Completed (you can automate or set it manually).

Permissions

• To set up the integration, you’ll need Administrator access.

• To send a course for translation, you’ll need the Create Course permission.

When everything is set up, you're ready to translate your project. 📘 Learn how to translate a project using Phrase