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

Triggering & Emailing Surveys in Salesforce or Updating Contacts in Qualtrics

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 Triggering & Emailing Surveys in Salesforce or Updating Contacts in Qualtrics

In the Workflows tab, you can set up tasks to trigger workflows within Qualtrics based on Salesforce Workflow Rules. The criteria for the workflow rule in Salesforce might be an event such as a case being closed or an opportunity being won. Once this workflow rule is met in Salesforce, Qualtrics can take action, such as updating contact information and sending a survey.

In addition, there are other methods of sending surveys as a part of your Salesforce extension. For these additional options, check out our page on Other Salesforce Distribution Methods. Qualtrics can also map survey responses back to Salesforce; for more information, view our Salesforce Response Mapping page.

Qtip: You can see distributions triggered from Salesforce in the Distributions tab of your survey.
the distributions tab of a survey that was linked to salesforce and distributed
Qtip: If you have also purchased access to CX Dashboards, you can report on your Salesforce Distributions with Distribution Reporting. If you are interested in CX Dashboards, contact your Account Executive or Customer Success Representative.

Setting up a Salesforce Triggered Survey

The Salesforce workflow rule event allows you to trigger and email survey invitations to respondents as soon as their corresponding object meets qualifying criteria in Salesforce. This functionality requires setup in both Qualtrics and Salesforce. You will need to set up a workflow rule and workflow action in Salesforce in addition to setting up the email invite in Qualtrics.

Qtip: The following steps require a Salesforce instance with access to Workflows and Approvals. If your instance doesn’t have this access, contact your Salesforce Administrator for help.
  1. Once the Salesforce extension is enabled on your account, navigate to the Workflows page.
    navigating to workflows in the global navigation and clicking create new workflow
  2. Click Create a workflow.
    Qtip: Make sure you name your workflow so it’s easy to find and easy to tell apart from other, similar workflows you have have created.
  3. Select Started by an event.
    Screenshot of actions catalog
  4. Click Get started.
  5. Select Salesforce Workflow Rule.
    the salesforce workflow rule event

    Qtip: If you haven’t already connected your Salesforce and Qualtrics accounts, you’ll be prompted to login to Salesforce account to set up the extension. For more information about setting up the extension, read our Linking Qualtrics & Salesforce page.
  6. Choose the Salesforce account you would like to link to.
    the screen for logging into your salesforce account via Qualtrics and to map salesforce fields into the workflow
  7. Choose the Salesforce object that is triggering the event. This could be a standard Salesforce Object like Lead or Case, or a custom Object you’ve created. The selected object in the event should match the object the Salesforce Workflow Rule is based off of.
  8. Review the fields that are included from Salesforce. Click the dropdown arrow to expand the list of fields.
  9. If desired, use the Add fields option to select fields you want pulled from Salesforce into Qualtrics. These fields can be used to create conditions for your workflow or update contact information in Qualtrics.
    Example: In the below example, the values from FirstName, LastName, and Email are being pulled from Salesforce to be saved in Qualtrics.
    contact fields from salesforce mapped to Qualtrics fields
  10. Click Done.
    Qtip:  If you need to change the values being saved in Qualtrics or any other details of your Salesforce Workflow Rule, click the event.
    Picture of action with a salesforce workflow rule, which is highlighted
  11. If desired, click the plus sign ( + ) to add conditions to your workflow. You will be able use the Salesforce fields added in step 9. For more information on building and troubleshooting logic conditions, see Using Logic.
    Screenshot of an action showing the plus sign cliicked, which reveals the option to add a task or an action

    Example: Let’s say you want to send a follow-up survey every time a case in Salesforce is closed. The below condition will ensure that this workflow will only fire for cases in which the field IsClosed is equal to true.
    conditions based on if IsClosed is equal to true
  12. Add a task.
  13. Select the XM Directory task.
    Image of xm directory task in task window
  14. Select Distribute survey.
    the distribute survey option in the xm directory task
  15. Complete setting up the XM Directory task with your desired distribution method. You can send an email invitation, an SMS invitation, or a 2-way SMS survey. The XM Directory Task page has more information about how to set up the task.
    an xm directory task

    Qtip: Don’t want to send a survey? Choose Add to XM Directory instead. This will save Salesforce data in a Qualtrics contact list when the Workflow Rule is triggered, but not send a survey to the new contact. See the section on Saving Record Changes in Salesforce as Contact Information for more information on this process
  16. After saving the XM Directory task, navigate back to the Salesforce Workflow Rule event and click Copy URL to copy the outbound message to your clipboard.
    the copy URL button next to the outbound message URL
  17. Navigate to login.salesforce.com and login using your Salesforce account.
  18. Here, create a Workflow rule on the object that you select in the Qualtrics UI. For instance, if you selected “Lead” as the Salesforce Object as in the example in step 7, select “Lead” as the object for your Salesforce Workflow Rule. You can find more information about this in the Setting up A Salesforce Workflow Rule section below.
  19. Create an Outbound Message and attach that to your workflow rule in Salesforce.
  20. Paste the Workflow Rule URL from step 17 to the Salesforce Outbound Message URL. You can find more information about this in the Adding the Workflow Action section below.
    the endpoint URL pasted into an outbound message in salesforce
  21. After publishing your survey, test your setup by fulfilling the condition of your workflow rule in your Salesforce account. This should carry the Salesforce fields to Qualtrics, save them as a contact in the specified panel, and distribute a survey to the contact’s email. For more tips on how to troubleshoot your workflow, see our Testing and Troubleshooting section.
Attention: When making edits to your Salesforce workflow, it’s important that the user who initially set up the workflow is the only user who edits the workflow. If a user who did not set up the workflow tries to edit it, the Salesforce integration will stop working. If you are not the Salesforce workflow owner but need to edit the workflow, then copy the workflow and make edits to the copy.

Saving Record Changes in Salesforce as Contact Information

Let’s say you have an opportunity in Salesforce that is won and you’d like to include this information in the opportunity’s contact entry in Qualtrics. You can use the Salesforce Workflow Rule event to push changes from Salesforce to Qualtrics. The updated contact information can be saved as embedded data or transactional data. If this is a new contact, the Salesforce Workflow Rule event can also be used to create new contacts within Qualtrics.

Qtip: Transactional data is only available to users with access to XM Directory.
  1. Once the Salesforce extension is enabled on your account, navigate to the Workflows page.
    navigating to workflows in the global navigation and clicking create new workflow
  2. Click Create a workflow.
    Qtip: Make sure you name your workflow so it’s easy to find and easy to tell apart from other, similar workflows you have have created.
  3. Select Started by an event.
    Screenshot of actions catalog
  4. Click Get started.
  5. Select Salesforce Workflow Rule.
    the salesforce workflow rule event

    Qtip: If you haven’t already connected your Salesforce and Qualtrics accounts, you’ll be prompted to login to Salesforce account to set up the extension. For more information about setting up the extension, read our Linking Qualtrics & Salesforce page.
  6. Choose the Salesforce account you would like to link to.
    the screen for logging into your salesforce account via Qualtrics and to map salesforce fields into the workflow
  7. Choose the Salesforce object that is triggering the event. This could be a standard Salesforce Object like Lead or Case, or a custom Object you’ve created. The selected object in the event should match the object the Salesforce Workflow Rule is based off of.
  8. Review the fields that are included from Salesforce. Click the dropdown arrow to expand the list of fields.
  9. If desired, use the Add fields option to select fields you want pulled from Salesforce into Qualtrics. These fields can be used to create conditions for your workflow or update contact information in Qualtrics.
    Example: In the below example, the values from FirstName, LastName, and Email are being pulled from Salesforce to be saved in Qualtrics.
    contact fields from salesforce mapped to Qualtrics fields
  10. Click Done.
    Qtip:  If you need to change the values being saved in Qualtrics or any other details of your Salesforce Workflow Rule, click the event.
    Picture of action with a salesforce workflow rule, which is highlighted
  11. If desired, click the plus sign ( + ) to add conditions to your workflow. You will be able use the Salesforce fields added in step 9. For more information on building and troubleshooting logic conditions, see Using Logic.
    Screenshot of an action showing the plus sign cliicked, which reveals the option to add a task or an action

    Example: The below condition will ensure that only newly created Cases have their contact information saved to Qualtrics.
    a condition for a salesforce workflow rule event set to only fire when the SFOUtboundMessageData field Status is equal to new
  12. Add a task.
  13. Select the XM Directory task.
    Image of xm directory task in task window
  14. Select Add to XM Directory.
    the add to xm directory option for the xm directory task
  15. Select the Contact List where you’d like to save the contact information.
    Screenshot of contact fields
  16. Fill out the contact information to be saved or updated. First Name, Last Name, and Email Address are required.
    Qtip: Use the piped text icon, {a}, to pull in values from your Salesforce Object and fields selected in steps 8 and 9.
  17. If there are additional fields you’d like to be saved with the contact entry, click Add or remove embedded data fields.
  18. A window will appear where you can set embedded data fields. On the left, name the embedded data fields under Embedded Data Field On the right, populate them with Salesforce field values under Field Values. This will save the data with the contact entry in Qualtrics. Click Close when finished.
    the window for adding embedded data fields

    Example: Let’s say I have a field called Location that is saved with my contact and does not change much overtime. It would be useful to save this field as contact embedded data. Therefore, I can see where this contact is located when viewing the contact. However, let’s say I want to create a new transaction each time a Salesforce case is closed for the contact. I can save a Store field as transaction data in order to see the store that this particular case is associated with in the contact’s touchpoint timeline.
  19. Select how you’d like to save or update the contact information:
    Screenshot of the described steps

    • Save or update embedded data: This option will save the contact information as embedded data. This is the option that should be selected for creating new contacts.
    • Add as a transaction to the contact info: This option will save the contact information as transactional data in an existing contact.
  20. Click Save.
  21. Copy your Salesforce Workflow Rule URL.
    the copy URL button next to the outbound message URL
  22. Navigate to login.salesforce.com and login using your Salesforce account.
  23. Here, create a workflow rule on the object that you select in Qualtrics. For instance, if you selected “Case” as the Salesforce Object in step 7, select “Case” as the object for your Salesforce Workflow Rule. You can find more information about this in the Setting up a Salesforce Workflow Rule section below.
  24. Create an Outbound Message and attach that to your workflow rule in Salesforce.
  25. Paste the Workflow Rule URL from step 21 to the Salesforce Outbound Message URL. You can find more information about this in the Adding the Workflow Action section below.
    the endpoint URL in an outbound message in salesforce
  26. After publishing your survey, test your setup by fulfilling the condition of your workflow rule in your Salesforce account. This should carry the Salesforce fields to Qualtrics and save them as a contact in the specified panel. For more tips on how to troubleshoot your workflow, see our Testing and Troubleshooting section.
Attention: When making edits to your Salesforce workflow, it’s important that the user who initially set up the workflow is the only user who edits the workflow. If a user who did not set up the workflow tries to edit it, the Salesforce integration will stop working. If you are not the Salesforce workflow owner but need to edit the workflow, then copy the workflow and make edits to the copy.

Saving Salesforce Fields as Embedded Data

Information from Salesforce is saved in your contact list, but is not automatically recorded in survey responses. But it is quick and easy to add them if you follow these simple steps:

  1. Make sure you’ve followed the steps to trigger and email a survey using Salesforce.
    Qtip: Make note of the spelling and capitalization you used when setting up your contact embedded data in your XM Directory task. Spelling and capitalization matter!
  2. Go to the Survey tab.
    Adding an element in the Survey Flow
  3. Select Survey flow.
  4. Click Add a New Element Here.
  5. Select Embedded Data.
  6. Type in the name of the contact embedded data field saved from Salesforce. The name of the embedded data field in the survey flow must be the same as in your contact (including capitalization, punctuation, spacing, and special characters). You do not need to set its value to anything, as its value will flow from the contact’s embedded data field.
    adding an embedded data field for the field saved from salesforce
  7. When finished, click Apply.
Qtip: This workflow can pull both contact embedded data and transactional data into a survey!

Qtip: Do you want to include Salesforce fields in your email or your survey? Follow the steps above to save these fields as embedded data. Then generate piped text for the embedded data you want to include.

Setting up a Salesforce Workflow Rule

A Workflow Rule is a set of criteria created in Salesforce. When the criteria have been met, an workflow can be triggered. For example, the criteria might be that a case is marked as closed, and the workflow would be to have Qualtrics send a support feedback survey.

TO SET UP A SALESFORCE WORKFLOW RULE (Salesforce Lightning)

  1. Click Setup in Salesforce.
    the salesforce homepage with the search bar highlighted

    Qtip: If you are not on the Home page, you can navigate there by clicking on the gear icon on the top right corner and choosing Setup.
    accessing the setup menu via the gear icon
  2. Select Workflow Rules – Process Automation from the search results.
    the workflow rules - process automation in the search results
  3. Choose New Rule to create a new Workflow Rule in Salesforce.
    selecting new rule in salesforce
  4. Select the Salesforce Object to which the rule will apply in the Object dropdown. For example, if you want the rule to be triggered when a Case is closed, you would choose Case here.
    choosing the object to base the rule on
  5. Select Next.
  6. In the Rule Name section, name your rule. You may also provide a brief description if desired.
    giving the rule a name and selecting the evaulation criteria
  7. Under Evaluation Criteria, choose the desired option for how often your rule should be evaluated. You can find more information on the options in this section on this Salesforce support page.
  8. Set the criteria for the rule in the Rule Criteria section.
    creating criteria for the rule

    Example: If you want the rule to be triggered when a Case is closed, you would set the Field to Case: Closed and the Value to True.  You can add multiple conditions for your Workflow Rule here as well.
  9. Select Save & Next.

Adding the Workflow Action

This action tells Salesforce what to do once the Workflow criteria is met. For example, the action might be for Qualtrics to send a survey invitation.

Setting Up A Workflow Action (Salesforce Lightning)

  1. For your newly created Workflow Rule, locate the Immediate Workflow Actions section and utilize the Add Workflow Action dropdown.
    the add workflow action dropdown
  2. Select New Outbound Message.
  3. Name the Outbound Message and give a brief description, if desired.
    creating a new outbound message in salesforce
  4. Paste the Outbound Message URL from Qualtrics into the Endpoint URL field in Salesforce.
  5. Highlight any fields you would like to pass through the Outbound Message into Qualtrics and add them to the Selected Fields section.
  6. Click Save.
    the save button on an outbound message
  7. Select Done on the next page.
    the done button on a workflow rule
  8. Select Activate to turn on the Workflow Rule.
    the activate button on a workflow rule

 

Testing and Troubleshooting

Once you have set up the Workflow Rule, Workflow Action, and XM Directory task, your survey is ready to go. Each time that the Workflow Rule is met in Salesforce, the Salesforce data will be passed over into a new Qualtrics contact.

TROUBLESHOOTING IN QUALTRICS

  1. Workflows Reporting: If you set up your Workflow in the Workflows tab, you can check the Workflows Reporting tab. Here, you can filter your workflows by status as well as view the payload for each workflow to determine what caused it to fail. The Input Payload contains the fields being utilized in the workflow, and the Task Output contains the error message for the failed workflow.
  2. Survey Activation: Qualtrics can’t send a survey until that survey has been activated. Your survey is activated as soon as you publish and select a distribution method for your survey. Make sure your survey has been published and activated before troubleshooting. You can see your project’s status as well as activate it from the Projects page.
  3. Survey owner linked to Salesforce: When connecting with Salesforce, Qualtrics always checks the Salesforce credentials of the original survey owner. If you are setting up the Salesforce Extension and the survey has been shared with you, make sure the original survey owner also links their Qualtrics account to your Salesforce instance when building the workflow in Qualtrics.
  4. Storing participants in a contact list: If you’re successfully saving recipients to a contact list but the distributions aren’t going out, check the Distributions tab, as each distribution to an individual contact will be visible there. Here, you can download the Distribution History to track the distributions status.
  5. Email sent, but not received: If the distribution was sent, there may be an issue with email deliverability. Visit our page on Custom From Addresses to get some tips on improving email deliverability. If your emails are being marked as spam, you can also visit our page on how to Avoid Being Marked as Spam.
  6. Email not sent: If the distribution was not sent, has the survey been shared with you?
    • If the survey has been shared, check with the original survey owner to ensure that they have given you permission to distribute the survey. To see where the original survey owner can give you this permission, visit our Sharing a Project
    • If the survey has not been shared, the issue may be due to an error in Salesforce and the troubleshooting items in the Troubleshooting in Salesforce section should be reviewed.
    • Verify that you are using verified or accepted From addresses and Reply To addresses are valid, per our Custom From Addresses.
    • If your emails are failing or bouncing in the Distributions tab, refer to our Email Distribution Error Messages page for more information on these errors.

TROUBLESHOOTING IN SALESFORCE

  1. Email: Is Qualtrics looking at the correct field to find the email address? Qualtrics can only send a survey if it can find an email address as specified in the steps above.
  2. Workflow activation: Just like surveys have to be active to collect responses, a Workflow Rule has to be active before it will send survey requests to Qualtrics. For information about how a Workflow Rule is activated, view the steps above.
  3. Workflow Rule fires: Set up another simple Workflow in the same Workflow Rule and see what happens when the Workflow Rule is met. Does this other workflow fire properly?
    • If the Workflow fires, check the Task Output in the Workflows Reporting tab and continue troubleshooting below.
    • If the Workflow doesn’t fire, there is an issue with your Workflow Rule conditions. Check these conditions to ensure they are correct.
  4. Outbound URL: Ensure that the appropriate Outbound URL has been successfully pasted into the Workflow, as shown in the steps above. If this link is missing or is incorrect, Qualtrics won’t know to send surveys when the Workflow Rule is met. Note that you should be using the survey owner’s outbound message URL. If an incorrect Outbound URL is connected to the workflow rule you are triggering, you will not see the workflow being triggered in Workflows Reporting despite meeting the Workflow Rule’s conditions.
  5. Pending Messages: Go to the “Monitor” section under “Setup” within Salesforce. There is a section to monitor “Outbound Messages.” If you see any pending messages there, then Salesforce is more than likely the issue. However, if you see the outbound message there for an extended period of time (e,g., more than five minutes), contact Qualtrics Support.
  6. Salesforce Permissions: Your Salesforce account needs permission to trigger Outbound Messages. This permission is available in your Salesforce account by navigating through Profile -> System Permissions -> Send Outbound Messages.

FAQs