Create Workflow Rules in Nonprofit Vertical CRM

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 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 a 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.
  • Rule Criteria - List out the criteria to filter out records that meet the criteria. Workflow rule is triggered to these records.
  • Actions - Specifiy the action to be automated for records that meet the set criteria.
    • Instant Actions - Add alerts, 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 alerts, 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. Click  (the Settings icon) > Setup > Automation > Workflow Rules.
  2. In the Workflow Rules page, click Create Rule.
  3. In the Create New Rule popup, 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 two 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.

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.

  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.
    • Delete: Executes the rule when certain records are deleted. Only Workflow Alerts 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.


  • When you select the Field Update option, do the following:

    • Choose the field name from the drop-down lists.
    • Choose one of the following:
      • Execute the rule when all the selected fields are updated.
      • Execute the rule when any selected field is updated.
  • 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 alerts 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 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. Please note, this option is available only in the Enterprise Edition.

  1. Choose a Date field from the drop-down list.
    All the date fields in the module for which the rule is being created will be listed.
  2. Choose On, Before or After from the drop-down list to set the Date of Execution.
    The rule can be set to trigger a maximum of 90 days Before or After the Date field specified.
  3. Specify the time of execution in hours and minutes.
    In case of DateTime fields, there is an option to trigger the rule based on the time in the field value.
  4. Select the Execution cycle as Once, EveryMonth or EveryYear.
  5. 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, alerts, 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 workflow alerts 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.

Part 3 - Set rule criteria

  1. In the Rule Criteria section, specify the rule criteria details.
  2. Click Add Criteria to add multiple criteria.
  3. Click Next.

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

  • Click Settings> Setup > Automation > Workflow Rules.
  • In the Workflow Rules page, click on a workflow rule.
  • In the Edit Rule page, review your existing criteria and click the Change Pattern link.
  • In Pattern Editor box, modify filters and click the Save link.
  • Save the modified custom view.

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 3the 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 ) )

Part 4 - Associate instant and/or scheduled actions

Workflow rules are meaningful only if an alert, task, field update, webhook or custom function is associated to the rule. They are grouped under Actions that can either be Instant Actions or Scheduled Actions. These actions once created, can be associated with many rules.

  1. In the Actions section, do the following:
    Note that you cannot save a rule without creating either an instant or a scheduled action.
    • Create Instant Action by associating alerts, tasks, field updates, webhooks or custom functions. See AlsoCreate Instant Actions
    • Create Scheduled Actions and associate alerts, tasks, field updates, webhooks or custom functions. See Also Create Scheduled Actions 
      A maximum of 5 scheduled actions can be created.
  2. Click Save.

Note:

  • For each action, you can associate a maximum of 5 alerts, 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 alerts, 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

Create Instant Actions

Instant action includes alerts, 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 alerts, tasks, field updates, 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 alerts, tasks, field updates, webhooks or custom functions to associate to the rule.

To create an instant action

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

  1. Click  (the Settings icon) > 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 Instant Actions section, do the following to associate alerts, tasks, field updates, webhooks or custom functions to the rule:
    • In the corresponding section, click (the Add icon) and specify the details to create a record and associate it to the rule.
    • In the corresponding section, click (the Associate icon) and select an existing record and associate it to the rule.
  5. Click Save.

Note:

  • For a workflow rule, all the actions (alerts, 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.
  • Only one set of instant action can be created with alerts, tasks, etc. associated to it.
  • You can associate a maximum of 5 alerts, 5 tasks, 3 field updates, 1 custom function and 1 webhook to the instant action.

Create Scheduled Actions

Scheduled actions include alerts, tasks, field updates, webhooks and custom 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 Date, record Created Time, record Modified Time as well as 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 to the rule.
  • Select existing alerts, tasks, field updates, webhooks or custom functions to associate to the rule.

To create scheduled actions

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

  1. Click  (the Settings icon) > 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 the Actions section, click Add a Scheduled Action.
  5. Enter a Name for the scheduled action.
  6. Specify the Execution Time, i.e. when the associated actions should be triggered.
  7. Click Save.
  8. Under Scheduled Actions section, do the following to associate alerts, tasks, field updates, webhooks or custom functions to the rule:
    • In the corresponding section, click (the Add icon), specify the details to create a record and associate it to the rule.
    • In the corresponding section, click (the Associate icon), select an existing record and associate it to the rule.
  9. Click Save.

Note:

  • For a workflow rule, all the actions (alerts, 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 alerts, 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.
  • Scheduled Actions are not minute based. There can be a delay of few minutes for the scheduled actions to be triggered.
  • When email alerts 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 records will be listed under Upcoming Actions in the Records Details Page.

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 workflow alerts.
  • 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 workflow email alerts 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 org. (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:

  1. 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.
  2. 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:

  1. 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.
  2. When the Enterprise Edition is downgraded to the Free Edition, all the scheduled actions that are scheduled for the record will be deleted.
  3. 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:

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

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. Click  (the Settings icon) > 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 popup, 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.
    The rule is now locked for editing.

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 alerts, 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. Click  (the Settings icon) > 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. Click  (the Settings icon) > 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.

Delete Workflow Rules

Workflow rules can be deactivated when not in use. You can also delete the 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

  1. Click  (the Settings icon) > Setup > Automation > Workflow Rules.
  2. In the Workflow Rules page, click the Delete icon for the corresponding rule.

    • Related Articles

    • 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 ...

    • 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 ...

    • 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 ...

    • Nonprofit Vertical CRM Common Operations

      How Can I... · Navigate Records · Search Records · Create Records · Create Records Individually · Import Records · Capture Records from Website (Using Web-to-record Form) · Export Records · Print Records · Restore Deleted Records · Merge Duplicate ...

    • 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 ...