Workflow Rules in Zoho Recruit are a set of actions (alerts, tasks, and field updates) that are executed when certain specified conditions are met. These rules automate the process of sending email alerts and SMS alerts, assigning tasks, and updating certain fields of a record when a rule is triggered.
A workflow rule consists of the following elements:
- Basic Details: Specify details on the record type for which the rule applies. Also includes the rule name and description.
Rule Trigger: Specify when the rule should be triggered for a record and what it should be based on. There are two options:
- Execute based on a record's action: Rules can be triggered when records are created, edited, created or edited, deleted, or a specific field is updated.
- Execute based on a date field's value: For all the records matching the rule criteria, the rule will be triggered either monthly or yearly based on the value of the date field that is selected.
- Rule Criteria: List the criteria to filter out records that meet the criteria. The workflow rule is triggered by these records.
Actions: Specifiy the action to be automated for records that meet the set criteria.
- Instant Actions: Add alerts, SMS triggers, tasks, field updates, webhooks, and custom functions to be triggered immediately when the rule is executed. For the Edit and Field Update actions, you can also convert candidates, contacts, or clients.
- Scheduled Actions: Add alerts, SMS triggers, tasks, field updates, webhooks, and custom functions to be scheduled and triggered at a specified time.
Create Workflow Rules in Zoho Recruit
The steps to create a workflow rule are divided into 4 parts.
Part 1 - Enter the basic details of the rule
- Click Setup > Automation > Workflow Rules.
- In the Workflow Rules page, click Create Rule.
In the Create New Rule pop-up, do the following:
- Select the module the rule applies to from the dropdown list.
- Enter the Rule Name and Description.
- Click Next.
Part 2 - Specify the rule trigger
There are two options for how the rule will be triggered for a record that matches the rule criteria. You need to select one of these options when you create a workflow rule and you cannot change it later.
- A Record Action:- Rules can be triggered when records are created, edited, created or edited, deleted, or when a specific field is updated.
- A Date Field's Value: For all the records matching the rule criteria, the rule will be triggered either monthly or yearly based on the value of the date field. This option is only available in the Enterprise Edition.
Execute Based on Record Action
When new candidates are created in Zoho Recruit, you may want to automatically send them an email, SMS alert, or a series of emails at set intervals. You may also want to create tasks for these new candidates, or trigger a workflow when specific fields are updated in the records. The Execute Based on Record Action execution option lets you specify an action (Create, Edit, Delete, etc.) to trigger workflow rules.
Select one of the following options:
If you select the Field Update
option, do the following:
- Click Next.
Note:
When you configure a workflow rule for the Events module, you will see another rule trigger, Cancel. Choose the Cancel trigger if you want to configure a workflow action when an event is canceled.
Execute Based on Date Field's Value
You may want to get an email or SMS reminder a week before an interview date or send an email to candidates reminding them when their interviews are. In these cases, the records do not need to be created or edited for the rule to be triggered. It is triggered based on the value in a date field. This execution option lets you pick a date field from a record and allows you to define the day for the rule to be triggered. When using this option, a maximum of 3,000 records can be triggered every hour. If there are more than 3,000 records, the remaining records will be executed the next hour. This option is only available in the Enterprise Edition.
- Choose a date field from the dropdown list.
All the date fields in the module the rule is being created for will be listed. - Choose On, Before, or After from the dropdown list to set the Date of Execution.
The rule can be set to trigger up to 90 days Before or After the value in the specified date field. - Specify the time of execution in hours and minutes.
For DateTime fields, there is an option to trigger the rule based on the time in the field value. - Select the execution cycle as Once, Every Month, or Every Year.
- Click Next.
Note:
- A locked rule cannot be edited by other users. If required, they can clone the rule and make changes to the cloned copy.
- The actions associated with a locked rule, such as alerts, field updates, and tasks, are also locked and cannot be edited or deleted by other users.
- For a rule to be triggered using the Field Update option, both the rule criteria and the execution criteria must be true.
- If your Zoho Recruit account is downgraded or the subscription expires, the workflow rules will be disabled. If you renew your subscription, you will need to manually re-enable the rules.
- If the Delete option is selected as the execution criteria, the workflow rule will not be triggered when records are deleted from the Recycle Bin.
- You can only configure and associate workflow alerts and webhooks for a workflow rule with Delete as the execution criteria.
- Workflow rules will be triggered when records are modified using mass update or macros and when ownership of records is changed. Rules are also triggered when tasks are created through macros.
Part 3 - Set rule criteria
- Specify the rule criteria details in the Rule Criteria section.
- Click Add Criteria to add multiple criteria.
- Click Next.
Edit Criteria Patterns
The Criteria Pattern Editor in the custom list view helps you develop advanced filters using simple logical operators AND and OR.
Note:
- You can specify up to a maximum of 25 criteria for a list view.
- If you are associating a convert action (an instant action) with the rule, it is mandatory to specify the criteria.
To edit criteria patterns:
- Navigate to Setup > Automation > Workflow Rules.
- Click on a workflow rule in the Workflow Rules page.
- In the Edit Rule page, review your existing criteria and click Change Pattern.
- Modify the filters in the Pattern Editor box and click Save.
- Save the modified custom view.
Example:
Important Notes
- You cannot add or delete a criteria row in the Specify Criteria section while the Change Pattern box is being used to edit the pattern.
- The operator's precedence will not be taken into account if you do not specify brackets. For example, if you specify the criteria as 1 or 2 and 3, it will be considered as ((1 or 2) and 3)
- You can change the AND or OR in the criteria row and it will also be updated in the Editor.
- You can change the AND or OR condition in the pattern and it will also be updated in the rows.
- If you specify criteria 1 and 2 and save them, the pattern will be shown as (1 and 2) when you edit it. For (1 and 2) or 3 the pattern will be shown as ( (1 and 2) or 3 ).
- If you add more rows to the editor and then delete them one by one there will be additional brackets displayed in the pattern. For example, if there are four rows added and you delete the third row, the criteria pattern will be ( ( ( ( 1 and 2 ) ) ) or 3 ). If the first row is deleted, then it will be shown as ( ( ( ( 1 ) ) ) or 2 ). When you save the criteria, it will change to ( 1 or 2 ).
- Make sure that you do not use any of the following as they are invalid: (), (and), (or).
- If the brackets do not match, the criteria will be invalid.
- There will an error message if the number of rows and the numbers in the pattern do not match or if there are any numbers missing from the pattern.
- If the final brackets are missing, there will be a difference between the pattern in the Criteria Patterns Editor and its view mode.
Your Criteria Pattern in Editor | Your Criteria Pattern in View Mode |
( 1 and 2 ) or ( 3 and 4 ) | (( 1 and 2 ) or ( 3 and 4 )) |
1 and 2 and 3 and 4 | (1 and 2 and 3 and 4 ) |
( 1 or 2 ) and ( 3 or 4 ) | ( ( 1 or 2 ) and ( 3 or 4 ) ) |
Part 4 - Associate instant and scheduled actions
Workflow rules are only meaningful if an alert, task, field update, webhook or custom function is associated with the rule. They are classified as Actions and can be either Instant Actions or Scheduled Actions. Once an action is created, it can be associated with multiple rules.
In the Actions section, do the following:
- Create an Instant Action by associating alerts, tasks, field updates, webhooks, or custom functions.
- Create Scheduled Actions and associate alerts, tasks, field updates, webhooks, or custom functions.
A maximum of five scheduled actions can be created for each rule. - Click Save.
Note that you cannot save a rule without creating either an instant or a scheduled action.
Note
- You can associate a maximum of five alerts, five tasks, and three field updates with each action.
- You can associate up to six) custom functions per workflow rule—one instant action and up to five time-based actions. You can also associate up to six webhooks per workflow rule—one instant action and up to five time-based actions.
- A maximum of five scheduled actions (alerts, tasks, field updates, webhooks, and custom functions) can be created for each rule.
- If your Zoho Recruit account is downgraded or the subscription expires, the workflow rules will be disabled. If you renew your subscription, you will need to manually re-enable the rules.
Associate Actions to Rules
Create Instant Actions
Instant action includes email alerts, SMS triggers, tasks, field updates, webhooks, and custom functions that are triggered immediately when the rule is executed. There are two ways of associating these actions:
- Create alerts, tasks, field updates, webhooks, or custom functions and associate them with the rule. You can also create an action to convert candidates.
- Select existing alerts, tasks, field updates, webhooks, or custom functions to associate with the rule.
To create an instant action:
(If you are creating a workflow rule, go straight to step 4.)
- Click Setup > Automation > Workflow Rules.
- In the Workflow Rules page, click on the rule for which you want to create an action.
- Click Edit to modify the rule settings.
In the Instant Actions section, associate alerts, tasks, field updates, webhooks, or custom functions with the rule:
- In the corresponding section, click the Add icon and specify the details to create a record and associate it with the rule.
- In the corresponding section, click the Associate icon and select an existing record and associate it with the rule.
- Click Save.
Note
- For a workflow rule, not all the actions (alerts, tasks, field updates, webhooks, and custom functions) will be listed. If the rule is for candidates, only the actions created for candidates will be available for association.
- Only one set of instant actions can be created with alerts or tasks associated with it.
- You can associate no more than five alerts, five tasks, three field updates, one custom function, and one webhook to each instant action.
Create Scheduled Actions
Scheduled actions include alerts, tasks, field updates, webhooks, and custom functions that are triggered in a specified amount of time after the rule is executed. You can schedule the actions to be triggered based on the Rule Trigger Date, record Created Time, record Modified Time, or any other time or date fields in the module. You can see the list of scheduled actions for individual records under Upcoming Actions.
There are two options to associate these actions:
- Create alerts, tasks, field updates, webhooks, or custom functions and associate them with the rule.
- Select existing alerts, tasks, field updates, webhooks, or custom functions to associate with the rule.
To create scheduled actions:
If you are creating a workflow rule, go straight to step 4.
- Click the Settings icon and go to Setup > Automation > WorkflowRules.
- In the Workflow Rules page, click on the rule you want to create an action for.
- Click Edit to modify the rule settings.
- In the Actions section, click Add a Scheduled Action.
- Enter a Name for the scheduled action.
- Specify the Execution Time. This is when the associated actions should be triggered.
- Click Save.
Follow these steps in the Scheduled Actions section to associate alerts, tasks, field updates, webhooks, or custom functions with the rule:
- In the corresponding section, click the Add icon and specify the details to create a record and associate it with the rule.
- In the corresponding section, click the Associate icon, select an existing record, and associate it with the rule.
Click Save.
Note
Situations when the scheduled actions will be rescheduled:
- The Execution Criteria for the rule is either Edit or Create or Edit. When the rule criteria is satisfied for a record, the instant actions are triggered and scheduled actions are scheduled for the record.
If a user edits the record and the rule criteria is no longer fulfilled, then the scheduled actions previously scheduled will be deleted. If the record is edited again and the criteria is satisfied, then the scheduled actions will be rescheduled. - The Execution Time for scheduled actions can also be based on a custom date and time field. When a rule criterion is satisfied for a record, the instant actions will be triggered and scheduled actions will be scheduled for the record.
If a user edits the record to change the value of the date and time field, the scheduled actions will be rescheduled according to the new date and time value.
Situations when scheduled actions will be deleted or not be rescheduled:
- The Execution Criteria for the rule is either Edit or Create or Edit. When the rule criteria is satisfied for a record, the instant actions will be triggered and scheduled actions will be scheduled for the record.
If a user edits the record and the rule criteria are no longer fulfilled, then the scheduled actions will not be scheduled again. - If the Enterprise Edition is downgraded to the Free Edition, all the scheduled actions that have been scheduled for the record will be deleted.
- When records are deleted, all the actions scheduled for the records will also be deleted. If the deleted records are restored, the scheduled actions will not be rescheduled.
Situations when the scheduled actions will not be executed:
- When an event is canceled, the actions scheduled for the event will not be executed.
- When a candidate is converted, the actions scheduled for the record will not be executed.
Lock Workflow Rules
If you want to make sure that no one edits a workflow rule unless absolutely necessary, you can lock the rule. When a rule is locked, it cannot be edited until it is unlocked again. A locked rule indicates to your fellow administrators that it should not be edited unless absolutely required. A workflow rule can be locked after it is created.
To lock a workflow rule:
- Click the Settings icon > Setup > Automation > Workflow Rules.
- From the Workflow Rules list view on the Rules tab, click the rule that you wish to lock.
- In the selected workflow rule details page, click the Lock icon next to the rule name.
- In the Lock Rule pop-up, enter the reason for locking the rule. This message will be displayed to other administrators who try to unlock the rule for editing.
- Click Lock.
Note
- Only Administrators can lock or unlock a workflow rule. This option prevents other users from editing or deleting the rule. If required, other users can clone the workflow rule.
- A rule can be unlocked by following the same procedure. You can click the Unlock icon in a workflow rules' details page and proceed to edit the rule.
Use List View and Summary View
There are two views for the workflow rules that are created in your account: the list view and the summary view. By default, you will see the list view, which is a list of all the workflow rules for either all modules or the selected module.
The summary view lists the criteria and field updates associated with the rules to help you get a clear picture of all the rules and where they are used.
Note
- You need to select a module to check the summary view. This view is not available when you select the All Modules option.
- The summary view is only available for workflow rules, not for alerts, tasks, and field updates.
- You can reorder the rules in the list view to change the sequence the rules need to be executed in. The Reorder option will only be available after you select a module from the dropdown list.
To use summary view:
- Click the Settings icon > Setup > Automation > Workflow Rules.
- Select a module from the dropdown list in the Workflow Rules page.
- Click the Summary View icon.
All the rules for the selected module will be listed along with their criteria and the associated field updates. You can click Show More to see the other items associated with the rule.
Delete Workflow Rules
Workflow rules can be deactivated when not in use. You can also delete unwanted workflow rules.
Note
When you delete a workflow rule, all the scheduled actions for the records will also be deleted. To delete workflow rules:
- Click the Settings icon > Setup > Automation > Workflow Rules.
- In the Workflow Rules home page, click the Delete icon for the rule you want to delete.