Skip to main content
Loading...
  • Customer Experience
    Customer Experience
  • Employee Experience
    Employee Experience
  • Brand Experience
    Brand Experience
  • Product Experience
    Product Experience
  • Core XM
    Core XM
  • Design XM
    Design XM

Legacy Salesforce App Installation

What's on This Page:


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


Attention: Your Salesforce interface may vary from what’s pictured on this page, but the steps remain the same.

About Legacy Salesforce App Installation

Attention: We’ve introduced a new version of the app with an improved installation process. See The New Salesforce App Experience for more details.

This guide is intended to help Salesforce administrators install and properly configure the Qualtrics App on the Salesforce AppExchange. While we do provide step-by-step instructions to complete the installation and configuration, this guide assumes some prior familiarity with Salesforce administration, including editing user profiles, permission sets, object layouts, and search layouts.

Qtip: While most of the functionality is the same for both versions, several sections of this page will split into separate steps for Salesforce Classic and Salesforce Lightning Experience to account for user interface differences. For more on Salesforce Lightning vs. Classic, see Salesforce’s support documentation.
Attention: The app requires access to the Qualtrics v3 API and the Qualtrics Salesforce Extension. If you don’t have access to these features, reach out to your Qualtrics Account Executive for more information.

Contents of the App

The app comes pre-packaged with a number of custom features meant to help with the usage and administration of the app. The purpose of each of these features is briefly summarized below.

CUSTOM PROFILES SETTINGS AND PERMISSION SETS

Custom profiles settings come in two forms: Qualtrics Admin and Qualtrics User. These settings are applied to profiles during the installation process and give different levels of access to features within the app.

  • Qualtrics Admin: Provides access to administrative tools within the app. In addition to distributing surveys, administrators can create and edit them. Administrators can also read and edit Survey records and Survey Response records.
  • Qualtrics User: Provides access to send surveys via the app. Users can distribute existing surveys but are not able to edit or create new ones. In addition, Users are granted read (but not create) permissions on Survey Responses and both read and create permissions on Surveys.

Permission sets is another feature that mirrors the functionality of the profile settings described above, but can be applied at any time and will update with new releases to the app. If a user is given a permission set but is not granted a profile setting during the installation process, they will need to be given permission to view the Qualtrics Surveys tab manually.

CUSTOM OBJECTS

  • Survey Responses: This object is a pre-built warehouse for survey responses. It stores each response to a Qualtrics survey and relates that response back to the record of the survey taker. This object comes with many fields, and these can be hidden, deleted, or added to as desired by a Salesforce Administrator.
  • Surveys: This object tracks surveys that have been distributed through the Qualtrics app. Each time a survey is sent out via the app, a new record is created in the Survey object. Survey responses can be related back to the Survey record when responses are mapped back to Salesforce, making it easier to track survey responses for each distribution sent with the app.

CUSTOM BUTTONS

  • List view buttons: These buttons allow users to generate a List View of Contacts, Leads, or Campaigns and then send a survey to each record in the list view.
  • Campaign layout button: This button allows users to view an individual Campaign record and, from the record view, distribute a survey to the entire Campaign.

CUSTOM TABS

  • Qualtrics Surveys: This tab allows users to view Survey records for surveys that have been sent using the app. It also allows app administrators to specify message settings.
  • Qualtrics Vocalize: If your license currently has CX Dashboards enabled, this tab allows you to view any dashboards that you have access to.

Installing the App

The legacy Salesforce app is no longer widely available. Please use the updated app instead. If you require access to the legacy Salesforce app, please contact Qualtrics Support. Note that not all Qualtrics features may be compatible with the legacy app.

After the initialization process is complete, you’ll be presented with a page asking who you’d like to install the app for. This page is used to apply the custom profile settings mentioned in the prior section. Look at each of the options below to find which setting sounds best for you and follow the instructions for that option.

Qtip: Our recommended method is to install the app for Specific Profiles.

There are three installation options to choose from:

  • Install for Admins Only: This option installs the app only for users with the System Admin profile and grants full administrative access to all System Admins.
  • Install for All Users: This option installs the app for all users in your Salesforce org and grants all users full administrative access to the Qualtrics App.
  • Install for Specific Profiles: This option installs the app for specific profiles and grants varying access levels according to your specifications. Before clicking Install, scroll down and select for each profile what level of access to grant users with that profile: No Access, Full (administrative) Access, or Qualtrics Standard user.

When the installation process is complete, apply the Qualtrics Admin and Qualtrics User permission sets as needed to users you would like to be able to use the app. This will ensure that future app updates will grant these users necessary permissions.

Assigning Permission Sets to Users

To ensure that your app users are updated automatically when changes are released to the app, we recommend assigning the app’s custom permission sets to these users.

Salesforce Classic

  1. Go to Setup, then Administer, then Manage Users, and then Permission Sets.
    Permissions Sets menu
  2. View the User or Admin Permission Set.
  3. Select Manage Assignments.
    Manage assignments option under specific Permission Set
  4. Select Add Assignments.
  5. Use the checkboxes to select the users you want.
    Checkboxes to select users
  6. Select Assign.

Lightning Experience

  1. Click the gear in the upper-right.
    Gear on upper-right clicked and expanded; Setup is second choice down with another blue gear next to it
  2. Select Setup.
  3. Search for “permission.”
    Selecting Permission Sets from the left, then in the list of sets pointing to the names Qualtrics Admin / Qualtrics User
  4. Click Permission Sets.
  5. Select the Qualtrics User or Qualtrics Admin permission set.
  6. Click Manage Assignments. Manage Assignments is next to find setting search box and the clone button
  7. Use the checkboxes to select the users you want.
    Checkboxes to select users
  8. Select Assign.

Adding User Profiles to the Connected App Access Page

Once your app users have been assigned, you’ll also need to add their profiles to the Qualtrics Surveys Connected App page. Once they’ve been added, they’ll be able to access the app.

Salesforce Classic

  1. Go to Setup, then Administer, then Manage Apps, then Connected Apps, then Qualtrics Survey, and then Edit.
    Qualtrics Survey App within Connected Apps menu
  2. Change the Permitted Users option to Admin approved users are pre-authorized. Select OK when prompted.
    Permitted Users set to "Admin approved users are pre-authorized"
  3. Select the Save button.
  4. In the Connected Apps menu (Setup > Administer > Manage Apps > Connected Apps), click on Qualtrics Survey to pull up the connected app detail page for the Qualtrics Survey app.
    Qualtrics Survey Detail Page under Connected Apps
  5. Scroll down to the Profiles section and select the Manage Profiles button.
    Application Profile Assignment menu
  6. Select the profiles that should have access to the app and select Save.

Lightning Experience

  1. Click the gear in the upper-right.
    Gear on upper-right clicked and expanded; Setup is second choice down with another blue gear next to it
  2. Select Setup.
  3. Search “manage connected apps.”
    Manage Connected Apps selected to the left, Qualtrics survey in list in center of page with edit right to the left of it
  4. Click Manage Connected Apps.
  5. Click Edit next to Qualtrics Survey.
  6. Change the Permitted Users option to Admin approved users are pre-authorized. Select OK when prompted.
    Permitted Users set to "Admin approved users are pre-authorized"
  7. Select the Save button.
  8. You will return to the Manage Connected Apps page.
    Manage Connected Apps selected to the left, Qualtrics survey in list in center of page with edit right to the left of it
  9. Click on Qualtrics Survey to pull up the connected app detail page for the Qualtrics Survey app.
  10. Scroll down to the Profiles section and select the Manage Profiles button.
    Scroll down to Profiles, Manage Profiles button is in the center of the header of this section
  11. Select the profiles that should have access to the app and select Save.
    Application Profile Assignment menu

Configuring Layouts

In order for your users to send surveys using the app, you’ll need to place at least one custom button in either the search layout for Contacts, Leads, or Campaigns, or in the layout of your Campaign object. We will cover how to set these up in each of the following sections.

Adding Search Layout Buttons

Search layout buttons are used to quickly send a Qualtrics survey to Contacts, Leads, and Campaigns by generating a list view. To add these buttons, follow these steps:

Salesforce Classic

  1. In Salesforce, go to Setup, then Customize, then Lead, and then Search Layouts.
  2. Select the Edit link next to Lead List View.
    Lead Search Layouts menu
  3. Select the Send Qualtrics Survey button, then click the Add arrow to bring it to the right table.
    Add Qualtrics Survey in Leads List View page
  4. Save the page.
  5. Repeat steps 1–4 for the Contacts object.
  6. Repeat steps 1–4 for the Campaigns object.

Note that the search layout is not customizable by Profile in Salesforce, unlike Page Layouts.

Lightning Experience

  1. Click the gear in the upper-right.
    Gear on upper-right clicked and expanded; Setup is second choice down with another blue gear next to it
  2. Select Setup.
  3. Select Object Manager.
    Inside setup, object manager in header is next to home button. Lead is in the list that opens when you select object manager
  4. Select Lead.
  5. Select Search Layouts.
    Search layouts selected to left, list view under layout column, far-right a dropdown arrow with an edit option
  6. Next to List View, select the dropdown and then select Edit.
  7. Click Send Qualtrics Survey in the table on the left, then click the Add arrow to move it to the right table.
    Send Qualtrics Survey in left column, right pointing arrow, then another box named Selected Buttons
  8. Click Save.
  9. Repeat steps 1-8 for Contact instead of Lead.
  10. Repeat steps 1-8 for Campaign instead of Lead.

Note that the search layout is not customizable by Profile in Salesforce, unlike Page Layouts.

Adding the Campaign Layout Button

The Campaign button is used to allow users of the app to send a Qualtrics survey to an entire campaign. To add this button to the Campaign layout, follow these steps:

Salesforce Classic

  1. Go to Setup, then Customize, then Campaigns, then Page Layouts, and then Edit.
    Campaign Page Layout menu
  2. In the palette at the top, select Buttons.
  3. Drag the Send Qualtrics Survey button to the Custom Buttons area at the top of the page layout.
    Drag "Send Qualtrics Survey" to Custom Buttons
  4. Select Save.

Lightning Experience

  1. Click the gear in the upper-right.
    Gear on upper-right clicked and expanded; Setup is second choice down with another blue gear next to it
  2. Select Setup.
  3. Select Object Manager.
    Object Manager selected, campagin appears in the list that opens
  4. Select Campaign.
  5. Select Page Layouts.
    Campaign layout highlighted on page layouts section of campaign page
  6. Click Campaign Layout.
  7. Drag the Send Qualtrics Survey button to the Custom Buttons area at the top of the page layout.
    Drag "Send Qualtrics Survey" to Custom Buttons
  8. Select Save.

Adding Survey Responses to Page Layouts

By default, the Survey Responses object contains lookup fields to the Contact and Lead objects. In order to make survey responses appear in a related list on each Contact or Lead when they take the survey, follow these steps:

Salesforce Classic

  1. Go to Setup, then Customize, then Leads, and then Page Layouts.
  2. Select Edit next to the layout you wish to edit.
  3. Select Related Lists from the edit box at the top.
  4. Drag the Survey Responses related list down to the location in the Related List area where you wish to place it.
    Add Survey Responses to Page Layouts
  5. Select the wrench icon next to the related list name to edit the columns and buttons.
  6. In the Columns section, select Survey Response Name and Created Date.
  7. Sort by Created Date in descending order.
  8. In the Buttons section, remove the New button for survey responses.
  9. Select OK to save.
    Click OK to save Related List Properties
  10. Select Save on the page layout.
  11. Go to Setup, then Customize, then Contacts, then Page Layouts and repeat steps 2–10.

Lightning Experience

  1. Click the gear in the upper-right.
    Gear on upper-right clicked and expanded; Setup is second choice down with another blue gear next to it
  2. Select Setup.
  3. Select Object Manager.
    Inside setup, object manager in header is next to home button. Lead is in the list that opens when you select object manager
  4. Select Lead.
  5. Select Page Layouts.
    page layouts selected to left, lead layout name selected
  6. Click the name of the layout you want to edit.
  7. Select Related Lists from the edit box at the top.
  8. Drag the Survey Responses related list down to the location in the Related List area where you wish to place it.
    Add Survey Responses to Page Layouts
  9. Select the wrench icon next to the related list name to edit the columns and buttons.
  10. In the Columns section, select Survey Response Name and Created Date.
  11. Sort by Created Date in descending order.
  12. In the Buttons section, remove the New button for survey responses.
  13. Select OK to save.
    Click OK to save Related List Properties
  14. Select Save on the page layout.
  15. Return to the Object Manager and select Contacts.
  16. Repeat steps 5-14.

Granting Access to Qualtrics CX Dashboards

Beginning with version 2.8, Qualtrics CX Dashboards can be viewed and modified from within Salesforce. These dashboards can be accessed using the Qualtrics Vocalize tab in the Qualtrics App.

Attention: To utilize the Qualtrics Vocalize tab, you must have CX Dashboards enabled for your Qualtrics license. If you don’t have access to this feature, reach out to your Qualtrics Account Executive for more information.

If you installed the Qualtrics app prior to March 1, 2016, then you will need to manually add the Qualtrics Vocalize tab to the Qualtrics App within Salesforce after upgrading.

Salesforce Classic

First, you must update your profile settings. Profile settings must be updated for the new Qualtrics Vocalize tab to appear to users. This applies only to custom App and Tab settings in a package. All other field permission upgrades are supported by the permission sets in the package.

  1. Go to Setup, then Administer, then Manage Users, then Profiles and select the System Administrator to start.
    System Administrator tab under Profiles
  2. Locate and select Object Settings.
  3. Locate and select Qualtrics Vocalize.
  4. Edit the setting and change to Default On.
    Custom tab settings with vocalize on the right

Next, add the Qualtrics Vocalize tab:

  1. Go to Setup, then Build, then Create, then Apps, then Qualtrics, and then Edit.
    Select Qualtrics for Salesforce
  2. Select Qualtrics Vocalize from Available Tabs, then click the Add arrow to add it to Selected Tabs.
    Add Qualtrics Vocalize to Selected Tabs
  3. Save the page.

Lightning Experience

First, you must update your profile settings. Profile settings must be updated for the new Qualtrics Vocalize tab to appear to users. This applies only to custom App and Tab settings in a package. All other field permission upgrades are supported by the permission sets in the package.

  1. Click the gear in the upper-right.
    Gear on upper-right clicked and expanded; Setup is second choice down with another blue gear next to it
  2. Select Setup.
  3. Search for “profiles.”
    Profiles selected to left, system administrator at bottom of the list highlighted
  4. Select Profiles.
  5. Select the System Administrator.
  6. Select Edit.
    Inside system admin, edit is towards top, near profile detail
  7. Under Custom Tab Settings, find Qualtrics Vocalize.
    Custom tab settings with vocalize on the right
  8. Edit the setting and change to Default On.

Next, add the Qualtrics Vocalize tab:

  1. Click the gear in the upper-right.
    Gear on upper-right clicked and expanded; Setup is second choice down with another blue gear next to it
  2. Select Setup.
  3. Search for “apps.”
    App manager selected to left; dropdown arrow to far-right of qualtrics shows an edit option
  4. Select App Manager.
  5. Click the dropdown next to Qualtrics, then click Edit.
  6. Select Qualtrics Vocalize from Available Tabs, then click the Add arrow to add it to Selected Tabs.
    Qualrics vocalize in available table box moving to the right box labeled selected tabs
  7. Save the page.
    save buttons at bottom of page

Uninstalling the App

Warning: Prior to uninstalling the app, all custom buttons, related lists, and permission sets must be removed. If any of these elements are still in place during the uninstallation process, the uninstallation wizard will tell you where to find them. Once the elements have been removed, the process can proceed.

Salesforce Classic

  1. Go to Setup and then Installed Packages.
  2. Select Uninstall, located next to the Qualtrics package name.
    Uninstall Qualtrics App from Installed Packages menu
  3. Scroll to the bottom and check the I accept box.
  4. Select Uninstall.
    Confirm Uninstall

Lightning Experience

  1. Click the gear in the upper-right.
    Gear on upper-right clicked and expanded; Setup is second choice down with another blue gear next to it
  2. Select Setup.
  3. Search “installed.”
    Installed packages selected to the left, uninstall next to qualtrics in list of apps
  4. Select Installed Packages.
  5. Next to Qualtrics, select Uninstall.
  6. Scroll to the bottom. Determine if you would like to save the package’s data for 48 hours after it’s uninstalled.
    Confirm Uninstall
  7. Select Yes, I want to uninstall this package and permanently delete all associated components.
  8. Select Uninstall.