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.

  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

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.

  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.

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

Last updated

Was this helpful?