Freshdesk
Overview
Freshdesk imports are governed by three things: what the API-key owner can read, which groups you select, and which ticket statuses your connection includes. Decide the scope first, then connect the account.
Decide which tickets belong in this connection
Your goal | Group ID setting |
|---|---|
Import eligible tickets across all accessible groups | Leave Group ID blank |
Import one support group | Enter its positive numeric Group ID |
Keep several groups as separate connections | Create one connection per Group ID |
Enterpret rejects overlapping active connections for the same subdomain. An all-groups connection overlaps every group-specific connection. Check existing scopes before adding another.
Group scope does not override agent permissions or ticket-status coverage. Freshdesk’s API follows the permissions of the user whose key you supply. A key belonging to a restricted agent will not grant access to every ticket. See Freshdesk’s API authentication and permissions.
In Enterpret, connections may use resolved-ticket coverage or broader status coverage. Ask Support to confirm the setting for your connection if open or pending tickets are part of your analysis.
Get the key from the right Freshdesk agent
Use a verified agent who can access the intended tickets and groups.
Sign in to Freshdesk.
Open your profile picture and Profile Settings.
Select View API key, complete verification, and copy the key.
Follow Freshdesk’s API-key guide if the key is not visible.
You will paste the raw key into Enterpret. Do not add a Basic prefix, paste a full Authorization header, or Base64-encode it. Those are API request details that Enterpret handles for you.
Find the company subdomain and Group ID
Read the company subdomain from the address of your Freshdesk agent homepage. For a group-specific connection, ask your Freshdesk administrator to identify the group in Admin → Team → Groups and provide its numeric Group ID, not its name. The Freshdesk Groups guide explains the administrator view.
To create separate connections for several groups, reuse the same company subdomain and raw API key, provided that agent can access each group. Enter a different Group ID for each connection. Keep these scopes separate from an all-groups connection.
Which Domain values are accepted?
Use the company subdomain, such as yourcompany. Enterpret also accepts yourcompany.freshdesk.com and removes the suffix.
Use the original Freshdesk domain. Full URLs, paths, and custom support domains are rejected.
The domain is normalized to lowercase and surrounding spaces are removed. The Group ID, when supplied, must be a positive integer.
Add the Freshdesk connection in Enterpret
Sign in to Enterpret with permission to add integrations.
Click your name at the bottom of Enterpret’s sidebar, then select Integrations.
Open the account menu from your name, then choose Integrations.
Click + New Integration. Search for FreshDesk and click Continue on its card.
Search for FreshDesk, then click the highlighted Continue button.
Choose Feedback Integration. If you already filtered the catalog to Feedback, its card may show Connect instead of Continue; use that action.
Choose Feedback Integration to bring FreshDesk feedback into Enterpret.
Fill Domain, API Key, and the optional Group ID.
Enter a Group ID to restrict this connection to one group, or leave it blank for all accessible groups. Demo key shown.
Describe what the tickets contain, who writes them, and what you want to learn. The description can be up to 500 characters.
Complete the description checks, then click Integrate.
Review the account, group scope, and feedback description, then click Integrate.
Check one ticket before comparing totals
Choose a ticket in Freshdesk that should be included. Check its group, status, and whether the key’s owner can open it. After fetching and processing, find its record in Enterpret and compare the conversation and creation date.
Eligible tickets become conversation feedback. The record date is the ticket’s creation date, so a recently imported older ticket can appear under an older date filter.
The default polling interval is four hours; an existing connection may differ. Historical coverage and the first import also depend on the configured date range, API limits, volume, and processing. Contact Support to confirm the required history rather than assuming all past tickets arrive on the first check.
Authentication note: this connection uses a Freshdesk API key. There is no OAuth authorization flow to renew. Enterpret’s Reauthorize action replaces the stored API key.
Manage the Freshdesk connection
Edit the feedback description
Open the active connection and click Edit. Update Describe the type of feedback being integrated, complete the displayed checks, and click Save Changes. Keep the description within 500 characters and explain the feedback, its authors, and your analysis goal. This edits the description; it does not change the Domain, Group ID, or API Key. See Writing integration descriptions.
Edit the description, then click Save Changes. Example description shown.
Inspect status, imported records, and metadata
Open the connection from Integrations. Check its status, ingestion progress, and any error. Where shown, Latest Source Timestamp is the source creation time of the latest feedback. Latest Ingestion Timestamp is when Enterpret pulled it. Older layouts may show Last Ingested Record.
Open the source’s ⋮ menu and choose View all Records, if available. You can also compare an eligible source record against its match in Feed.
Open Manage Metadata to review fields you can filter on. Depending on permissions and field type, you can edit their name, description, visibility, starred status, type, or unified-field mapping.
If Link with User and Account integrations is available, select a matching identifier from an existing user or account integration. Verify a sample match before using linked attributes.
Stop importing or permanently delete the connection
Use Stop integration from the connection’s actions to stop future imports and retain existing feedback. Stopping is permanent. Create a new connection to import again.
Delete Integration, when available, permanently removes the connection and its imported feedback. Check dependent analyses, metrics, dashboards, and reports before confirming. Contact Support if the action is unavailable.
Change the group or company scope
Reauthorizing replaces the API key for the existing connection; it does not switch its company or Group ID. To use a different company or group, add a separate Freshdesk connection using the setup steps above. Check whether its scope overlaps an existing connection before relying on combined totals.
Fix access without changing scope
If the key is reset or invalidated, open Reauthorize on the existing Freshdesk connection where available and enter the replacement raw key. This updates access; it does not choose a new group or domain.
Resetting a key disconnects all other applications using it. Coordinate with the Freshdesk administrator before rotating a shared key, then provide the replacement key to each affected application so it can reconnect.
401 invalid_credentials or Connection expired
Check that you pasted the raw key, that its owner is verified, and that the agent retains access to the required tickets. Then reauthorize the existing connection.
Invalid Domain or Group ID
Use the original Freshdesk subdomain. If you provide a Group ID, it must be a positive integer.
Some tickets arrive, but others do not
Compare the missing ticket’s group and status with a ticket that imported. Check the key owner’s access and the history window. Send Support the subdomain, ticket ID, group, status, and relevant dates; do not send the API key.
Investigate missing records and count differences
Analyze this feedback with Enterpret Agent
Once you verify the import, use Enterpret Agent in the app or in Slack to explore the feedback. If you use an external agent, connect it through the Enterpret MCP Server.
Review the last 30 days of Freshdesk tickets. Group the recurring product issues by theme and cite representative tickets.