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

The New Salesforce App Experience

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!

About the New Salesforce App Experience

We recently released a new version of the Salesforce App which comes with many improvements. This includes a streamlined installation process, an improved UI for sending surveys, additional support for SMS surveys, and an easier process for connecting your Qualtrics account. The app lets you send Qualtrics surveys and view survey responses from within Salesforce. Additionally, the app lets you view your CX Dashboards in Salesforce as well.

To use the new app experience search for Qualtrics XM in the Salesforce App Exchange and then click Get It Now.
the qualtrics app in the app exchange

Qtip: To use this app, you need to configure My Domain in Salesforce.

Installing the App

After downloading the Qualtrics XM app in the Salesforce App Exchange, follow the below steps to set up the app.

  1. In Salesforce, open the App Launcher.
    searching for qualtrics in the app launcher
  2. Search for Qualtrics.
  3. Select Qualtrics.
  4. Choose the users who you’d like to have access to the app.
    selecting the users to access the app
  5. Click Add Selected.
    Qtip: Click Add Entire List if you want to give access to every user in your Salesforce instance.
  6. Click Next.
  7. Choose the pages where you’d like the survey widget to appear. The survey widget lets you send surveys from Salesforce.
    choosing where widget appear in the app
    The pages available to you are:

    • Contacts page
    • Contact record page
    • Campaigns page
    • Campaign record page
    • Leads page
    • Leads record page
  8. Select the pages where you’d like the response widget to appear. The response widget lets you see survey responses in Salesforce. The pages available to you are
    • Contact record page
    • Leads record page
  9. Click Next.
  10. Choose if you’d like to connect and display your CX dashboards in Salesforce for all users, or if you’d like users to set up CX dashboards on their own.
    choosing if users have cx dashboards in the app
  11. If you selected to Display to all users, then additional instructions will appear in the installation window. Follow those instructions before continuing. If you selected Let users decide if they want to connect, then continue to step 12.
  12. Click Next.

The installation setup is now complete! You can re-launch the installer at any time to change these settings.

Connecting Your Account

Before you can send surveys via Salesforce or view responses & CX dashboards, you need to connect your Qualtrics and Salesforce accounts.

  1. In the Qualtrics app, navigate to Qualtrics Settings.
    the connect tab of the qualtrics settings section for connecting your accoutns
  2. Go to the Connect tab.
  3. Click Connect to Qualtrics.
  4. Enter your username and password.
    connecting your sfdc and qualtrics accounts. enter your qualtrics credentials on the logic screen

    Qtip: If your license uses Single Sign On (SSO), click Sign in with SSO and enter your organization ID. More information about logging in with your organization ID can be found on this support page.
  5. Click Sign In.
  6. Enable Allow this application to retain access for up to a year.
    authorizing the app to connect to your qualtrics account
  7. Click Authorize.
  8. Click Finalize connection.the finalize connection button

Sending Surveys via Salesforce

With this app, you can send both email surveys and SMS surveys to people via Salesforce. You can send your surveys from the Contacts, Campaigns, and Leads records and pages, provided they’ve been enabled in the installation process.

Qtip: The app does not support multi-language messages. If you need to distribute your survey via multiple languages, you will need to create a message for each language and send each distribution individually.

Sending Email Surveys

Qtip: Read the Email Survey Invitations support page if you’re interested in learning more about surveys sent via email.
  1. In the app, go to the Contact, Lead, or Campaign to which you’d like to send your survey.
    a contact page. the distribution widget is to the right of the contact

    Example: You can send your survey from the page itself (i.e. the Contacts page), or from a specific Contact record (as pictured above). If distributing from a page, you need to select which records will receive the survey. In the below example, we’ve selected two different Campaigns to receive the survey from the Campaigns page.
    selecting campaigns to distribute to
  2. Select New in the distribution widget.
  3. Choose the survey you’d like to distribute.
    Qtip: Click Edit survey to be brought to Qualtrics for editing your survey.
  4. Select Email as the Delivery Method.
  5. Choose an email template that will be the body of your email. If you do not already have an email template to use, then select Create New.
  6. Enter the From Name. This is the name that appears in your recipient’s inbox.
  7. Give your template a name so you can reuse it again in the future. If you selected an existing email template in step 5, you will not have this field.
  8. Enter the Reply Email. This email will receive any replies to your email invitation.
    continuing setting up an email distribution
  9. Enter the Email Subject. This is the subject line of the email.
  10. Configure the body of your email in the Message box.
    Qtip: Do not remove the Piped Text from the email body, as the Piped Text turns into your survey links when the email sends.
  11. To send your email at a future time, click Schedule for later. If you’d like to send your email immediately, skip to step 13.
  12. Use the Date and Time boxes to select when the email will send.
  13. Click Schedule to schedule the email. This button will say Send Now if you did not choose to schedule your email for later.
Qtip: If you’d like to preview what your email will look like before sending it, click Send Test and then enter the preferred email address in the popup window. The test email will send a distribution to the email address you enter. You may only send a test email to one email address at a time.

Sending SMS Surveys

Qtip: Read the SMS Distributions support page for more information about SMS distributions.
Attention: If distributing via SMS distribution, make sure your contacts’ phone numbers are saved in the correct format. You must include the country code for all phone numbers!
  1. In the app, go to the Contact, Lead, or Campaign to which you’d like to send your survey.
    a contact record page. the widget for sending distributions is to the right

    Example: You can send your survey from the page itself (i.e. the Contacts page), or from a specific Contact record (as pictured above). If distributing from a page, you need to select which records will receive the survey. In the below example, we’ve selected two different Campaigns to receive the survey from the Campaigns page.
    selecting campaigns to distribute to
  2. Select New.
  3. Choose the survey you’d like to send.
    Qtip: Not all surveys can be sent via 2-way SMS. See this support page for more information on designing your survey if you want your survey to be taken via 2-way SMS.
  4. Select Text message (SMS) as the Delivery Method.
    Qtip: If this option is grayed-out, that means you don’t have access to SMS surveys. Reach out to your Brand Administrator and request they enable the Use SMS Distributions permission for your account.
  5. Choose the Phone Number that the survey should be sent to. Since records in Salesforce can have multiple phone numbers, you’ll need to select which phone number will receive the survey.
  6. Choose the Message Type. This determines how your respondents take the survey:
    • Link to survey (1 way SMS): The respondent receives a text message that contains a link to your survey, which they complete in their mobile device’s web browser.
    • Direct text replies (2 way SMS): The respondent takes the survey via text message by replying with their answers.
      Qtip: If you select 2 way SMS, skip to step 10.
  7. If you selected 1 way SMS, select the SMS Template, which is the text message invitation your respondents will receive for taking the survey. If you have not created any templates, select Create New.
  8. If you’re creating a new template, give the template a name so you can reuse it in the future. If you selected an existing template in the previous step, continue on.
    continuing setting up an sms distribution
  9. Configure the body of your text message in the Message box.
    Qtip: Do not remove the Piped Text from the text message body, as the Piped Text turns into your survey link when the text message sends.
  10. To send your text message at a future time, click Schedule for later. If you’d like to send your text message immediately, skip to step 12.
  11. Use the Date and Time boxes to select when the text message will send.
  12. Click Schedule to schedule the text message. This button will say Send Now if you did not choose to schedule your text message for later.
Qtip: If you’d like to preview what your text message will look like before sending it, click Send Test and then enter the preferred phone number in the popup window. The test text message will send a distribution to the phone number you enter. You may only send a test text message to one phone number at a time.

Viewing Sent Distributions

In addition to sending emails via Salesforce, you can view information about your past distributions, such as how many people received the survey, any records with missing contact information, and any responses that are associated with the distribution. To view your sent distributions, go to the Sent tab of the survey widget. To view information about a specific distribution, click View More next to the distribution you’re interested in.
the sent tab of the distribution widget

After clicking View More, you’ll see a window that show more information about your distribution:
the details of a distribution that was sent via salesforce

  1. On the right hand side, you can see all of the details of your distribution when setting it up, such as what survey was sent, the distribution method, the message that was sent, and more.
  2. # Selected is the number of records that were selected to receive the distribution. This number can include respondents who did not actually receive a survey invite, such as if their contact information is missing, or if they’ve opted out.
  3. # Opt Out is the number of records who did not receive an email since they fulfilled the survey exclusion criteria. See Additional Settings for more information about survey exclusion criteria.
  4. # Email Missing is the number of records who did not have a valid email address for receiving the distribution. If you sent an SMS survey, this number will be 0 for your distribution.
  5. # Phone Missing is the number of records who did not have a valid phone number for receiving the distribution. If you sent an email survey, this number will be 0 for your distribution.
  6. # in List is the number of records in the contact list that were actually sent the distribution.
  7. The Activity section will show you when the distribution sent, the associated panel name, what user created the distribution, and what use last modified the distribution.
  8. As responses come in, they’ll be visible in the Survey Responses section. See the below section about viewing responses for more information about mapping your responses for viewing in Salesforce.

Editing & Deleting Scheduled Distributions

After scheduling a distribution to send on a future date, you can edit the details of the distribution, or cancel it all together. To edit a scheduled distribution, select the Scheduled tab and then click Edit next to the distribution.

the scheduled tab of the distribution widget.

You can then edit any details of your distribution, such as what survey sends, when the distribution sends, the associated message, and more. Once you’re finished editing, you can click Save to save your changes. If you’d like to preview your changes, click Send Test and enter either your phone number or email address, depending on the distribution type. If you want to delete your distribution altogether, click Delete.

the delete and save buttons for editing and deleting distributions

Viewing Responses in Salesforce

Before responses appear in Salesforce, you need to map your responses back to Salesforce. You will need to perform these steps for every survey you want to send via the Salesforce App.

Qtip: This section is specifically geared towards mapping fields to make survey responses appear in the Salesforce App. For general information about mapping Qualtrics data to Salesforce, see Salesforce Response Mapping.
  1. Navigate to the Survey flow of the survey you’d like to distribute.
    navigating to the survey flow
  2. Click Add a New Element Here.
    an embedded data element is being added to the survey flow
  3. Select Embedded Data.
  4. Type the name of one of your Salesforce fields.
    adding fields to the embedded data element
    Spelling and capitalization matter! You should add at least these three required fields:

    • sfAccountId
    • sfContactId
    • sfSurveyId
  5. Click Add a New Field to add additional fields. Repeat this until you have added all your desired fields.
    Qtip: The three fields above are the ones required to make the response appear in Salesforce while linking it to the correct record. You can add any additional Salesforce fields you’d like to appear with the response. For example, if you’re linking the responses to a Lead, you’ll want to map the sfLeadId field.

    Attention: You can only pull default Salesforce fields into Qualtrics using the Salesforce app.

    Default Salesforce fields include:

    • id
    • name
    • email
    • title
    • birthdate
    • accountid
    • firstname
    • lastname
    • leadsource
    • mailingstreet
    • mailingcity
    • mailingstate
    • mailingpostalcode
    • mailingcountry
    • phone
    • mobilephone
    • otherstreet
    • othercity
    • otherstate
    • otherpostalcode
    • othercountry
    • otherphone
    • homephone
    • donotcall
    • hasoptedoutofemail
  6. At a minimum, your Embedded Data element should contain these three fields: sfAccountId, sfContactId, and sfSurveyId.
    an embedded data element with the salesforce fields added

    Qtip: If you plan on using these fields in logic, you should move the element to the top of your survey flow.
  7. Click Save Flow.
  8. Navigate to the Actions tab of the survey you’d like to distribute.navigating to actions and creating an event-based action
  9. Click Create an action.
  10. Select Event-based.
  11. Choose the Survey Response Event.
    selecting the survey response event
  12. Select Response created. selecting response created and clicking finish
  13. Click Finish.
  14. If desired, click the plus sign ( ) and then Conditions to add conditions to your action. Conditions determine when the action fires. For help building conditions, see Using Logic.
    adding conditions and a task

    Example: For example, let’s say I only want to map responses that indicated they were dissatisfied. I can add a condition so that the action will only fire when the respondent indicated they were dissatisfied in the survey.conditions set to trigger the task only when the response indicates they're unsatisfied
  15. Click the plus sign ( + ) and then Task.
  16. Select Salesforce.
    selecting the salesforce task
  17. Choose Response Mapping.the response mapping task
  18. Use the Salesforce Account dropdown to select your Salesforce account. If your account is not in this list, select Add new account.selecting a salesforce account to connect to for response mapping
  19. If you are connecting to a new account, select Add new account and then choose if you want to connect to a Production Account or a Sandbox Account.
    Qtip: Most of the time, you’ll connect to a Production Account as Sandbox Accounts are usually used for testing purposes only. After selecting the type of account to add, you’ll be brought to the Salesforce login screen to login to your Salesforce account. Once you log in, you’ll be redirected back to the task to complete the setup.
  20. Select Insert for the Action on Record.choosing the record and object to map responses to
  21. Select Survey Response as the Salesforce Object.
  22. Click Salesforce Field and select one of the following three fields:
    • qualtrics__Survey__c (qualtrics__Survey__r)
    • qualtrics__Contact__c (qualtrics__Contact__r)
    • qualtrics__Account__c (qualtrics__Account__r)
      Qtip: Use the search at the top of the dropdown menu to search for these fields. Make sure you are mapping these specific fields.
  23. Click Add Salesforce Mapping Field twice and select the two other fields you didn’t select in the previous step.
  24. For the Field Type, select Embedded Data. Do this for all three fields.
  25. Map the Salesforce fields to the Embedded Data. Click the down arrow to select the Embedded field.mapping responses continued, see table below for mapping Map your fields according to the below table:
    Salesforce Field Embedded Data Field
    qualtrics__Survey__c (qualtrics__Survey__r) sfSurveyId
    qualtrics__Contact__c (qualtrics__Contact__r) sfContactId
    qualtrics__Account__c (qualtrics__Account__r) sfAccountId
  26. If you want to add additional fields, click Add Salesforce Mapping Field and complete the mapping for that field. See Salesforce Response Mapping for more details.
  27. Click Save.

Now, when a respondent takes your survey, this data will be sent to Salesforce, and you can review the response from your Salesforce Contacts or Lead record pages. Click a specific survey response to pull up more information about the response. The fields you mapped to Salesforce will be available in when viewing the response in full.
choosing a survey response in the qualtrics app to view

Viewing CX Dashboards in Salesforce

To view your CX dashboards in Salesforce, go to the CX Dashboard tab. If CX dashboards were already enabled during the installation process for all users, you will be automatically logged into your account and brought to your CX dashboards. If the dashboards were not enabled for all users during installation, you can still self-authorize yourself to view dashboards.
the cx dashboard tab of the qualtrics app

You can perform any action you normally would to your dashboard, such as viewing, editing, and exporting the dashboard. For more information about CX Dashboards in general, see our Getting Started with CX Dashboards resources.

Adding Widgets to Salesforce Record Pages

With the Salesforce App, you can embed widgets from your CX dashboard onto a record page within Salesforce. In order to see the widgets when viewing a record page, a Salesforce user must meet the following conditions:

  • Their Salesforce and Qualtrics accounts are connected.
  • The user has access to the dashboard containing the widget.

Retrieving the widget code

Qtip: To retrieve the widget code for embedding a widget in Salesforce, you must have editing access to the dashboard containing the widget. If you have dashboard editing access and do not see the option to retrieve the widget code, contact your Qualtrics Account Executive to see if this feature is included in your license.
  1. Navigate to the dashboard containing the widget you want to embed in Salesforce.
  2. Click Edit Page.
    the embed in salesforce option on a widget
  3. Click the three dots in the top right corner of the widget.
  4. Select Embed in Salesforce.
  5. If you want your widget to automatically filter based on the record page it is on, select the field from your dashboard that should act as the filter. This step is optional.
    the option to select a data filter before copying the widget code

    Example: For example, you add the widget to an Account record page, and you want the widget to automatically filter by Salesforce Account ID so that the widget only displays data relevant to the account you’re viewing. You have this information saved in the externalReferenceId field in Qualtrics, so you select this field as the filter.
  6. Click Copy code.
  7. Click Save.

Adding the Widget to Salesforce

Qtip: This step must be performed by a Salesforce administrator. If you retrieved the widget code but are not a Salesforce administrator for your organization, send the copied widget code to your administrator so they can complete the setup.
  1. While editing a record page, select the QualtricsWidget component and drag and drop the widget to where you’d like it to be on the page.
    adding the widget to the page and entering the widget code before saving
  2. Paste the copied widget code into the Widget Code box.
  3. If the widget is being filtered by a field, select the Salesforce field that corresponds to the field you selected in Qualtrics.
  4. Click Save.

Additional App Settings

The Qualtrics App contains some additional settings for you to configure, such as survey exclusion rules and disconnecting your Qualtrics account.

the qualtrics settings tab

Survey Invite Exclusions

The Survey invite exclusions tab lets you choose if certain records should be excluded from receiving Qualtrics surveys, based on contact-opt outs or other conditions set by your organization.

the survey invite exclusions tab of the qualtrics salesforce app

Qtip: If someone opts out of receiving emails from you, they will automatically be excluded from all survey invites.

For contacts, you can base exclusions on the following fields:

  • Fax Opt Out
  • Do Not Call
  • Is Email Bounced
  • Informed Consent

For Leads, you can base exclusions on the following fields:

  • Do Not Call
  • Fax Opt Out

If a record has a value of “true” for a field that you’ve enabled here, then the record will not receive your survey invite.

Call Script Links

the call script links tab

Call scripting is used in call centers to guide customer service representatives in their interactions. They act as a sort of dialogue tree to guide the conversation. The Qualtrics Salesforce App allows you to embed a call scripting survey in your Salesforce environment as a button or a link, allowing representatives to easily launch the call script. See the Setting Up Call Scripting section for details on how to set this up.

Disconnecting Your Qualtrics Account

To unlink your Qualtrics and Salesforce accounts, go to the Disconnect tab and then click Disconnect.
the disconnect tab

Setting Up Call Scripting

Qtip: Before setting up call scripting in Salesforce, make sure you create and build a call script survey in your Qualtrics account.
  1. In the app, navigate to the Qualtrics Settings tab.
    the call script links section with the create new button highlighted
  2. Select Call Script Links.
  3. Click Create New.
  4. Choose your call scripting survey.
    creating a new call script link in the salesforce app
  5. Select the page in Salesforce you want to add the link to and map fields from.
    Example: To add the call script to a Contact record page and use data from the record in your survey, select Contact.
  6. Give your script a name.
  7. Click Add Fields to begin mapping Embedded Data fields from your survey to fields from Salesforce. This will save the field value from Salesforce as an Embedded Data field in your survey data.
  8. Use the dropdown menus to map your fields.
    Example: In this example, the Embedded Data field “First” is mapped to the Salesforce Contact field “FirstName,” and the Embedded Data field “Last” is mapped to the Salesforce Contact field “LastName.”
    mapping qualtrics fields to salesforce fields
  9. To remove a field, click the trash can icon.
  10. Click Copy to copy the call script URL to your clipboard. Hold onto this URL for later.
  11. Click Done.
  12. Navigate to Setup.
    the setup tab in salesforce
  13. Go to the Object Manager.
    selecting a record page in salesforce
  14. Select the object you want to add your call script to. This should be the same as the page you selected in step 5.
  15. Click Buttons, Links, and Actions.
    creating a new button in salesforce
  16. Click New Button or Link.
  17. Begin setting up your link or button by giving it a label, title, and description.
    creating a custom link in salesforce
  18. Choose the Display Type which determines how your call script appears in the Salesforce UI.
    Qtip: Click View Example next to a Display Type to see an example of what this type will look like.
  19. Paste your copied link into the link box.
  20. Click Save.
  21. Navigate to Page Layouts.
    selecting a page layout in salesforce
  22. Select the layout you want to add your button or link to.
  23. Choose Buttons if you’re adding a button, or Custom Links if adding a link.
    dragging and dropping a custom link on a record page
  24. Drag and drop your button or link to the area of the layout where it should appear.
    Qtip: Having trouble finding where to drag and drop the button/link to? The Salesforce UI will highlight in green where you can drop the button/link.
  25. Click Save.

Using Call Scripts

Once you’ve set up your call script link, open the Qualtrics app for Salesforce and navigate to the page where you added the link. To launch the call script, simply click the link.

Example: In this example, we added a call scripting link to the Contacts page layout.
the custom link on a contact record page

Editing Call Scripts

To edit your call scripts, navigate to the Call Script Links section of App Settings, and click the pencil icon next to the script you’d like to edit.
the edit button for a call script link

You can then edit any details of your call script.

Attention: If you change the survey or any of the mapped fields, you’ll need to update the link used in your custom button/link. See the above workflow for Setting Up Call Scripting for information about editing custom buttons/links.

Using the App in Different Languages

Qtip: The Salesforce App is available in the following languages: German, English (UK), Spanish (EU), Spanish (LATAM), Finnish, French, Italian, Japanese, Korean, Dutch, Portugese (EU), Porguese (BR), Chinese (Simplified), Chinese (Traditional).

To change the App’s language, adjust your Salesforce account’s language setting, and the app will update accordingly.

If the app’s language does not update after changing your account language, you’ll need to make sure your Translation Settings are set up correctly. To change your Translation Settings:

  1.  In Salesforce, navigate to your Translation Language Settings.
    the translation language settings tab in salesforce
  2. Click Enable.
  3. Clear your browser’s cookies & cache.

After enabling the Translation Language Settings and clearing your browser’s cookies & cache, the app language will update to your selected language.