Configuring Workflow Rules

Configuring Workflow Rules

Workflow Rules in Nonprofit Vertical CRM, are a set of actions (email notifications, tasks and field updates) that are executed when certain specified conditions are met. These rules automate the process of sending email notifications, 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, rule name, description.
  • Rule Trigger- Specify when the rule should be triggered for a record and based on what. There are two options:
    • Execute based on a record's action - Rules can be triggered when records are created, edited, created/edited, deleted or specific fields are updated.
    • Execute based on a date field's value - For all the records matching the rule criteria, rule will be triggered either monthly or yearly based on the value of the date field that is selected.
    • Execute based on a the record's score - Rules can be triggered when the score of a record is either increased, decreased or updated.
  • Workflow Condition - You can create multiple conditions in a workflow rule. Each condition consists of two elements. One is specifying which records should be triggered i.e. all records or the records that match the criteria. Another is adding the criteria based on which it should be triggered. When there are multiple conditions, records will be validated against the criteria mentioned in each condition and when it meets a criteria, the other conditions that follow will be ignored for validation. The following two options help you define the records that
    • All records that match the criteria - Rule will be triggered for the records that meet the criteria.
    • All records - Rule will be triggered for all the records.
    • Records that do not meet any of the above conditions - Instead of All Records, this option will be available from the second condition onwards
  • Actions - Specify the action to be automated for records that meet the set criteria.
    • Instant Actions - Add email notifications, tasks, field updates, webhooks and custom functions that will be triggered immediately when the rule is executed. On Edit or Field Update actions, you can also convert Leads, Quotes or Sales Orders.
    • Scheduled Actions - Add email notifications, tasks, field updates, webhooks and custom functions that will be scheduled and triggered based on a specified time.

Create Workflow Rules in Nonprofit Vertical CRM

The steps to create a workflow rule are divided into 4 parts.

Part 1 - Enter the basic details of the rule

  1. Go to Setup > Automation > Workflow Rules.
  2. In the Workflow Rules page, click Create Rule.
  3. In the Create New Rule pop-up, do the following:
    • Select the Module to which the rule applies from the drop-down list.
    • Enter the Rule Name and Description.
  4. Click Next.

Part 2 - Specify the rule trigger

There are three options based on which the rule will be triggered for a record that matched the rule criteria. One of these options need to be selected when you create a workflow rule and you cannot change it later by editing the rule. They are:

  • A Record Action - Rules can be triggered when records are created, edited, created/edited, deleted or a specific fields are updated.
  • A Date Field's Value -For all the records matching the rule criteria, rule will be triggered either monthly or yearly based on the value of the date field that is selected. This option is available only in the Enterprise Edition.
  • A Score Value - Rules can be triggered when the score of a record is either increased, decreased or updated.

Execute Based on Record Action

When new leads are created in Nonprofit Vertical CRM you may want to automatically send an email or a series of emails at set intervals. You may also want to create tasks for these new leads. Also, sometimes when specific fields are updated, you may want to trigger a workflow. This execution option lets you specify an action (Create, Edit, Delete, etc.) based on which workflow rules will be triggered.

For Edit, Create or Edit and FieldUpdate actions, an option to recur the workflow is provided. You can select the checkbox Recur this workflow every time a record is edited, if required.

  1. Select one of the following:
    • Create: Executes the rule when records are created.
    • Edit: Executes the rule when existing record are modified.
    • Create or Edit: Executes the rule when records are created or existing records are modified.
    • Field Update: Executes the rule when the values of the specified fields are modified in a record.
      • Choose the field name from the drop-down lists.
      • Click the All/Any link to toggle the options.
    • Delete: Executes the rule when certain records are deleted. Only Email Notifications and Webhooks can be associated for such a rule. The action includes:
      • Deleting a record from the Details Page.
      • Deleting from the List View (One by one or in bulk).
      • Using the Mass Delete feature.
      • Deleting from a record's Related List. For example, deleting a contact under an Account.
    • Click Next.


Note:

  • When you configure a workflow rule for the Events module, you will see another rule trigger called Cancel.
    The Cancel trigger can be chosen when you want to configure a workflow action on the cancellation of an event.
  • When you configure a workflow rule for the Visits module, you will see only the Create rule trigger. The other rule triggers like Edit, Field Update, etc. are not available for the Visits module.
  • When Workflow Actions are configured on creation of Visits, those actions will be executed for the leads/contacts associated with the Visit and not for the Visit itself. For example, when email notifications are configured for the visit, the emails are sent to the leads/contacts associated with the visit. Similarly, a task created on the creation of the visit is assigned to the record owner of the associated lead/contact.

Execute Based on Date or DateTime Field's Value

You may want to get an email reminder a week before a deal's expected closing date, or may want to send an email to the customers reminding them of the monthly rentals or subscription renewals. In these cases, it is not necessary that the records should be created or edited for the rule to get triggered. It is plainly based on the value in the date fields. 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.

Please note, with this option, a maximum of 3000 records will be triggered every hour. If there are more than 3000 records, the remaining records will be executed in the next hour. This option is available only in the Enterprise Edition.

  1. Enter the following to specify when you want the rule to be triggered.
    • Specify the Days, Hours or Minutes when it should be executed.
      The rule can be set to trigger a maximum of 180 days Before or After the Date field specified.
    • Choose On, Before or After from the drop-down list
    • Choose a Date or DateTime field from the drop-down list.
      All the date and date & time fields in the module for which the rule is being created will be listed.
  2. Click the Specify Time of Execution link and choose the time. 
  3. Select the Once, Every Month or Every Year from the Recur drop-down list.
  4. Click Next.

Note:

  • A locked rule cannot be edited by other users. If required, they can clone the rule to create another.
  • The actions such as, email notifications, field updates, tasks, etc. associated to a locked rule is also locked and cannot be edited or deleted by 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 Nonprofit Vertical CRM account is downgraded or the subscription expired, the workflow rules will be disabled. If you renew the subscription, you will need to manually enable the rules.
  • When the Delete option is selected as the execution criteria, a workflow rule will not be triggered if records are deleted from the Recycle Bin.
  • You can configure and associate only email notifications and webhooks to a workflow rule with the execution criteria as Delete.
  • Workflow Rules will be triggered when records are modified using Mass Update, Macros and when ownership of records are changed. Rules are also triggered when tasks are created through Macro.

Execute Based on Record's Score

Rules can be triggered when the score of a record is either increased, decreased or updated. For example, leads from the service industry are your prime prospects and you want to prioritize them based on the scores. You may want to closely follow-up with the leads that have a score of 10 or more. In such cases, you can create a workflow rule based on scores. When the score of a lead is updated and if the score is 10 or more, a task can be created to prioritize and follow-up on the lead immediately. 

  1. Choose either Increase, Decrease or Updated to specify when you want the rule to be triggered.


  2. Click Next.
  3. Specify the Condition when the rule should be executed.
  4. Click Next.


Note:

  • The automation will be applied in the following order: Scoring Rules > Workflow Rule > Approval Process > Blueprint > Scoring Rules. This is to ensure that the trigger loop is completed.
  • Workflow execution based on scores is available only for the Enterprise edition.

Part 3 - Create a workflow condition

Multiple conditions in a workflow rule help you address cases where you have clearly defined action items for the records that met the specified criteria and the ones that do not. For each rule, you can add a maximum of 10 conditions in the Enterprise Edition and 5 conditions each in the Standard and Professional Editions.

Example: In a deal follow up scenario, you may have the following requirements which can be best configured with Workflow conditions.

Workflow Conditions
Records that match the criteria:
Deal Amount is >= USD 6000, Campaign Source is Trade Show
Records that match the criteria:
Deal Amount is >= USD 2000, Campaign Source is Trade Show
Records that do not match any of the criteria:
Action 1
Send an email to the Sales Manager about the big deal.
Assign a task to the record owner to close the deal in a week's time.
Assign a task to the record owner to close the deal in a week's time and also to provide a 15-day trial.
Action 2
Assign a task to the record owner to cross check the discount guidelines and the final discount value.
-
Update the field value as Eligible, for the field - 15 Day Trial.
  1. Choose one of the following:
    • Records Matching the Conditions - Rule will be triggered only for those records that match the given criteria.
    • AllRecords - Rule will be triggered for all the records.
    • Records that do not meet any of the above conditions - Instead of AllRecords, this option will be available from the second condition onwards.
  2. Specify the criteria. You can click the Add icon to add multiple criteria.
    You can specify Tags as part of workflow criteria. 
    When you add more than one criterion, you will get an option to edit the criteria pattern.
  3. Click Next and add instant actions or scheduled actions.
  4. Click the Add another condition link to add another workflow condition and repeat the steps mentioned above.
    Please note that this option will be available only when at least one action (instant or scheduled) is added to the condition.

Part 4 - Associate instant and scheduled actions

A workflow rule is meaningful only if an action is associated to it. These actions include email notifications, tasks, field updates, webhooks and custom functions. They are grouped under Actions that can either be Instant or Scheduled. These actions once created, can be associated with many rules.

  1. In the Actions section, do the following:
    • Instant Actions- Click to associate instant actions that are triggered instantly when the workflow rule is triggered. You can also create one and associate it to the rule.
    • Scheduled Actions - Click to associate scheduled actions that will be triggered at a specified time once the rule is triggered. A maximum of 5 scheduled actions can be created.
  2. Click Save.
    Note that you cannot save a rule without creating either an instant or a scheduled action.

Note:

  • For each action, you can associate a maximum of 5 email notifications, 5 tasks, and 3 field updates.
  • You can associate up to 6 (1 Instant Action and 5 Time-Based Actions) custom functions per workflow rule. Similarly, you can associate up to 6 (1 Instant Action and 5 Time-Based Actions) webhooks per workflow rule.
  • A maximum of 5 Scheduled Actions (that includes email notifications, tasks, field updates, webhooks and custom functions) can be created for a rule.
  • If your Nonprofit Vertical CRM account is downgraded or the subscription expired, the workflow rules will be disabled. If you renew the subscription, you will need to manually enable the rules.

Associate Actions to Rules

Add Instant Actions

Instant action includes email notifications, tasks, field updates, webhooks and custom functions that are triggered immediately when the rule is executed. There are two options to associate these actions.

  • Create email notifications, tasks, field updates, tags, webhooks or custom functions and associate them to the rule. You can also create an action to convert leads, quotes or sales orders.
  • Select existing email notifications, tasks, field updates, webhooks or custom functions to associate to the rule.

To associate an instant action

If you are creating a workflow rule, directly go to step 4

  1. Go to Setup > Automation > WorkflowRules.
  2. In the Workflow Rules page, click on the rule for which you want to create an action.
  3. Click Edit to modify the rule settings.
  4. Under a Condition, click InstantAction/Action link and select the action from the drop-down list.
  5. In the pop-up, select the actions that are listed or click New [Action] to create one and then associate.
  6. Click Associate.

Note:

  • For a workflow rule, all the actions (email notifications, tasks, field updates, tags, webhooks and functions) will not be listed. If the rule is for Leads, only the actions created for Leads will be available for association.
  • Only one set of instant action can be created with email notifications, tasks, etc. associated to it.
  • You can associate a maximum of 5 email notifications, 5 tasks, 3 field updates, 1 custom function and 1 webhook to the instant action.

Add Scheduled Actions

Scheduled actions include email notifications, tasks, field updates, tags, webhooks and functions that are triggered on a specified time after the rule is executed. You can schedule the actions to be triggered based on the Rule Trigger Time. You can see the list of scheduled actions in a record's details page under Timeline > UpcomingActions.

There are two options to associate these actions.

  • Create email notifications, tasks, field updates, tags, webhooks or functions and associate them to the rule.
  • Select existing email notifications, tasks, field updates, webhooks or functions to associate to the rule.

To add scheduled actions

If you are creating a workflow rule, directly go to step 4

  1. Go to Setup > Automation > WorkflowRules.
  2. In the Workflow Rules page, click on the rule for which you want to create an action.
  3. Click Edit to modify the rule settings.
  4. Under a Condition, click ScheduledAction/Action link.
  5. In the pop-up, select Hours, Days, or Minutes and specify the value.
  6. Click Next.
  7. Click Action link and select the action from the drop-down list.
  8. In the pop-up, select the actions that are listed or click New [Action] to create one and then associate.
  9. Click Associate.

Note:

  • For a workflow rule, all the actions (email notifications, tasks, field updates, webhooks and custom functions) will not be listed. If the rule is for Leads, only the actions created for Leads will be available for association.
  • You can create a maximum of 5 scheduled actions for a workflow rule.
  • Each Scheduled Action can have a maximum of 5 email notifications, 5 tasks, 3 field updates, 5 custom functions and 5 webhooks.
  • If the Email Opt Out option is enabled, emails will not be sent to the customers.
  • For the Workflow Management feature, the Organization's Time Zone will be considered for calculating a day. In the absence of the time zone being defined, the Super Administrator's Time Zone will be considered.
  • There can be a delay of few minutes for the scheduled actions to be triggered.
  • When email notifications reach the limit for the day, any remaining emails to be sent the same day will not be sent.
  • If the Execution Time that is calculated is a time in the past, then the action will be triggered immediately. There can be a delay of few minutes for the scheduled actions to be triggered.
  • The scheduled actions for a record will be listed under Upcoming Actions in the Records Details Page.
  • When you choose Email Notifications, if you are in the Enterprise Edition, you will also find an option to send the email at Zia's suggested time for this workflow rule. When you select this option, the emails that are sent via this workflow rule are sent to the recipients based on their respective best time to contact suggestion by Zia.

Notes on Per Day Limits

  • (No. of Users * 100) or 5000, whichever is lower, will be taken as the maximum limit per day for emails to be sent using email notifications.
  • A maximum of 300 actions will be triggered every hour. If there are more than 300 actions per hour, the remaining actions will be executed in the next hour.
  • The Super Administrator of your CRM account will be notified if the email notifications limit is exceeded for the day. 
  • The per day limits (for e.g.: email limit) is calculated based on PST.
  • Limits for Custom Functions:
    • Calls per Day - 10000 calls/day or 200 calls per user license for the organization (whichever is lower)
    • Integration Tasks - 5000 Zoho API calls/day using deluge.
    • Get Data - 5000 calls/day
    • Post Data - 5000 calls/day
    • Send Email - 500 emails/day
  • Limits for Webhooks:
    • Professional Edition - 10000 calls/day or 100 calls/user license (whichever is lower).
    • Enterprise Edition - 10000 calls/day or 100 calls/user license (whichever is lower).

Instances 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 not fulfilled, then the scheduled actions scheduled earlier will be deleted. If the record is edited again and the criteria is satisfied, then the scheduled actions will be rescheduled.
  • For Scheduled Actions, the Execution Time can also be based on the custom Date & Time field. When a 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 to change the value of the date & time field, the scheduled actions will be rescheduled as per the new date & time value.

Instances 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 are triggered and scheduled actions are scheduled for the record.
    If a user edits the record but the rule criteria is not fulfilled, then the scheduled actions will not be scheduled again.
  • When the Enterprise Edition is downgraded to the Free Edition, all the scheduled actions that are scheduled for the record will be deleted.
  • When records are deleted, all the scheduled actions scheduled to the record will also be deleted. If the deleted records are restored, the scheduled actions will not be rescheduled.

Instances when the Scheduled actions will not be executed:

  • When an event is canceled, all the scheduled actions scheduled for the event will not be executed.
  • When a lead is converted, all the scheduled actions scheduled for the record will not be executed.

Edit Criteria Patterns

Criteria Pattern Editor in the custom list view helps you to develop the advanced filters using simple logical operators like and / or.

Note:

  • You can specify a maximum of 25 criteria for a list view.
  • If you are associating a convert action (an instant action) to the rule, specifying the criteria is mandatory.

To edit criteria patterns

  1. Go to Setup > Automation > Workflow Rules.
  2. In the Workflow Rules page, click on a workflow rule.
  3. In the Edit Rule page, review your existing criteria and click the Change Pattern link.
  4. In Pattern Editor box, modify filters and click the Save link.

Example:
You would like to trigger a workflow rule for all the potentials whose Type is New Business, Stage is Need Analysis or Qualification, and Amount is above $50000.

Type is New Business; Stage is Need Analysis or Qualification; and Amount > $50000.

You can create this criteria easily using the Criteria option given below:

The criteria pattern will be automatically set as:

Since the criteria pattern does not match the requirement, you can edit it as:

You can use the following characters in the Criteria Pattern Editor:

  • Round brackets: ( )
  • and / or operators
  • Criteria Row Number

Important Notes

  • When the Change Pattern box is being used to edit, you cannot add or delete a criteria row under the Specify Criteria section.
  • The operator 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 of the criteria rows and it will be updated in the Editor below.
  • You can change the and or or condition in the pattern and it will be updated in the rows above.
  • If you specify 1 and 2 and save it, on editing the view the pattern will be shown as (1 and 2). For (1 and 2) or 3 the pattern will be shown as ( (1 and 2) or 3 )
  • If you add more rows in the editor and delete one by one there will be additional brackets displayed in the pattern. For example if there are 4 rows added and you delete the 3rd row, the criteria pattern will be as ( ( ( ( 1 and 2 ) ) ) or 3 ). If the first row is deleted then it will be shown as ( ( ( ( 1 ) ) ) or 2 ). However, on saving the criteria, it will change as ( 1 or 2 ).
  • Make sure that you do not use the following as they are invalid: (), (and), (or).
  • If the brackets do not match it will be treated as invalid.
  • There will an error message, if the number of rows and the numbers given in the pattern do not match and also, if there are any numbers missed in the pattern.
  • In case the final brackets are missing, there will be a difference 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 ) )

Lock Workflow Rules

When 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. One has to unlock the rule in order to edit it again. A locked rule sends out the message to fellow administrators that it is not meant to be edited unless absolutely required. A workflow rule can be locked after it has been created.

To lock a workflow rule

  1. Go to Setup > Automation > Workflow Rules.
  2. From the Workflow Rules list view under the Rules tab, click the rule that you wish to lock.
  3. In the selected workflow rule details page, click the Lock icon next to the rule name.
  4. In the Lock Rule pop-up, enter the reason for locking the rule. This message will be displayed to fellow administrators who are trying to unlock the rule for editing.
  5. Click Lock.

Note:

  • Only Administrators can lock/unlock a workflow rule. This option is available so that other users are not able to edit or delete the rule. If required others can clone the workflow rule.
  • A rule can be unlocked by following the same procedure. In a workflow rule's details page, you can click the Unlock icon and proceed to edit the rule.

Use List View & Summary View

There are two views for workflow rules that are created - 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 All modules/Selected module.

The Summary view lists out the Criteria and Field Updates associated to the rules that will help you get a clear picture of all the rules and where they are used to avoid any confusion.

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 available only for the workflow rules and not for the email notifications, tasks and field updates.
  • In the List View you can reorder the rules to change the sequence in which the rules need to be executed. The Reorder option will be available only after you select a module from the drop-down list.

To use summary view

  1. Go to Setup > Automation > Workflow Rules.
  2. In the Workflow Rules page, select a module from the drop-down list.
  3. Click Summary View icon.
    All the rules for the selected module will be listed along with the Criteria and the associated Field Updates. You can click the Show More link to see the other items associated to the rule.

To reorder the workflow rules

  1. Go to Setup > Automation > Workflow Rules.
  2. In the Workflow Rules page, select a module from the drop-down list.
    Make sure you have selected the List View and not the Summary View.
  3. Click Reorder Rules.
  4. Drag and drop the rules in the order that you require.

View Workflow Usage

You can see insights on the usage of your workflow rules that have the action to send email notifications associated to them. Based on the open rate of the email template associated with your workflow rules, the best performing workflow rules are listed for every week.

Permission Required: All profiles

Features
Free
Standard
Professional
Enterprise
Workflow Usage
-
-
-

To track the workflow usage,

  1. Go to Setup > Automation > Workflow Rules.
  2. In the Workflow Rules page, click the Usage tab.
  3. In the Usage page, you will be able to:
  • View the list of top performing workflow rules by email open rate for the last 7 days.
  • Track the open rate of each email template via the respective workflow rule along with the overall open rate.
  1. Click open the rules to see more elaborate details on usage.

Delete Workflow Rules

You can also delete the workflow rules from the list view and also while viewing the rule. When you delete a workflow rule, all the scheduled actions for the records will also be deleted.

To delete workflow rules

  1. Go to Setup > Automation > Workflow Rules.
  2. In the Workflow Rules page, move you mouse pointer to the rule you want to delete and click the Delete icon.
    Alternatively, click on the rule that you to delete. In the rule details page, click the more options button and then click Delete.

    • Related Articles

    • Create Workflow Rules in Nonprofit Vertical CRM

      Workflow Rules in Nonprofit Vertical CRM, 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, assigning tasks and updating ...
    • Workflow Tasks

      Workflow Tasks are among the actions associated to a workflow rule. A task is an activity that is assigned to a user. When you associate a workflow task to a workflow rule, it is automatically assigned to the user when the rule is triggered for the ...
    • Setting Up Assignment Rules

      Assignment rules help you automatically assign the records to users in Nonprofit Vertical CRM. The assignment rule is applicable only for the leads, contacts, cases and records in custom modules that are imported or the ones that are captured through ...
    • Setting up Data Sharing Rules

      How Can I... By default, access rights to CRM records is set as private so that the record owner and his/her manager can oversee the CRM data. However, using the Data Sharing Rules, you can extend the access rights to users belonging to other roles ...
    • Setting Up Nonprofit Vertical CRM

      Setting up Nonprofit Vertical CRM for your Organization The Setup page in Nonprofit Vertical CRM helps you configure all settings necessary to get your CRM up and running. Be it personalization, automation or third-party integrations, you can ...