The Freshdesk integration brings your support tickets into Leanmote. Each ticket counts as work of the agent assigned to it, so your support team shows up in the Support tab — response and resolution times, SLA, per agent and per team — and in the flow metrics, such as cycle time and throughput.
What Leanmote reads from Freshdesk
Your tickets: subject, status, type, priority, group, product, company and the agent assigned.
When each ticket was created, first answered, resolved, closed and reopened, and the first response and resolution due dates your SLA policies set.
Each status change, with the time it happened.
The name of the person who reported each ticket. Their email address and phone number are not stored.
The names of your Freshdesk groups, and which groups the agent whose key you connect belongs to.
Leanmote doesn't store ticket descriptions, attachments or replies, and it never creates or changes anything in Freshdesk.
Before you connect
A paid Freshdesk plan. Freshdesk's Free plan does not include API access.
The API key of a Freshdesk agent. Leanmote sees the same tickets as that agent, according to the agent's ticket scope: with Global access, every ticket of the account; with Group access, the tickets of the agent's groups; with Restricted access, only the tickets assigned to the agent. If only one team uses Leanmote, the key of an agent with Group access to that team's groups brings in just their tickets. The agent doesn't need to be an admin.
Where to find the key: in Freshdesk, click your profile picture (top right) and open your profile settings. The API key is on the right side of that page.
Connect Freshdesk
Open
Administration → Integrations.Find Freshdesk under Support and click Connect.
Enter your account address (
yourcompany.freshdesk.com) and the API key, then click Connect. Leanmote checks the key with Freshdesk before saving it, and stores it encrypted.Choose your Freshdesk account. Each Freshdesk account is one board in Leanmote. If the agent has Group or Restricted access, a notice above the account reminds you that Leanmote only brings in the tickets that agent sees.
Check the status mapping and click Save.
Leanmote then brings in the tickets of the last 120 days. It can take a few minutes.
Status mapping
Freshdesk's built-in statuses come classified: Open is active work, Pending is waiting, and Resolved and Closed are done. Check how your custom statuses are classified before saving; you can change any of them later from the Freshdesk status mapping in Administration → Integrations. Freshdesk statuses are mapped on their own: a status with the same name on a Jira board, for example, keeps its own category.
How up to date the data is
Leanmote checks your Freshdesk account for changed tickets every few seconds, so a status change usually shows up within a minute. It paces its requests to leave room for your other Freshdesk apps: the check for changes uses about a tenth of your plan's API limit.
Good to know
Status history starts when you connect. Freshdesk doesn't share past status changes. For tickets that changed status before you connected, Leanmote knows their current status and their dates — created, first response, resolved, closed — but not when they went through each status. The Support tab's times come from those dates, so they cover the 120 days brought in. Time-in-status metrics, such as cycle time and waiting time, fill in from the day you connect.
Tickets are not bugs. Freshdesk tickets count in the flow tabs but not in the QA tab. Freshdesk has no sprints, so it doesn't feed Sprint Efficiency.
Team Connectivity: Freshdesk doesn't add task interactions, so tickets don't show in the Tasks network.
Map agents to people
Each ticket counts for the agent assigned to it. Map every Freshdesk agent to their Leanmote person, so their tickets show with the person's name and count in their team. You can do it from Users (the person's Freshdesk row), from Discoveries, or right in the Support tab: if you can manage users, an agent who isn't mapped yet shows Map in the By agent table. If the person isn't in Leanmote yet, type their name in the search and pick Create «name»: Leanmote creates them, without sending an invitation, and maps the agent to them.
Pair groups with teams
If your support team works in Freshdesk groups, you can also pair each group with a Leanmote team in Settings → Organization Settings → Tabs → Support. The Support tab then counts each ticket in its group's team. See Support tab — what each metric tells you.
Common issues
“Freshdesk refused access with this key” — the account is on Freshdesk's Free plan, which has no API access.
“There is no Freshdesk account at …” — check the address: it's the one you see in your browser when you're in Freshdesk.
Freshdesk shows Disconnected — the API key was regenerated, its agent was deactivated, or the account was suspended. Disconnect Freshdesk and connect it again with a valid key.
Fewer tickets than expected — check the agent's ticket scope, and keep in mind that Leanmote brings in the last 120 days.
Related articles
Support tab — what each metric tells you
Integrations overview
Integration shows disconnected
