Administration Guide

Customer Satisfaction Survey

On this page

Incidents, service requests, and work orders each carry a rating flag that says whether the requester may rate the ticket's outcome. The flag is off by default, and no rule in the database turns it on; in the supplied configuration, the survey workflow does (see The survey in the supplied configuration). For how workflow is built, see Workflow Overview.

A rating is a score with a comment. A ticket keeps at most one rating, the requester's. When the requester rates the ticket again, the new rating replaces the earlier one, and a rating from anyone other than the requester is not kept.

For the requester's side of a ticket, see Track Your Tickets. For tickets in general, see Tickets.

The survey in the supplied configuration

A new 2026.1 database created with the Default Workflow contains a satisfaction survey for incidents and service requests, built from workflow triggers, a workflow function, e-mail notifications, and workflow parameters. A database upgraded from an earlier version need not contain it, and an administrator may have changed it. See Default Workflow Configuration.

When the survey is sent

The Incident workflow and the Service Request workflow each have four timed triggers:

  • Send Initial Survey Request
  • Send First Follow up Survey Request
  • Send Second Follow up Survey Request
  • Send Third Follow up Survey Request

A trigger fires for a ticket when all of these hold:

  • The trigger's delay has passed since the ticket's completed date. The initial request waits the number of minutes, and each follow-up the number of hours, that its survey parameter sets. Every delay, the follow-ups included, is counted from the completed date.
  • The ticket has no rating yet. Once the requester rates the ticket, no further survey request is sent.
  • Enable Feedback Survey For covers the ticket's class.
  • An incident is Resolved or Closed; a service request is Completed or Closed.

What a survey request does

Each trigger calls the class's Send Survey function for the ticket's requester. The function:

  1. Turns the ticket's rating flag on. In the supplied configuration, this function is what sets the flag, not a resolve action.
  2. Logs an activity on the ticket; for the initial request, it reads "Initial Survey Request sent".
  3. Runs Send Push Notification to Self-Service Requester.
  4. Sends one e-mail to the requester's primary e-mail address. Its subject is a subject opening from the survey parameters followed by the ticket's summary; on a service request, a colon follows the opening.

The e-mail is one of two kinds:

  • While Enable Graphical Survey Submission is off, as it is set in the supplied configuration, the function sends the plain e-mail. The initial request carries a GIVE FEEDBACK button that links to the ticket's survey in the Self Service Portal. The follow-up requests carry a button that links to the same address.
  • When Enable Graphical Survey Submission is on, the function sends the graphical version of the e-mail. The parameter's description says the feature requires the API to be installed and working. On an incident, the graphical initial request carries five one-click rating links, for the ratings 1 to 5. A click runs the API Survey Vote action through the API. The action records the chosen rating on the ticket, with the comment "Rated by" followed by the person's name, and it is offered only while the person has not voted yet. The links expire three days after the survey request is sent. When the vote is recorded, the browser shows a page with the message "Thank you for your feedback"; a link that has expired shows "The link has expired."

What turns the flag off

On an incident, the actions Reopen Incident and Assign to... turn the rating flag off again. Of the supplied action forms, only API Incident Update and API Service Request Update list the rating flag.

No supplied notification or trigger reacts to a low rating.

Survey parameters

The Satisfaction Surveys category of the workflow parameters holds the survey's switches and texts. In the supplied configuration they are set as follows:

Parameter Set to in the supplied configuration
Enable Feedback Survey For Service Requests and Incidents. The other choices are Incidents Only, Service Requests Only, and Turn off Built-in Surveys.
Delay for Sending After Resolution (minutes) 15
The first, second, and third follow-up delays, in hours 6, 12, and 18
The four subject openings "Please tell us how we did!", "We'd love to get your feedback!", "Tell us about your experience!", and "We haven't heard from you!"
Enable Graphical Survey Submission Off

In the Admin Center

Change the survey parameters

The Satisfaction Surveys category is part of the supplied configuration (see The survey in the supplied configuration). For the Admin Center itself, see Admin Center and Settings App.

  1. In the Admin Center, go to Workflow and Business Logic > Workflow Configuration.
  2. In the category tree, open Satisfaction Surveys. The page shows one control per parameter.
  3. Change the values you need. Save and Cancel appear once a field has changed.
  4. Click Save.

The page does not check the values you enter against the parameters' declared validation rules. If you leave the page with unsaved changes, it asks "You should save you changes before leaving this page. Do you want to leave this page?"

What you can see and change

Two permissions, in the Customer Satisfaction Rating group, decide whether the ticket lists show a ticket's rating to a technician:

Permission What it allows
View All Ratings Browse and view the ratings of all tickets.
View Own Ratings Browse and view the ratings of tickets for which you are the assignee.

The Incident and Service Request lists include the requester's rating, on a scale of 0 to 5, and the requester's comment. You see them on a ticket when you hold View All Ratings, or when you hold View Own Ratings and are the ticket's assignee. Otherwise the ticket is still listed, with empty rating columns.

In the Settings App

Grant the rights that show ratings

The security role editor lists View All Ratings and View Own Ratings in the Customer Satisfaction Rating group of its permission tree. Tick the permission you want the role to grant, and save the role. For how to open and edit a role, see Security Roles.

Check which rating rights an account holds

Open the technician account's Effective Permissions tab in the Settings App to check whether any of its roles grants View All Ratings or View Own Ratings. If you changed Member Of, save the account when prompted before opening the tab.

For how the tab combines roles and displays organization and workspace restrictions, see Effective permissions in the Settings App.

Supplied satisfaction reports

Four supplied summary reports measure customer satisfaction, two for each ticket class:

Report Filed under
Customer Satisfaction Rating (Incidents) Incident Management and List
Customer Satisfaction Rating by Technician (Incidents) Incident Management and List
Customer Satisfaction Rating (Service Requests) Request Management and List
Customer Satisfaction Rating by Technician (Service Requests) Request Management and List
  • The two Customer Satisfaction Rating reports list the rated tickets submitted between the Date From: and Date To: parameters. The Service Request report also runs with both dates empty. Group By: offers Type, Category, Impact, Urgency, Priority, Service, Assignee, Assignee Group, and Location; the default is Assignee.
  • The two by Technician reports list the rating, assignee, type, category, project, and organization of active tickets created between the same two dates, rated or not. Group By: offers Technician, Type, Category, Organization, and Project, and Sort By: offers Technician.

The reports read the rating from the ticket lists, so a report shows a ticket's rating only when the lists show it to you (see What you can see and change). In the Web App's report category lists, the Incident reports are listed only when your roles hold the permission to view any incident and the license permits it. The Service Request reports likewise need the permission to view any service request. Holding only the view permissions for your group's tickets, for tickets assigned to you, or for tickets you requested does not list them. Running reports is itself a permission, described as allowing you to run reports; which reports its holder sees is decided by the rule above. See Permissions Reference.

Supplied satisfaction dashboards

A new 2026.1 database created with the Default Workflow also contains shared dashboards that show the ratings; see Default Workflow Configuration.

  • IT Service Management KPIs shows the chart Incident Survey Ratings, which counts the incidents created this week by rating, and the chart Technician by Customer Rating, which shows the average rating by assignee for this month so far. Its report list widget, (Metrics) Key Performance Indicator (KPI) Reports, lists the Customer Satisfaction Rating (Incidents) and Customer Satisfaction Rating (Service Requests) reports as KPI Incidents Customer Satisfaction Rating and KPI Requests Customer Satisfaction Rating.
  • Service Request Management shows the chart Service Request Survey Ratings, which counts the service requests by rating for this year so far. Its report list widget, (Service Request Management) Service Request Management Reports, lists the Customer Satisfaction Rating (Service Requests) report.

In the Web App, a report list widget leaves out a report that the viewer may not see, without a placeholder.

The charts plot the rating from the ticket lists, so they show ratings only to a technician who holds a rating right (see What you can see and change).

What technicians see in the Web App

In the Web App, the General tab of an incident, a service request, or a work order can show a Feedback panel. On a service request, it follows the Performance panel. For working with tickets in the Web App, see Tickets. The panel shows:

  • The requester's rating as stars, read-only, at half-star precision.
  • The requester's comment, in a read-only box.
  • The rating flag, when the form carries that field. On a work order, the rating flag is hidden.