Building Workflows
What's on this page
About Building Workflows
Workflows are used to trigger tasks based on events or on a repeating schedule. This page covers how to use the workflow editor to build a workflow.
See Workflows Basic Overview for a broad overview of workflows, their use cases, and how to manage workflows after they’ve been built.
Qtip: There is a daily limit of 300,000 workflow executions. Learn more about how you’ll be able to troubleshoot blocked workflows.
Building a Workflow
Qtip: You can use the controls in the bottom left corner of the editor or the scroll wheel on your mouse to zoom in and out. You can also click and drag the editor to pan around to visualize your workflow.
Choosing an Event
“Events” occur in Qualtrics or other systems and cause a workflow to start. To create an event-based workflow, click Create a workflow and select Started when an event is received.
Then, you can choose the event you want to start the workflow. The selected event will determine what kinds of conditions can be applied to the workflow. You can use the search bar at the top of the window to easily find available events. The events available to you will depend on your license, permissions, and project type. See below for a brief explanation of each event type and visit the linked pages for step-by-step instructions on how to set up each specific task.
Events Available Everywhere
The events listed below are available to use in both the survey Workflows tab and the stand-alone Workflows page.
- Survey Response: Trigger the workflow based on how a respondent responds to your survey.
Salesforce Outbound Message: Trigger the workflow based on Salesforce outbound messages.
Qtip: This event is not available for EX projects.
- Ticket Event: Trigger the workflow based on ticket data
Qtip: This event is not available for EX projects.
- JSON Event: Trigger the workflow based on an API call.
- ServiceNow Event: Trigger the workflow based on an event in ServiceNow.
- Zendesk Event: Trigger the workflow based on an event in Zendesk.
- Twilio Segment Event: Begin a workflow based on data events in Twilio Segment, update contact information in XM Directory based on Twilio Segment, or add transaction to an XM Directory contact based on events in Twilio Segment.
- Jira Event: Trigger workflows based on changes to Jira issues, such as status updates.
- XM Discover Event: Trigger a workflow based on verbatim alerts or scorecard alerts sent in XM Discover
Events Only Available in Stand-alone Workflows
The following events are only available when setting up an event-based workflow through the stand-alone Workflows page.
- API Usage Threshold Event: Trigger the workflow based on your license’s API usage.
Survey Definition Event: Trigger the workflow based on a project’s status changing.
Qtip: The survey definition event cannot be used for EX project types.
- iQ Anomaly Event: Trigger the workflow based on spikes or drops in survey response counts.
- Experience iD Change Event: Trigger workflows based on contact data changes, subscription changes, or transaction data changes.
- Experience iD Segments Event: Trigger a workflow based on whether a contact has been added to or removed from a segment.
- Action Plan Event: Trigger the workflow based on changes to EX action plans.
Setting a Workflow Schedule
Scheduled workflows allow you to create workflows that run at a specific time. You can set your workflow to run on a recurring basis, and you can choose when the workflow begins and ends.
To create a scheduled workflow, select Started at a specific time (scheduled) when creating your workflow.
Then choose your desired schedule frequency. This can be hourly, daily, weekly, monthly, quarterly, annually, or a custom expression.
The next step will depend on your workflow’s frequency:
Weekly and Monthly: Choose which days you would like it to run by clicking the drop-down and selecting the checkboxes next to each day.
Qtip: If you choose a date that doesn’t exist in every month (ex: 29, 30, or 31), the workflow will not occur during those months.
Quarterly: Choose which month of the quarter and day of the month the workflow should run.
Qtip: If you want the workflow to run on the last day of the month, make sure to choose Last day.
Annually: Choose the specific day of the year that the workflow should run.
Custom Cron Expression: Enter a cron expression that represents when the workflow should run. Click Show details to view how your cron expression is evaluated. See this website for help generating a Cron expression.
Qtip: Cron expressions can only have 5 parts and must contain valid characters. Intervals less than 1 hour are not allowed. See this guide to cron expressions for more information.
Example: In the above screenshot, the scheduled workflow will run on the hour every 3 hours, starting at 1:00 AM, every 2 days.
Next, type in or click the drop-down to select the start time for your workflow.
If you would like the workflow to run multiple times on the same day, click Add a start time.
Example: Let’s say you want to execute your workflow 3 times per day. Set the frequency to daily, and add which 3 times in the day that you would like the workflow to run. This workflow will execute at 9AM, 12PM, and 3PM each day.
Attention: Certain tasks may take up to 15 minutes to complete, so we do not recommend scheduling tasks with longer run times in very close increments. The duration needed to execute a task can be found in that workflow’s run history.
Next, select which time zone you want the workflow to run on. By default, the account’s time zone will be selected.
Qtip: Pay close attention to the time zone you select. Scheduled workflows do adjust to Daylight Saving Time, if the selected time zone observes it. For example, the UTC±00:00 Dublin time zone does observe DST, while the UTC±00:00 Abidjan time zone does not.
Then, choose when you want the workflow to start and stop running. By default, scheduled workflows will start running immediately after being activated and only stop running when deactivated. However, you can choose a start date and end date for your scheduled workflow instead.
Attention: Tasks created in scheduled workflows cannot use piped text. That’s because there’s no source to pipe information from, unlike in an event-based workflow.
Qtip: if you’re looking to email reports on a regular basis, see the options for sharing results, sharing reports, and sharing dashboards (if applicable).
Manually triggering scheduled workflows
Rather than waiting for a scheduled workflow to fire, you can trigger it with the click of a button. In the workflow editor, you can immediately cause a workflow to fire during the testing process.
Example: Let’s say that you would like to create a workflow that is scheduled to trigger every Monday at 6:00 am, but you’re building your workflow on a Wednesday. You’d like to test your workflow without waiting for it to trigger the following Monday. You can manually trigger your workflow immediately in order to test that it’s working the way you want it to.
Creating Conditions
Qtip: Conditions are not required on every workflow. Conditions are also called “decisions” in the workflow editor.
You can add conditions to your workflow so that they only run when certain criteria are met. Conditions can be added after an event in an event-based workflow, or after certain types of tasks. For example, you’re entering respondents into a raffle, but only if they opted-in to the raffle in your survey.
You can use conditions to create branching workflows that have different outputs based on how conditions are evaluated. For example, if you have a customer satisfaction survey, you could send the respondent a “thank you” email if they respond positively; however, if they respond negatively, you can send them a “we’ll do better” email and create a ticket to have a member of their account team follow-up with them later.
Conditions are built by creating logic statements that use information from the chosen event or task:
You can include multiple condition blocks and branches in a workflow. When the workflow runs, the workflow conditions and tasks will be evaluated in the order they appear in the workflow editor, from top-to-bottom. The workflow will continue evaluating until it reaches one of the ends of the workflow branches.
Example: In this example, the workflow will trigger when these conditions are true:
- If the respondent responds that they are “extremely dissatisfied” with the company.
OR- If the respondent is from the EU region AND the quota for Europe, Middle East, and Africa has not been met.
Qtip: See Basics of Building Conditions for more information on building conditions. Note that this page is about filtering response data, but the information on conditions is the same for workflows.
Example: In this example, we have a store satisfaction survey with multiple workflow branches depending on the customer’s response:
Defining Tasks
You can add up to 20 tasks and controls (conditions or loops) per workflow to follow-up on your research and survey responses. Each task type is capable of solving an array of problems. You can use the search bar at the top to of the task selector to search your available tasks. For a full list of tasks, check out the Tasks category in the Workflows section of the support site.
Qtip: Click the i icon on a task to get more information about the task. This window also includes a link to that specific task’s support page if you need guidance setting up the task.
General Workflows Tasks
Below is an example list of tasks can be used across the Qualtrics platform.
- Tickets Task: Create a ticket in Qualtrics that can be actioned by your Support Team.
- Email Task: Send an email.
- Web Service Task: Pass information using API calls.
- Send Survey via Email Task: Distribute a survey to contact information in your XM Directory.
- Update XM Directory Contacts Task: Create or update contact information.
- Code Task: Use custom JavaScript to manipulate data that is passed between tasks.
- Notifications Feed Task: Create a notification as a result of the workflow.
- Calculate Metric Task: Trigger a response based on changes in aggregate metrics in your dataset.
Add-On Extension Tasks
Qtip: The following tasks require the separate purchase of an extension. If you don’t already have access to one or more of these extensions and are interested, check out our XM Marketplace.
- Slack Task: Achievement metrics could trigger Slack channel messages.
- Salesforce Task: Use Salesforce tasks for response mapping or web-to-lead.
- Zendesk Task: The Zendesk extension allows you to create and update tickets in Zendesk based on responses collected with Qualtrics surveys.
- Freshdesk Task: The Freshdesk extension allows you to create tickets in Freshdesk based on workflows triggered in Qualtrics.
- Hubspot Task: The Hubspot extension allows you to create and update deals and contacts in Hubspot from collected survey responses.
- ServiceNow Task: The ServiceNow extension allows you to create and update incidents in ServiceNow as well as update customer contact information provided by survey responses.
- Microsoft Dynamics: The Microsoft Dynamics extension allows you link up your account to a Qualtrics survey for both Response Mapping and Web to Lead capabilities.
- Tango Card Task: Incentivize surveys with Tango Card.
- Marketo Task: Send data to Marketo as a custom activity.
Sharing Credentials for Extension Tasks
If your task requires you to login with that extension’s credentials, the workflow owner must have at least read-only access to the account in order for the workflow to run successfully. Accounts set up by the Brand Administrator in the Extensions tab do not need to have their credentials shared.
Example: Let’s say a collaborator needs to edit a workflow to add a Slack notification every time the workflow runs. If the collaborator sets up the task with their personal login for Slack, they will need to grant access to the workflow owner.
Attention: If you are using credentials that are shared with you, you will not be able to grant access. The workflow owner will need to be given access by the owner of the credentials.
To remove the workflow owner’s access to your credentials:
ETL Workflows
ETL Workflows use data extracting and loading tasks to import data from a third-party source and import into Qualtrics. ETL workflows require you to use certain tasks with each other to complete your workflow. See Using Workflows Tasks to Build ETL Workflows for more information.
AI-Generated Workflows
You can leverage artificial intelligence (AI) to help build Qualtrics workflows. By simply describing your desired use case, generative AI can create the framework event, condition blocks, and tasks that make up your workflow.
Attention: Generative AI is a starting point and all configurations must be manually verified before enabling the workflow. Output from Qualtrics’ AI features is not a substitute for human review or professional guidance. This feature creates a workflow skeleton and you must configure the individual components.
Qtip: To use this feature, the Enable AI Assistance in Configuring Workflows permission must be enabled on both the brand and individual user levels.
Using Workflow Templates
When creating a new workflow, you will have the option to use a Qualtrics template. These are pre-configured workflows designed to make setting up useful workflows easy. Workflow templates are created by our Qualtrics subject matter experts to leverage industry standards for workflow automations.
Using Templates
Example Templates
Below are a few example templates. This is not an exhaustive list of available templates. Log into the platform to begin exploring all of the options available to you.
Qtip: Use the search at the top of the Catalog to find and search templates. You can search by keywords in the template. For example, search “ticket” to find all templates that use ticket tasks. You can also use the filter groups to display templates that meet certain criteria.
Create a Qualtrics ticket for website or app support requests: This template uses a tickets task to create a Qualtrics ticket when a new survey response for support comes in on a website or app intercept.
Get an email when NPS drops week-over-week: This template uses a calculate metric task to calculate your organization’s week-over-week NPS score, and sends an email if the score drops below a certain threshold you set.
Import Salesforce data into XM Directory: This template combines an extract data from Salesforce task and an add contacts and transactions to XMD task in a guided setup to easily import data from Salesforce to save in your Qualtrics XM Directory.
FAQs
I don’t see a template that fits my business goals. Will more templates be coming in the future?
I don’t see a template that fits my business goals. Will more templates be coming in the future?
Yes! This is a growing library of workflow templates built by our in house subject matter experts. We will add new scenarios and use cases over time.
Do I have access to all extensions available through the Workflows templates?
Do I have access to all extensions available through the Workflows templates?
How do I use 3rd-party extensions within Workflows templates?
How do I use 3rd-party extensions within Workflows templates?
Can I request a template be built for my organization?
Can I request a template be built for my organization?
Is there a link to all Workflows events and tasks?
Is there a link to all Workflows events and tasks?
What are Workflows templates?
What are Workflows templates?
What are the different major types of Workflows templates?
What are the different major types of Workflows templates?
- Experience metric trend visibility and reporting
- Survey follow-up management
- Ticket management
- Team communication & collaboration
- Data management (ETL)
What are workflows? / Where are actions?
What are workflows? / Where are actions?
There are no changes to workflow functionality as part of this update.
How quickly can I expect workflows to run?
How quickly can I expect workflows to run?
Is there a maximum size workflows can be?
Is there a maximum size workflows can be?
This task is marked as “Preview.” What does that mean?
This task is marked as “Preview.” What does that mean?
If I have two workflows sent at the same time, in what order will they run?
If I have two workflows sent at the same time, in what order will they run?
That's great! Thank you for your feedback!
Thank you for your feedback!