Documentation
DocumentationDeveloperAcademyCommunitySupportLogin
Start typing to search…

Ticketing Configuration Overview [DEPRECATED]

1. Step 1: Connect to a Ticketing system

  1. Navigate to Ticketing > Ticket Settings > Ticket Mapping and click on New Ticketing System Setup.
  1. Enter a Name for the ticketing system - Be sure to assign a clear and concise config name for the integration to ensure easy recognition by all users. It's useful to indicate the team (i.e: IT, HR, Finance, etc.), and the level of the environment (i.e: Prod, Sandbox, Dev, etc.).
    2. Example: Use names like "Servicenow-IT-prod" or "freshservice-HR".
  2. Enter the Bot Service account Id. This is typically the backend user ID for the service account in your Ticketing platform. In ServiceNow, this is the sys_id.
  3. Enter the Ticket redirect URL format- In the Moveworks AI Assistant, each ticket includes a link back to the service portal in the Ticketing System.
    1. For ServiceNow, this can be left blank to leverage the default Service Portal URL.
    2. For Jira, it would be: https://your_tenant.atlassian.net/servicedesk/customer/portal/3/ -- be sure to replace 3 with the Service Desk ID.

For any other system, you can follow the instructions below to get a sample Redirect Link

  • Navigate to a ticket within your end user Service Portal.
  • Copy the URL shown in the browser.
  • Replace the ticket number with a placeholder such as {ticket_id}.
  1. Enter the Link to view all tickets - This is a link to the ticketing system page, where users can view all their open tickets. It is presented to users when they access the 'View All Tickets' option in the Assistant.

Once you have completed your configuration, select NEXT: Add Destinations

Select Ticket Types

Moveworks classifies tickets into different internal ticket types. These are used for different purposes under ticketing workflow


Once a ticket type has been selected we will need to define the Destination Table under it in order for Moveworks to interact with it.

Ticket Type Eligibility for Concierge

This where we need to select the Type of tickets which should be polled and supported by the Concierge skill.

If a ticket type is selected in this field, that ticket type will be polled actively and users will be notified about the updates to the tickets and also nudge you when there have been no updates on the ticket.

Ticket Type Eligibility for Polling

This where we need to select the Type of tickets which should be polled by the Ticketing Engine.

If a ticket type is selected in this field, that ticket type will be polled actively and will then go through the ticketing life cycle via the Moveworks AI Assistant.

Note : The polling of tickets is also defined by the Ticket Filters which are defined under the Ticket Filters configuration page.

Step 2) Configure Ticket Destinations

Once you have selected the Ticket Types and defined the Ticket destination tables, we need to provide additional details on individual ticket destination. Adding these configurations will enable Moveworks to read tickets from your system and perform Create/Update/Resolve/Reopen action on the tickets.

Map Ticket Structure

Mapping the ticket structure of your ITSM system to Moveworkes, allows Moveworks to understand what the ticket data contains and what will be represented back to the user.

For Example :

  • Understanding who the requestor is
  • Understanding what the state ticket is currently under

Map Prefix

Adding a Prefix to the ticket type adds a prefix to the ticket link when it is provided in the AI Assistant. This will help identify unique ticket types within bot.

For example

  1. Add IT as a prefix for the ticket destinations where IT tickets are getting stored.
  2. Add HR as a prefix for the ticket destinations where HR tickets are getting stored.

Map State Transition

Mapping state transition allows Moveworks to understand the ticket workflow which is currently running in your ITSM system. This can be simply done in two states :

  1. From States - Choose the states from your current system and link them with Moveworks' system. This will help Moveworks identify and understand your system's states
  2. To States - Choose the state in your current system that you want to match with a state in the new system. This match is important when you’re performing actions in your current (external) system.

Map Domain

Domain mapping allows segregation of ticket types under different domain. Map your IT related tickets under IT domain and HR related ticket under HR domain. This will help down stream to define impact when looking at Ticket data in Analytics.

Map Ticket Action Default payloads

In order to manage tickets effectively within your system, the following payloads must be configured for different ticketing actions. These payloads define the data necessary for each API call to function correctly.

  • Create Ticket Payload
    This payload is utilized when creating a new ticket. It is used in a POST method API call, requiring specific attributes to be included in the payload to successfully file a ticket. Common Required Attributes:
    • Title: The subject or short description of the ticket.
    • Description: Detailed information about the issue or request.
    • Requester: Information about the person creating the ticket.
    • Priority: The urgency of the ticket.
    • Category: Classification or type of the ticket.
  • Update Ticket Payload
    This payload applies when updating an existing ticket's details. It allows for modifications to be made based on new information or status changes. Common Required Attributes:
    • Ticket ID: Unique identifier for the ticket to be updated.
    • Updated Fields: Any fields within the ticket that need to be changed, such as status, priority, or additional comments.
  • Resolve Ticket Payload
    This payload resolves a ticket, indicating that the issue has been addressed and the ticket can be closed. Common Required Attributes:
    • Ticket ID: Unique identifier for the ticket to be resolved.
    • Resolution Notes: Details regarding how the issue was resolved.
    • Resolution Date: The date and time when the ticket was resolved.
  • Reopen Ticket Payload
    This payload is used to reopen a previously closed ticket, typically used when an issue resurfaces or wasn't fully resolved. Common Required Attributes:
    • Ticket ID: Unique identifier for the ticket to be reopened.
    • Reason: Justification for reopening the ticket.
    • Additional Comments: Any new information or context required to address the issue further.

For capability details, see: Concierge Assistant

Updated about 8 hours ago