How to install Ticket-Based IT Experience application to ServiceNow

Getting HappySignals Ticket-Based IT Experience application up and running in your ServiceNow instance is usually very easy and quick. We will be also helping you throughout the installation and set up process.

Before you start:

There are couple of things to note before starting the installation process. 

1. make sure you have administrator access to the ServiceNow instance where you are installing the application
2. make sure you have access to the HappySignals cloud service
3. make sure you have received the following information from HappySignals: 
   1. End-point URLs to your HappySignals cloud services.
      Generally, the end-point URL looks something like: https://[your company name].happysignals.com
   2. A shared secret, which is used to make sure generated feedbacks come from your environment
   3. API-key for two way integration between HappySignals cloud service and your ServiceNow Instance
4. make sure you have requested the Ticket-Based IT Experience application from the ServiceNow store. For details on how to do this, see our article on "How to proceed when you want to download our Application from ServiceNow Store?"

Installing the application:

Installation of the application is very straightforward and requires only a few steps to complete:

1. In the ServiceNow application navigator, find the "System Applications" module. In the "System Applications" module expand the "All Available Applications" section and click on the "All" menu item.
2. In the "All applications" page, type "HappySignals" to the search bar. In the application list below find the Ticket-Based IT Experience application and click the "Install"-button. Confirm the installation in the modal that pops up.
3. Wait for the installation to complete and you have successfully installed the HappySignals Ticket-Based IT Experience to your ServiceNow instance.

Configuring the application:

Once you have installed the HappySignals Ticket-Based IT Experience application to your instance you can start the configuration process.

Before you begin next steps:

1. switch your application scope to "Ticket-Based IT Experience"

Now, you are ready to set up the General Properties:

General properties of the application determine how the application connects to HappySignals cloud service,

1. in the ServiceNow application navigator find the HappySignals Ticket-Based IT Experience application and click on the "General Properties" module.
2. we have provided some defaults on the properties which work for most of our customers, but the exact configurations will depend on how you set up your organizational processes. We recommend that you start with our default set up, test and learn how things work with Ticket-Based IT Experience and then modify the properties as needed.
3. The main properties you need in order to get the Ticket-Based IT Experience application working in your instance are described below.
   

   Property	Description	Default value
   Happy Cloud Service end-point	This is the end-point URL to your HappySignals cloud service. Generally, this looks something like: https://[your company name].happysignals.com	https://support.happysignals.com/need-subscription/wow?
   The word for proof of origin in email functionality.	This is the shared secret provided to your company by us.	[none]
   HappySignals vendor API key	This is the API key that is required for two-way integration between HappySignals cloud service and ServiceNow.	●●●●●●●

4. Once you have set up these three main properties you can move on to setting up the email properties.

Before you begin the next steps:

1. create a new update set to the "Ticket-Based IT Experience" application scope, so you can capture and transfer the configuration changes to test and production instances later.

Setting up email properties:

Email properties determine what data is received and passed on to HappySignals cloud service from a ticket in ServiceNow when feedback is asked. We have provided defaults for most of the properties which work for many of our customers, but the exact configuration will depend on your organizational processes and the data that is available in your ServiceNow instance. 

1. in the ServiceNow application navigator, find the HappySignals Ticket-Based IT Experience application and click on the "Data Properties" module.
2. email properties are divided into three sections:
   
   1. general email properties, which determine the format (HTML or VML) for our feedback buttons in emails and their background color.
   2. incident, which determines which fields in the incident records are used to pass data on to HappySignals cloud service.
   3. requested item, which determines which fields in the requested item records are used to pass data on to HappySignals cloud service.
3. Incident and Requested Item sections, should contain ServiceNow field names from incident or requested item tables, that contain the data you want to pass on to HappySignals cloud service. You can also use dot walking to access related data in the record - i.e. caller_id.location.country will return the country of incident's caller. It is also possible to use literal values in the configurations by surrounding the configured value with quotation marks ("). For example, "Incident" will set the corresponding parameter's value as Incident without resolving it using incident record.

Configure email notifications:

The final step in the configuration process is to add the HappySignals email script to the email notifications where you want the surveys to be sent out.

Before you begin:

1. switch your application scope to "Global" 
2. create a new update set in the global application scope, so you can capture and transfer email configuration changes to test and production instances later.

Now in the ServiceNow application navigator find the email notifications under "System Notifications -> Email -> Notifications"

Find and open the incident notification where your organisation wants to measure service experience. Generally, service experience is measured when the incident is resolved by a service desk agent.

Once you have found and opened the correct notification:

1. navigate to the "What it will contain" -tab and look for the "Message HTML" field.
2. add the following mail script to the "Message HTML" field. This script will add the service experience feedback buttons to the notification email.

   ${mail_script:happysignals_vote}

3. the contents of the notification and placement of the script are up to you, but we hope that you take a look at our best practices on email notifications.
4. once you are happy with the notification content, click on the "Update"-button (or "Save"). After the notification has been saved, you can check that the feedback buttons are showing up in the notification by clicking on the "Preview Notification"-button.

Once you are finished with the incident notification, you can repeat the process for the requested item notification. Since usually, the requested items do not have resolved state, the service experience is measured when the requested item is closed.

Now the base set up for the Ticket-Based IT Experience is complete and it's time to test that everything works.

Make sure everything works as intended:

Testing that the Ticket-Based IT Experience application works is fairly straight forward. 

1. create a new Incident in your ServiceNow instance.
2. make sure the incident contains data you want to send to HappySignals cloud service.
3. resolve the incident you created.
4. in the ServiceNow application navigator, find the email log under "System Logs -> Emails" and check that an email has been created for the incident you resolved.
   
5. open the email and click on "Preview HTML Body". In the preview click on one of the feedback buttons and our feedback form should open to a new window or a tab. Fill out the feedback form and click "Submit" at the bottom of the page.
   
6. Now in your ServiceNow application navigator find the HappySignals integration job under "HappySignals Ticket-Based IT Experience -> Integration Job". 
7. Set the integration job to "Active", if not already. Then click on on the "Execute Now", button to fetch all new feedback from the HappySignals cloud service to your ServiceNow instance.
   
8. Now in the application navigator find the HappySignals feedback list under "HappySignals Ticket-Based IT Experience -> HappySignals Feedbacks". Open the list and check that your feedback appears on the list.

You have now tested that the feedback buttons on the email notifications are being generated correctly, the feedback is collected by HappySignals cloud service, and that the integration between the cloud service and your ServiceNow instance is working correctly. For additional test cases see our examples before production use.

That's it, you have now installed and configured HappySignals Ticket-Based IT Experience application to your ServiceNow instance.