ServiceNow Writeback

You’ll need to set-up a ServiceNow Thermometer within Customer Thermometer before following the steps below. Our ServiceNow Thermometer guide is here.

ServiceNow Setup

Download the Customer Thermometer ServiceNow XML from here.

Login to your instance of ServiceNow and go to System Update Sets > Retrieve Update Sets:

Select Import Update Set from XML from the Related Links at the bottom of the page.

Import the CustomerThermometer.com – ServiceNow Integration.xml File.

Preview and Commit the Update Set:

Once the Update Set has been committed, navigate to System Security > Users and locate the Customer Thermometer User record:

Change the password to a unique password.

This password will be used to allow the Customer Thermometer integration access to your instance and should match your Webhooks password you will set later:

Customer Thermometer Setup

Within Customer Thermometer, navigate to the drop down on the right-hand side > Automations > Webhooks and click Configure Webhooks:

Click on Add new endpoint:

Name your Endpoint something relevant, for instance ‘ServiceNow writeback’.

Enter the following endpoint URL, ensuring you enter the correct instance name in bold below:

https://YourInstanceName.service-now.com/api/now/v2/table/u_ct_update

Select your required event triggers:

Authentication

Basic authentication is required to update the required tables in ServiceNow. The Customer Thermometer User record installed with the ServiceNow update set contains the correct roles to do this.

The password should match the one you set earlier, in order for the integration to work.

Enter the following details:

Basic Auth Username > Customer Thermometer

Basic Auth password > Set Earlier

You can also generate a new password by clicking Generate For Me. Just remember to change the ServiceNow Customer Thermometer User password to match.

Save your Webhook and then test it – click Test fire webhook and wait for a response.

Its status should be Delivered (201).

And a copy of the JSON response should also be displayed below:

If the response is anything other than Delivered (201), then run through the steps above and ensure all details are correct. If you are sure they are correct, consult your ServiceNow System Administrator as extra authentication methods may be required to allow the integration to access your instance.

Linking Thermometers to your Webhook

Click on Linked Thermometers at the top of the page.

Select one or more Thermometers to be used and click Save Webhook:

Your Webhook integration is now ready to use.

When your ServiceNow notification email is sent and a response clicked, that rating and comment will be displayed in the activities feed on your ServiceNow incident.

Optional Extras – advanced writeback

The next step is populating custom fields on your incident/request forms for ServiceNow reporting.

The data received from the webhook as outlined above is stored on an import table before it gets added by transform map to the incident/request table.

The import table contains the following fields which are available to include in the transform if you wish:

Using these fields it will be possible to add and populate custom fields with the data received from your webhook.