Skip to content

Intercom

Install Intercom integration

The Intercom integration can be found here. Please install it in your environments before proceeding with the steps below.

Set up your Intercom OAuth app

Truto doesn't ship an Intercom OAuth app of its own. Before your end users can connect with OAuth, bring yours:

  1. Create an app in the Intercom Developer Hub, and turn on Use OAuth on its Authentication page. Add https://api.truto.one/connect/intercom/callback as its redirect URL. If you use a redirect URL on your own domain, add that URL instead.
  2. Enter the app's Client ID and Client Secret on the installed Intercom integration. See Overriding OAuth credentials.
Info

Until you add them, the connect UI offers Intercom only through the API Key method.

Connecting an Intercom account

  1. Click on Connect Account Click connect account

  2. Type in a value for the Tenant ID. This can be any ID of your choosing. And then click on Get connection link Get connection link

  3. A new link will be generated. Clicking on the link will open a new tab with the list of integrations. You can share this link with your customers too, and they will be able to connect their Intercom account. Share connection link

  4. Select Intercom Select Intercom

  5. Choose how to connect. Both methods ask for the Intercom Region (required) your workspace is hosted in: US, Europe or Australia.

    • OAuth 2.0 (offered once you add your Intercom app): log in to Intercom and allow access.
    • API Key: enter an Access token. Find it in the Intercom Developer Hub on your app's Authentication page.

  6. You should now see a connection successful message. You can now close this tab.

  7. Go to your Truto account, and you should see the new Intercom integration under Integrated Accounts. Click on the Account ID to view the details and initiate API calls.