Intercom
Partner Setup
Intercom uses OAuth 2 for remote API access. You must register Cyclr within Intercom as your own App to receive OAuth Client ID and Client Secret values to enable Cyclr to authenticate with Intercom.
The official Intercom documentation describing the process can be found here:
Redirect URL: you must add a callback URL to allow Intercom to be used in your Cyclr Console and its accounts.
The URL is:
- https://{{Your Cyclr service domain e.g. app-h.cyclr.com}}/connector/callback
Your Cyclr Partner Service Domain can be found in your Cyclr Console under Settings > General Settings.
Required Permissions
- Read one user and one company
- Write conversations
- Read admins
Choosing The Correct Version
As you will see we have connectors for multiple versions of the Intercom API. As the available endpoints differ for these different versions, it’s important that you use the connector that matches the version your Intercom app uses.
To find out which version your app is set to:
-
Login to your account
-
Hover over the icon in the bottom left corner and select ‘Settings’
-
From the settings page, select Developers > Developer Hub
-
Once in the Developer Hub, select the relevant app
-
From the ‘Basic Information’ page you will see various information about the app, including the version
-
If you want to change the version, click ‘Change version’ and then select the desired version from the dropdown menu
Edit meImportant: Please review the changelog for a detailed description of the differences between each API Version.