Freshservice
Service domainCUSTOMER SUPPORT
Arcade Optimized
Arcade.dev LLM tools for Freshservice IT service management
Author:Arcade
Version:
1.0.0Auth:User authorization
6tools
6require secrets
Freshservice is an IT service management platform by Freshworks. This toolkit lets LLM agents interact with Freshservice to triage tickets, search the knowledge base and service catalog, look up requesters, and correlate incidents with known causes.
Capabilities
- Ticket management: Retrieve full ticket details (fields, conversation, tasks, linked changes/problems) and filter the ticket queue by actionable views, status, and priority.
- Root cause correlation: Search recent changes and tracked problems together in a single ranked call to explain a wave of related tickets.
- Knowledge base access: Search solution articles or fetch a full article by ID — body text included — in one call.
- Service catalog search: Find catalog items by search term (browsing the full catalog is blocked by scope constraints).
- Requester lookup: Resolve a Freshservice user by internal ID, exact email, or name.
OAuth
Authentication uses OAuth 2.0 via the Freshservice provider. Arcade manages the OAuth flow; no manual token handling is required.
Secrets
FRESHSERVICE_SUBDOMAIN: Your Freshservice account subdomain — the prefix in your instance URL (e.g.,acmefromacme.freshservice.com). Find it by logging into your Freshservice instance and reading the subdomain from the browser address bar. This value identifies which Freshservice tenant API requests are routed to and is required for the toolkit to construct correct API endpoints.
Configure secrets in the Arcade dashboard or via the API: https://docs.arcade.dev/en/guides/create-tools/tool-basics/create-tool-secrets — secrets can also be managed at https://api.arcade.dev/dashboard/auth/secrets.
Available tools(6)
6 of 6 tools
Operations
Behavior
| Tool name | Description | Secrets | |
|---|---|---|---|
Find the change or known problem that already explains a wave of tickets about one system.
Searches recent changes and tracked problems together and ranks them as one
most-recent-first list, so a caller asking "what explains this" makes one
call instead of two and does not have to merge the answers itself. Changes
and problems stay in their own fields of the response, since a change that
went out and a problem being tracked call for different next steps.
Give change_id or problem_id on its own to fetch that one record with its
full description; combining either with the other, or with any filter, is
rejected rather than silently resolved one way or the other.
A filtered search covers a bounded, most-recent working set rather than the
entire history, so an empty result is not proof that no such change or
problem exists; the response states how far the scan actually reached. | 1 | ||
Find a Freshservice requester by internal id, exact email, or name.
Exactly one of requester_id, email, or name must be given; supplying none
or more than one is rejected.
An email lookup matches character-for-character, so a guessed or
slightly-off address returns nothing even when the person is in the
directory. Retry by name when an email guess comes back empty. | 1 | ||
Read one ticket's whole story: fields, conversation, tasks, and any linked change or problem.
With every embed disabled this makes exactly one upstream request and sends
no include parameter at all; leaving any one embed enabled also resolves
the ticket's formal change and problem linkage.
Only a change or problem Freshservice itself formally linked to the ticket
is reported as linked. One merely named in the conversation text is not a
link, and has to be found by searching changes or problems for the affected
system's name instead.
The conversation returned is the most recent history rather than a
guaranteed-complete thread: a very long thread is reported as shortened, not
silently cut. | 1 | ||
Narrow the Freshservice ticket queue to what is actionable.
NEW_AND_MINE lives on a predefined-view endpoint that rejects status and
priority filters, so combining them is rejected rather than silently
resolved; use ALL, UNASSIGNED, or BREACHING with a status/priority filter
instead. UNASSIGNED and BREACHING compose with status and priority.
BREACHING excludes tickets already resolved or closed unless a status is
explicitly given, since a past-due ticket that is already resolved or
closed no longer needs anyone's attention. | 1 | ||
Search the Freshservice service catalog for an item that covers an ask.
The catalog can be searched by term only and cannot be listed or browsed
in full under this grant: Freshservice gates the catalog's list and detail
endpoints behind a write scope this toolkit refuses to declare. | 1 | ||
Search the Freshservice knowledge base, or fetch one article in full by id.
Exactly one of search_term or article_id must be given; supplying both or
neither is rejected. Articles come back with their body text, not just a
title, so a single call is normally enough to answer the question. | 1 |
Get Building
Last updated on