Connecting support systems
How to integrate Zendesk, Intercom, and Freshdesk.
Threadline connects to your company's support workspace so you can import real customer conversations and tickets for analysis. A support administrator may need to approve the connection, but your support-system email does not need to match your Threadline email.
Supported integrations
| Platform | What it imports |
|---|---|
| Zendesk | Tickets and customer comments from your Zendesk workspace |
| Intercom | Tickets from your Intercom workspace |
| Freshdesk | Tickets and customer conversations from your Freshdesk workspace |
How to connect
- On the CFA page, go to Multiple Feedback mode.
- Click the Support Systems tab.
- Select your support platform.
- Connect your company's support workspace using the instructions below.
- Choose an import window and ticket status.
- Click Preview Tickets to review a sample, then continue to import and analyse them.
Zendesk setup
- Select Zendesk under Support Platform.
- Enter your Zendesk subdomain — the part before `.zendesk.com`.
- Click Connect Zendesk.
- Sign in to Zendesk if prompted and approve Threadline's requested read access. You must have permission to authorise integrations for that Zendesk workspace.
- After returning to Threadline, test the connection, choose your import settings, and preview the tickets.
You do not need to create a Zendesk developer app or give Threadline an API token.
Intercom setup
- Select Intercom under Support Platform.
- Click Connect Intercom.
- Sign in to Intercom if prompted and select your company's Intercom workspace.
- Approve Threadline's requested access. Your Intercom account must be allowed to install or authorise apps for that workspace.
- After returning to Threadline, test the connection, choose your import settings, and preview the tickets.
You do not need to create an Intercom developer app or provide an API key. Threadline's approved Intercom integration is shared by all Threadline customers; each customer only authorises access to their own workspace.
Freshdesk setup
- In Freshdesk, create or use an agent account with permission to read the tickets you want to analyse.
- Open your Freshdesk profile menu and select Profile Settings.
- Under Your API Key, click View API key and complete any verification Freshdesk requests.
- If Freshdesk says the API key is disabled, follow its Agent Settings link, enable API-key access for the agent, save, and return to Profile Settings. The agent's email may also need to be verified.
- In Threadline, select Freshdesk under Support Platform.
- Enter your Freshdesk domain, such as `company.freshdesk.com`, your Freshdesk agent email, and the copied API key.
- Click Test Connection, then Save & Continue.
- Choose your import window and ticket status, then click Preview Tickets.
Treat the Freshdesk API key like a password: enter it only in Threadline's secure connection form. Do not send it through email or chat. Threadline encrypts the saved credential.
Disconnecting an integration
Go to the Support Systems tab, select the connected platform, and click Disconnect. This removes Threadline's saved connection. You can reconnect the workspace later.
Troubleshooting
My Zendesk connection fails with an authentication error
Verify your subdomain — it is the part before .zendesk.com — and make sure the Zendesk account approving the connection is allowed to authorize integrations. Then disconnect and restart the Zendesk connection.
Intercom OAuth redirects but then shows an error
Confirm that the Intercom account you are using can authorize apps for the selected workspace. If Intercom reports that the Threadline app is private, the shared Threadline integration may still be awaiting Intercom approval; try again after it is approved.
The import completes but returns 0 tickets
Check the import window and ticket-status filter. Try selecting All Statuses and a wider import window, then preview again.
Related articles
Was this helpful?
If you still need help, our support team is here.