Skip to main content
Skip table of contents

Exporter for Qualtrics

This documentation references external sources. Nexthink does not have control over the accuracy of third-party documentation, nor any external updates or changes that might create inconsistencies with the information presented on this page. Please report any errors or inconsistencies to Nexthink Support.

Introduction

The integration for Qualtrics improves workplace technology experiences by combining the power of operational data (O-Data) from Nexthink and employee experience data (X-Data) from Qualtrics. It enables the identification of behaviors by leveraging operational data from Nexthink via NQL and triggering Qualtrics surveys to collect information from users in a timely manner.

Pre-requisites

This integration requires:

  • The connector for Azure AD to get employee email addresses. For more information on how to enable the connector, refer to the Connector for Azure Active Directory documentation.

  • NQL queries that are available as part of Data Export.

  • Administrator privileges for the Nexthink web interface to configure the integration.

  • Brand Manager role for Qualtrics to configure the integration.

  • All the necessary resources that are created in Qualtrics: directory, survey, message and mailing list.

Configuration

1. Define behavior using NQL

To distribute a Qualtrics survey, the system evaluates an NQL on a scheduled basis. It then distributes the survey to the user emails returned by the NQL query.

The NQL query used to trigger a Qualtrics survey must return:

  • only one field

  • a field that contains an email address.

Consider the following examples.

Users who are not using a recently rolled-out application actively

CODE
users
| with execution.events during past 7d
| where binary.name == "teams.exe"
| compute total_connections = number_of_established_connections.sum() + 
number_of_rejected_connections.sum() + 
number_of_no_service_connections.sum(), 
total_focus_time = focus_time.sum()
| where avg_focus_time > 1min and total_connections > 150
| list ad.email_address

Users who have significantly used a recently rolled-out application

CODE
users
| with execution.events during past 7d
| where binary.name == "*teams*"
| compute total_connections = number_of_established_connections.sum() + 
number_of_rejected_connections.sum() + 
number_of_no_service_connections.sum(), 
total_focus_time = focus_time.sum()
| where total_connections < 5 and total_focus_time < 1h
| list ad.departent 

Users that are experiencing too many crashes with a specific application

CODE
users
| with execution.crashes during past 5d
| where binary.name in ["*zscaler*"]
| compute total_crashes = number_of_crashes.sum()
| where total_crashes > 10
| list ad.city

Users who haven't responded to a specific Engage campaign

CODE
campaign.#RemoteWorkDemo.responses
| where campaign.status == published 
and state == targeted 
and state_details != fully
| list user.ad.email_address

Users who are not very active on any of the communication apps

CODE
users
| include collaboration.sessions during past 5d
| compute max_duration = duration.max()
| where max_duration < 15min or max_duration == null
| list ad.email_address

Validations

  1. Returning more than one field in the NQL query will throw a validation error

  2. Returning a field that is not linked to the user object will throw a validation error

2. Configuring (Qualtrics) Credentials

Configure the credentials to access Qualtrics from the Nexthink web interface:

  • Select Administration from the main menu.

  • Select Connector credentials located under Integrations in the navigation panel.

Accessing Connector credentials
  • Create a New Credential.

  • Select OAuth as the authentication mechanism.

  • Fill in the following values:

    • Name: credential name

    • URL address: taken from the Qualtrics URL - https://nexthinkdev.qualtrics.com/

    • Authorization: OAuth 2.0

    • Access Token URL: https://nexthinkdev.qualtrics.com/oauth2/token

    • Client ID: obtained from Qualtrics

    • Client secret: obtained from Qualtrics

    • Scope: manage:all

  • Save the credential.

Refer to the Connector credentials documentation for more information on how to manage credentials.

3. Configure (Qualtrics) Data Export

Configure the outbound connector to distribute a Qualtrics survey:

  • Select Administration from the main menu.

  • Click on Outbound connectors from the Integrations section of the navigation panel.

  • Select Data Exporter from the table.

  • Click on the New exporter button located at the top right of the page.

General tab

  • Select Qualtrics as the Destination.

General tab
  • Fill in the identifiers from Qualtrics using the following convention:

    • Survey Id: must start with SV_

    • Directory Id: must start with POOL_

    • Message Id: must start with MS_

    • Library Id: must start with UR_

    • Mailing List Id: must start with CG_

    • From email: must be noreply@qemailserver.com

    • From Name: name of sender

    • Subject: subject of email

Refer to Qualtrics documentation for more information.

Data tab

  • Recurrence: Select the frequency of how often the system will evaluate the NQL query.

  • NQL Query: Enter the NQL query defined in step 1.

  • Click Test Load up to 20 records button to test the query.

  • Click Save.

4. Check that the system has distributed the survey

  • Log in to Qualtrics using your credentials.

  • Open the survey you have referenced in Nexthink using the filter on the home page.

Opening the survey in Qualtrics
  • Open the survey.

  • Open the Distributions tab.

Distribution tab in Qualtrics
  • Select the Email option. A new entry appears with the date indicating when you have triggered the survey.

  • All entries in the list indicate:

    • The number of times the system has distributed the survey (1).

    • The number of users the system has sent the survey out to (2).

    • The status of the survey (3).

Entries in Qualtrics

Troubleshooting Guide

The system is not sending the survey

There may be many reasons why the system is not sending a survey. Below is a list of the most common reasons:

  • Wrong credentials: Check the credentials configuration.

  • Wrong Qualtrics Id: Make sure the IDs selected from Qualtrics match the prefixes specified in the placeholders when configuring Data Export.

  • Wrong from email: Qualtrics only allows a subset of emails when distributing a survey. The values are:

    • <noreply>@qemailserver.com

    • <noreply>@qualtrics-survey.com

    • <noreply>@qualtrics-research.com

Replace <noreply> with any username.

  • Wrong NQL query: Qualtrics distributes surveys to a list of user emails that the NQL query specified in Data Export must return. Verify that the NQL query always returns a list of valid emails. Refer to the Investigations documentation for more information.

  • Multiple surveys target the same users within the same hour: Qualtrics avoids distributing multiple surveys to avoid saturating the recipients of those surveys. If the system sends the same survey to the same users within the same hour, Qualtrics blocks it, and the distribution appears with the comment “X Duplicated Emails” and 0 for targeted recipients.

    Message in Qualtrics

    In this scenario, we recommend customizing the Email Message to add the timestamp, so the message differs every time.

  • The system sent the survey, but it didn’t reach the entire list of recipients: There may be a scenario where the system does not deliver surveys to a subset of targeted recipients. In this case, Qualtrics provides a message detailing what the problem could be:

    Message in Qualtrics
  • The emails with the surveys are marked as Spam: This might be the email server policy at your company or individual settings of the user’s email that identify Qualtrics emails as spam. Refer to the Include Quality Email Content documentation for more information.

F.A.Q.

What happens if the NQL query doesn't return a list of emails?

If the NQL query added as part of the Qualtrics Data Export configuration doesn’t return a valid list of email addresses, the system will not distribute the survey.

What if I want to distribute a survey for a list of devices?

This is impossible since the integration only distributes surveys to users, not devices.

How do we know if anything has gone wrong in the execution of the Qualtrics Data Exporter?

Currently, Nexthink does not offer a way of knowing the execution status of any Data Export. This capability will be available in upcoming releases.

Track the status of each survey distribution in Qualtrics.

Is there another mechanism besides email to distribute a Qualtrics survey?

The existing Nexthink integration with Qualtrics only allows for survey distribution via email.

How can I improve the Qualtrics email message?

Customize the email message in Qualtrics.

What happens if the NQL query doesn't end up returning an email address?

If by mistake the field returned as part of the NQL query is a user field, but doesn’t have an email format. There will be an error that will be registered in Nexthink and the email won’t be sent out. In the future, the execution status will be retrieved to know what exporters have errors.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.