https://support.tethr.com/hc/en-us/categories/360001781174-Connect-apps-services Connect apps & services
https://support.tethr.com/hc/en-us/sections/360008093594-Qualtrics Qualtrics

Connect Qualtrics with Tethr

New feature: content organization, collaboration and filtering

This article describes a new feature that may not be available to all users. If you don't see this feature and want to learn more, please contact your Tethr admin.
Section only

Sync Qualtrics and Tethr together to see your customer phone and chat conversations—and rich Tethr voice intelligence—in your Qualtrics dashboard. This article covers the initial OAuth client setup in Qualtrics and configuring the connection between the two applications within Tethr. 

This connection combines Tethr's research-backed CX, marketing and sales insights with Qualtrics survey data, giving the voice of your customer in surveys an iQ-boost. Drill-down into the interaction from your Qualtrics dashboard, revealing each customer conversation's insights, a full transcript, playback, CRM integration and the Tethr Effort Index (TEI) automated effort score.


What we'll cover:

  1. Create client credentials in the Qualtrics OAuth client manager

  2. Authenticate your Qualtrics client credentials in Tethr and create a new Qualtrics project

  3. Define data to send to your Qualtrics dashboard in Tethr

  4. Define the filter criteria to trigger what Tethr sends to your Qualtrics dashboard

  5. Enable your new Qualtrics integration in Tethr

Before you begin:

  • You must be a Tethr Admin to add the Qualtrics integration with Tethr.
  • Qualtrics must be enabled for your organization to add the integration. If it's not, first submit a support ticket to get Qualtrics enabled.
  • You’ll need a Qualtrics account to connect it with Tethr. This account will have client credentials you'll use in Tethr to connect your Qualtrics project and allow it to receive your customer interactions and metadata from Tethr.

    When authenticating the integration, if you’re creating an OAuth client in Qualtrics and don't see the grant type you’ll need, you may need a different level of permission. We suggest requesting another level of permission from your Qualtrics Brand Administrator.

    Note that the Brand Administrator user type has the correct permissions to authenticate an integration between Qualtrics and Tethr.

Getting started: First, to get familiar with this integration, read the Guide to Qualtrics Voice iQ: powered by Tethr. There, you'll learn the latest features and benefits of the Qualtrics integration with Tethr, access a product demo of the integration and learn key concepts of how Tethr and Qualtrics connect, read common use cases the integration solves for, get tips & tricks for using the Qualtrics integration and learn how to get the Qualtrics add-on now or get set up with Tethr.

If you're already a Qualtrics and Tethr customer Admin and you've gotten the Qualtrics Voice iQ add-on powered by Tethr, start here: Log into Qualtrics, then log into Tethr using your administrative privileges. You'll want both applications open at the same time during step one and step two, as you'll be directly copying sensitive client credentials between the two that you won't want to leave open access to. 


Step 1: Create client credentials in the Qualtrics OAuth client manager

Tethr requires you to create OAuth credentials and not an API token in Qualtrics. Please note that if you generate an API token, it can break existing integrations associated with your Tethr account.

    1. Under your Qualtrics account Profile, select Account Settings. 
    2. Within the My Account navigation, select the Qualtrics IDs tab and then the OAuth Client Manager tab.
    3. Choose the + Create Client button and complete the following OAuth client credential fields:

      Create_OAuth_client_credentials_in_Qualtrics_under_Account_Settings.gif

      Within the Create Client pop-up complete the following fields:

      a) Name: give your OAuth client connection a name that indicates the type of integration. For example, “Tethr connection”.
      b) Contact: enter your optional email address, for example, Name@company.com.
      c) Choose your Grant Type from the menu. In this case, Client Credentials.
      d) Select the + Create Client button to create the Qualtrics OAuth client credentials you'll use to sync with Tethr.

      Complete_OAuth_client_credentials_in_Qualtrics_to_create_a_new_client.gif
    4. Securely copy the newly-created client credentials (Client ID and Client Secret as shown below) directly from Qualtrics into Tethr.

      Secure_client_credentials_for_the_Qualtrics_OAuth_client.png

Step 2: Authenticate your Qualtrics client credentials in Tethr and create a new Qualtrics project

In this section, you'll begin creating a new Qualtrics integration by securely entering the client credentials you just created in Qualtrics into Tethr to authenticate the connection. Then, you'll create a new Qualtrics project from Tethr.

    1. Under your Tethr account Profile, select Settings. 
    2. Within the Settings' left side menu under the Admin section, select Integrations.
    3. Choose the Add integration menu and select Qualtrics.

      Select_Qualtrics_under_Add_integration_in_Tethr.png
    4. You'll be asked to authenticate your Tethr credentials by confirming them. If your credentials are correct, select Authorize to proceed.

      Authorization_required_for_this_admininstrative_Tethr_action.png
    5. Within the new Qualtrics integration, under the Authentication section select the Add authentication button, then complete the following fields:

      a) Client ID: copy and paste the OAuth client identifier you created in Qualtrics.
      b) Client secret: copy and paste the OAuth client secret you created in Qualtrics.
      c) Qualtrics subdomain Enter only the subdomain name found at the beginning of the URL to your Qualtrics account. For example, if your Qualtrics account URL is https://company.qualtrics.com/ you'd enter "company.ca1."
      d) Select Update credentials to securely authorize the connection between Qualtrics and Tethr.
      e) You'll be asked to re-authenticate your Tethr credentials. If your credentials are correct, select Authorize to proceed.

      Add_authentication_credentials_from_Qualtrics_into_Tethr___Qualtrics_integration_with_Tethr_blurred.png
    6. Once authenticated, select the Create project button to create a new project in Qualtrics and send Tethr insights to it in the form of survey questions. In the pop-up, enter the name of the project you created in Qualtrics into the Project name field in Tethr and select the Create project button to proceed.

      Note: You may be asked to re-authenticate your Tethr credentials. If your credentials are correct, select Authorize to proceed.

      Create_a_new_Qualtrics_project_in_Tethr___Qualtrics_integration_with_Tethr.gif
    7. The newly-created Qualtrics project may look like the following inside your Qualtrics Projects Section.

      Note that the survey languages and questions will be defined by the insights you choose to send from Tethr to Qualtrics and the trigger criteria you set up in step three and step four below. 

      Your_new_Qualtrics_project_created_in_Tethr_will_look_like_this_under_the_Projects_tab___Qualtrics_integration_with_Tethr.png

Step 3: Define which insights to send to your Qualtrics dashboard in Tethr

In this section, you'll choose which insights you'd like to sync bi-directionally from Tethr to your Qualtrics dashboard. You'll be able to select customer interaction metadata and preview the order and format of your data before you choose to send it to your Qualtrics survey.

Types of Data you can share:

Within your new Qualtrics integration inside Tethr, under the section Data sent to Qualtrics, you can choose from the following types of customer interaction data to send:

  • Interaction details like date, time, agent, direction, call groups

    Note: To link back to Tethr’s interaction detail from your Qualtrics dashboard select the interaction details option "Link to Tethr interaction" when adding new data types to your integration.

    Customer_interaction_details_you_can_sync_with_Qualtrics_intergration_with_Tethr.png

    To access the direct link to each interaction’s details, follow the link under Reports in your Qualtrics dashboard. These links to each interaction’s detail can be used on your Qualtrics dashboards or anywhere you need to link directly back to the customer interaction details in Tethr.
  • Customer details like name, phone number or customer identifier 
  • Automated scores, like Tethr Effort Index (TEI) or Agent Impact Score (AIS)

    Send_utomated_scores__like_Tethr_Effort_Index__TEI__or_Agent_Impact_Score__AIS__to_Qualtrics_using_embedded_metadata__as_a_question_or_as_values_or_ranges___Qualtrics_integration_with_Tethr.gif
  • Categories, like customer Frustration or customer Effort

    Send_Tethr_categories_to_Qualtrics_as_embedded_metadada_or_as_questions___Qualtrics_integration_with_Tethr.gif
  • Category groups that you've created from multiple categories, like Channel Switch or Billing Reasons can now be sent as a Group (instead of as individual categories) in Embedded metadata field format as a Multi-value text set.

    Send_category_groups_to_Qualtrics_as_embedded_metadata___Qualtrics_integration_with_Tethr.gif
  • Custom metadata that your organization has defined
  • and Call group types that will include groups of users, or teams, with access to a specific subset of calls, like your customer service agents for a specific product, in a specific region or your sales, product, compliance or HR teams
Tip: Select the Done button when you're finished choosing and previewing your data selections. Be sure to save your selections by using the Save button in the top-right header of the integration. You may be automatically prompted to save your integration after you've made your data selections and before you choose your triggers in the next section. Once you save your integration in Tethr, your Qualtrics project will be updated with the new insights you've chosen.

 

Field formats you can choose:

Send data in the following field formats using Tethr's Qualtrics integration.

  • Question format: customer Frustration category becomes an individual survey question in Qualtrics.

  • Group format: send the entire customer Effort category group through to Qualtrics instead of only individual categories.
  • Embedded metadata: the customer Effort category group becomes a comma-delimited list of all categories within that group, giving you more graphing options within Qualtrics Stats iQ. Use embedded metadata format for customer interaction data like the email of a survey responder and their location coordinates or any metadata about the survey responder that aren't necessarily questions. These are then attached to the survey.

  • Multi-value text set: sends through comma-delimited individual categories under a group that actually occurred on a call instead of sending the entire category grouping. In Qualtrics you'll see the categories as a set allowing you to display them across bar graphs, etc.

  • Boolean: a category or group of categories will show a yes or no if they occurred in a customer interaction or not.

  • Numeric: a category or group of categories will show a 1 or 0 if they occurred in a customer interaction or not.

  • Value: for a score, choose to show the individual score value (for example, Average).
  • Range: for a score, choose to show the individual score range between 0-10 (for example, 4.6).

 


Step 4: Define the filter criteria to trigger what insights Tethr sends to your Qualtrics dashboard

In this section, you'll choose the criteria that will trigger Tethr to send the insights you've chosen in the previous section to your Qualtrics dashboard.

Required: interactions cannot be sent to Qualtrics without triggers.
  1. Within your new Qualtrics integration in Tethr, under the section Triggers with this integration select the Choose triggers button to specify filter criteria that will trigger Tethr to send the data you just defined in the previous section to Qualtrics.

    Triggers are the same filter criteria you'll see in Tethr's Filter panel on Search & browse. Triggers allow you to refine your interaction data further by date and time constraints, country, language, categories, custom groups (teams), talk time, agents, customers, number dialed and more. 
  2. Make sure to Name your trigger something memorable that reflects the type of criteria you choose and insights you're passing through. For example, "U.S. Sales closer or provider." You can easily name or rename your trigger by clicking the Name of the trigger and typing into the field that appears. Any edits to the name will need to be saved.
  3. You may be prompted to Save your trigger at this point or any previous changes you've made may be lost.

    Tip: As you save each new trigger, your new Qualtrics project will be updated with the new filter criteria you've set.
  4. Triggers you configure can be enabled or disabled separately from the integration within the Triggers page.

Step 5: Enable your new Qualtrics integration in Tethr

Once you've authenticated the connection between Qualtrics and Tethr, defined the insights you'd like to send and enabled the criteria that will trigger their send, then saved your settings, enable the integration.

Enabling the integration will prompt interactions to begin flowing through from Tethr to your Qualtrics project.

Required: a new Qualtrics integration cannot be enabled until you've completed sections 1-4 above.
Important note: some of the following actions could invalidate your Qualtrics project and disable it including deleting a Tethr-generated Qualtrics project or deleting/changing its OAuth client credentials from your Qualtrics account.
  1. At the top of your new Qualtrics integration in Tethr, just under its name, are two options to enable or disable the integration. 
  2. Make sure to Name your integration something memorable that reflects the type of connection and insights you're passing through, or the type of project. For example, "New U.S. customer survey integration." You can easily name or rename your integration by clicking the Name of the integration and typing into the field that appears. Any edits to the name will need to be saved.
  3. You may be prompted to Save your integration at this point or any previous changes you've made may be lost.
  4. Once you've enabled and named your new Qualtrics integration, interactions (calls and chats) that match the data and trigger criteria you've set will begin flowing from Tethr into your Qualtrics project.

Articles in this section