Freshservice Access Requirements
Why do we need access to your Freshservice Instance?
The bot will directly perform actions in Freshservice to create, update, and query information about tickets.
Freshservice Permissions
The Moveworks service interacts with your Freshservice platform so that the bot can:
- monitor tickets for autonomous resolution;
- reach out to an employee when a ticket needs the employee's attention;
- create tickets to log issues the bot has resolved autonomously;
- create tickets for issues that require an agent's attention;
- load Freshservice forms so that the bot can serve them to employees; and
- read the Freshservice user roster so that the bot can log and assign issues appropriately.
- read and index knowledge base articles to serve to users in your Moveworks bot.
What is this account used for:
A dedicated service account in Freshservice allows the Moveworks service to read and update tickets, and read users, forms, and knowledge articles.
Access Requirements
Create Custom Moveworks Admin Role
To grant the necessary roles, Agent Role titled "Moveworks Admin" and check the following boxes in the following two sections under Permissions and Scope:
- View Tickets
- Send reply to a ticket
- Edit ticket properties
- Create and Edit Tasks in Tickets
- View or Edit time entries
- Edit everyone's time entries
- Scope: Global Access
- Administration
- Perform Operational Admin actions
- Manage Agents
- View Requesters
- Assume Requester Identity
- View Department
- Create/Edit Service Items/Service Category
- Perform Operational Admin actions
- Solutions
- View Solutions Tab
- Manage Solution Categories & Folders
- View Solutions Tab
Create Service Account
Create a new Full-Time agent account for the Moveworks bot and assign the "Moveworks Admin" role. Please note that the timezone for this account should be: (GMT+00:00) UTC
Share Credentials
Share the following information with your Customer Success team:
- API key of this account
- Freshservice domain/URL (i.e.
https://customer.freshservice.com
)- Even if you have a custom CNAME, Moveworks requires the actual domain for the integration.
Service account in test/dev
If you have a Freshservice sandbox instance, replicate the above steps to create a service account in the sandbox. Otherwise, create a test group named "Moveworks - test" in your Freshservice instance to utilize for testing.
What is this account used for:
This account is used for testing, please grant access to an instance that is the closest to your prod instance for the Moveworks Team for testing purposes before changes are deployed in production and also for the IT Testing phase.
Updated about 2 months ago