Intercom

Connect Intercom to Customerscore to sync conversations and engagement signals into health scoring.

You'll need an Intercom account with admin permissions and 5 minutes.

Step 1 — Open the Intercom Developer Hub

Intercom tokens are created in the Developer Hub, not in your main Intercom inbox. Two ways to get there:

• Direct: go to developers.intercom.com (opens in a new tab), click the Developer Hub link in the top menu, and log in with your Intercom credentials
• From inside Intercom: click the gear icon (Settings) → on the Settings Home page, scroll to Integrations → click the Developer Hub link

Once you're in the Developer Hub:

1. Click Your apps in the top menu
2. Click New app

Step 2 — Create the app inside your workspace

In the New app dialog:

1. Name: Customerscore
2. Workspace: pick your existing workspace from the dropdown. Do not create a new one.
3. Click Create app

Step 3 — Copy the Access token

After clicking Create app, Intercom should drop you straight onto the Authentication tab. If you ended up somewhere else (for example Basic info), open Authentication from the left sidebar.

On the Authentication page:

1. Check permissions. Intercom selects all of them by default, so usually you don't need to change anything. As a minimum, the app needs:
   • Read and list users and companies
   • Read conversations
   • Read one user and one company
2. Copy the Access token — a long string (over 100 characters) starting with dG9rOj….

If you change permissions after copying, regenerate the token before pasting it into Customerscore.

Step 4 — Paste the token into Customerscore

1. Open Settings → Providers (opens in a new tab)
2. Click Connect to Intercom
3. Paste the Access token and save

What Happens Next?

Once we receive all the required information, we'll begin integrating your Intercom account with the Customerscore app.