Locale: Configuring the Kontent.ai Connector

Owned by Bartosz Lewandowski
Last updated: Sept 19, 2024 by Damian Rozmiarkowski
3 min read

Introduction

The Kontent.ai connector from Locale helps automate your translation workflow. By installing and using the Kontent.ai connector, you will reduce the amount of manual project management and verification of tasks between your Kontent.ai data source, and your TMS, TBMS, or LSP. Text-related content from your content models such as articles and pages can easily and quickly be sent for translation through the Locale platform for fast access to localization and internationalization content.

What you will need to get started

  1. The Login link for Locale.

  2. The login link for your Kontent.ai instance.

    1. Note: This is provided to you by your Kontent.ai account manager, support team, or contact person. If you are unsure of this information, please contact your system administrator or your Kontent.ai representative.

  3. User login information for both your Locale instance, and your Kontent.ai instance.

    1. A trial account of Locale can also be taken for free by going to locale.to and selecting the “Get Started” button.

Configuring the Kontent.ai Connector

  1. Start by accessing and logging into Locale with your username and password.

  2. Once logged into Locale (instructions on that can be found here), we are greeted with our Dashboard, which looks something like this image below.

General Login 001.png

  1. Next, select the “Add Project” button from the dashboard. This will populate a list of connectors which can be uses for our project. From this list, start by selecting the CMS filter on the left side, and choosing “Create Project” under Kontent.ai.

Kontent.ai setup 001.png

  1. Next, the connector will require the Kontent.ai API key, and environment ID. This information can be found in your Kontent.ai instance.

    1. To access the Kontent.ai API key:

      1. From the dashboard, select the gear icon on your project which requires translation, and access the project settings menu.

ii. Navigate to the API Keys menu on the left side of the screen, and select the personal key under the Management API Keys tab.

iii. Copy the General API key information here, and past it into your Locale instance

  1. To access the Kontent.ai Environment ID:

a. From the dashboard, open the project which requires translation.

b. and choose Environment Settings from the menu on the left, and General under environmental settings. From here, the Environment ID can be copied and pasted into Locale.

  1. Select next to continue with the process of Locale: Creating a Kontent.ai project in Locale.