This integration is available from the Pro plan and above.

The Intercom Articles integration allows you to import articles and collections from Intercom to your Lokalise project and translate the content with ease. After the translations are ready, you may export them back to Intercom with just a couple of clicks.


Getting started

Let's see how to setup Intercom Articles integrations and choose data to translate.

Necessary permissions

In order to set integration properly, you will need the following Intercom access rights:

  • Install, configure, and delete apps.

  • Manage articles.

Connecting Lokalise to Intercom

  • To get started, open your Lokalise project and proceed to More > Apps.

  • Find Intercom Articles and click Connect.

  • Then click Connect again to integrate Intercom with Lokalise.

  • Review the requested permissions and click Authorize access.

Importing from Intercom

After setting up the integration, you will see a list of your articles and collections available on Intercom. To be able to translate these items, you will need to import them. Therefore, choose one or more items by ticking the checkboxes next to the titles and then click Import selected.

All languages that are not present in your Lokalise project but are available on Intercom will be created automatically.

After clicking Import selected, decide which languages to import and whether the already downloaded items should be updated with the values from Intercom:

Click OK to start the import. This process will be run in the background, and you can check its status on the Activity page.

Filter the items using the Filter dropdown:

Adding new Intercom Articles languages

In order to add more languages to Intercom, you should proceed to Articles > Help Center > Settings > Localize your Help Center. Then click Add language and choose one of the options from the dropdown.

Please note that if you have added a new language to Intercom but have not created at least one article, collection, or a section in this language, Lokalise will not be able to synchronize this language properly due to Intercom limitations. In other words, Lokalise will not be able to detect if you've added a new language to Intercom Articles. To notify Lokalise about this new language, you have to add it to at least one article/section/collection before performing the importing process. For example, if you have recently added Japanese, you'll need to add it to any article in the following way:

Working with the translation keys

After the chosen items are imported, you can proceed to the project editor. Translation keys containing the imported items will be assigned with the following tags:

  • Intercom Articles — assigned to all items imported by Intercom Articles integration.

  • Article — assigned to the keys that represent articles.

  • title — assigned to the keys that contain article titles.

  • description — assigned to the keys containing article or collection descriptions.

  • body — assigned to the keys containing article bodies (main text).

  • Collection — assigned to the keys that represent collections.

  • Section — assigned to the keys that represent sections.

  • name — assigned to the keys containing collection or section names.

  • Additionally, every key has a tag containing the item name (for collections) or title (for articles). For example, if some key contains the body of an article named "Hello", then this key will be assigned a Hello tag.

Please note that Intercom has length limitations for certain items (article titles, collection names etc). Therefore when performing translations you will see the maximum allowed length:

Exporting to Intercom

After you have finished translating your content, it's time to export new strings back to Intercom! To achieve that, proceed to More > Apps > Intercom Articles and choose one or more items that you would like to export:

After choosing the items, press Export selected. Choose what languages you would like to export.

If needed, you can Convert the exported Articles to drafts. Once you are ready, press OK. The chosen items will be uploaded to Intercom!

Please note that empty translations will be ignored and won't be exported to Intercom!

Importing updated content from Intercom

You may import updated content from Intercom to Lokalise for the items that were already downloaded. To achieve that, proceed to More > Integrations > Intercom Articles and choose one or more items that you would like to import from Intercom. Next, click Import selected.

Did this answer your question?