Get started with Workflows
- Help Scout aims to run every time based workflow in our system once every hour. However, that timeframe can vary if there are delays or backlogs in the system. For more info, see the Workflows Field Guide in Confluence.
- After a workflow that copies to a folder is deleted, there's a chance the folder might get stuck in the sidebar. To purge orphaned folders, visit the Workflows tab in Sumo.
- Regex searches: If the only workflow condition is a regex, the search numbers won't ever be correct. That's because we don't send regexes to Solr, and those displayed counts come from the PHP side of things - our PHP side/Solr side have different regexes, so there's always a bit of a disconnect. If the condition is *only* a regex the count is roughly equal to however many tickets are in that mailbox.
Workflows in Help Scout are similar to Gmail filters or rules in other email clients. Quite simply, workflows are composed of conditions (what you’re looking for) and actions (what you want to happen). This article is all about Workflows.
In this article
Anatomy of a workflow
Workflows contain conditions, operators, and actions. Together, you'll create "if" and "then" statements to perform actions on conversations. For example, if the subject line contains "Bug Report", then add a tag, send an email to the customer and put the email in a folder. Workflows can be either manual or automatic:
Automatic workflows are always on. They run in the background and watch everything - kind of like the NSA. They check new and existing conversations for matching conditions, then carry out one or more specified actions automatically. You might use an automatic workflow to:
- Route new conversations (based on subject text or other conditions) to a specific team member.
- Copy conversations to a folder based on which tag is applied to the conversation.
- Send a follow-up email to the customer after a period of inactivity.
- Keep tabs on replies made by new hires by isolating those conversations in a folder.
- Send an email notification to certain team members when a message is received from a VIP customer.
A manual workflow doesn’t do anything until you tell it to. When you apply a manual workflow, Help Scout performs all actions in one fell swoop. Look for the lightning bolt icon to run a manual workflow. You might use a manual workflow to:
- Tag conversations and move them in bulk to another mailbox.
- Add a tag, change the status, and send a predefined email all at the same time.
- Add a note, assign it to a team member, then copy the conversation to a folder.
- Remove tags and send an email to the customer, closing the conversation.
Creating new workflows
By default, only Administrators can create and manage workflows. If you want your Users to manage workflows as well, you can change that permission from the Company settings page. To then create a workflow, open a mailbox and head to Settings → Workflows.
- Give your workflow a cool name and select Manual or Automatic. If you're creating a manual workflow, you won't need to specify conditions since it only triggers when you click on it.
- If you're creating an automatic workflow, add conditions to the workflow. Select the appropriate operator (Is equal to, contains, etc.)
- On the Actions page, decide what you want your workflow to do when matching conversations are found.
- Review your workflow on the summary page, and activate it when you’re ready.
Note: If things aren’t matching just yet, you’ll see a small yellow note that reads: These conditions don’t match any existing conversations. You may want to double-check to make sure they are correct. If you do have matching conversations, you'll see a checkbox to apply actions to existing conversations.
Using multiple conditions
Workflows have two types of conditions: AND and OR.
Adding an AND condition means that your first condition must be true AND the second condition must also be true. Click the blue +AND text to add an AND condition.
Adding an OR condition means only one of your OR conditions needs to be true. Click on the blue +OR text to add an OR condition.
You can add multiple conditions to a single workflow. In the example below, note that the subject text must contain refund, AND the conversation must have a tag of payments. Easy, right? If a conversation does not contain both conditions, the workflow's actions will not fire.
Adding an OR condition means only one of your other conditions needs to be true for your actions to fire. The workflow seen below simply says that if the conversation subject contains refund, OR the conversation has a payments tag, perform the desired actions. One condition OR the other will suffice.
Combining AND/OR conditions
Here we have a workflow that’s looking for an active conversion AND a payments OR refund tag. Both tags are not required.
Now that we've driven it home, go make some workflows.
Workflows can be copied for use in the same mailbox, or copied and moved to another mailbox. Just head over to Settings → Workflows and open the workflow you want to copy. Look for the silver Copy button in the right-hand corner of the page.
When I update an existing workflow, can I apply the actions to older conversations?
Not at the moment. The option to apply actions to existing conversations is only available when the workflow is first created and activated.
It seems to be taking awhile for the workflow to update conversations. What gives?
If the workflow was just activated, it might take a couple of minutes before all of the matching conversations are updated. This is especially true if you're updating thousands of conversations.
Can an automatic workflow run on the same conversation more than once?
Negative. Automatic workflows will only run one time on a single conversation. Workflows only run once on a conversation to prevent email loops.
When a workflow sends an email to the customer, who is it from?
Messages sent to the customer via the Send Notification > Email the Customer action are sent from your mailbox address.
Why is the same conversation in the Unassigned queue and in a custom folder?
Conversations that are unassigned will always show in the Unassigned queue unless they're assigned to a User. The Copy to folder action does not remove the conversation from its parent folder.