Overview

Last Updated : Oct 12, 2022 |

Rules are restrictions that you can configure for outreach attempts based on contact or address, number of attempts, channel, last attempt completion code, nuisance frequency, or attribute and system values such as, DNC, day, date, and time.

For example, you can create a rule to allow maximum three attempts in 24 hours. You can use the rule editor to configure rules. The Rule service must be running while performing any action in the rule editor. Otherwise, POM displays an error message.

Rule editor supports multitenancy.

If your user account is assigned the Experience Portal administrator role or POM Campaign Manager role, then by default, you have access to the rule editor. You can also create a custom role for accessing the rule editor.

In the rule editor, you can:

  • Configure rules that can be applied to all or specific campaigns.

    The rules created by a user are associated with the organization the user belongs to. When creating a rule, the owner organization information is stored in PIM_Rule table.

  • Exclude rules for callbacks, redial, external consult, manual, or preview type of campaigns.

  • Apply rules for voice, SMS, email, or custom type of channel.

  • Apply rules for contact address or contact record. A contact record is identified based on the contact ID you provide while importing the contact record into the POM system.

  • Apply rules based on completion codes.

  • Identify attempts that are restricted due to rules with custom completion codes.

  • Enable or disable rules, retaining the campaign association, for a particular zone.

  • Change the order in which the system and user-defined rules are run at a campaign level for a specific zone.

  • Edit a rule at run time in a running campaign.

  • Delete a rule. You can also delete a rule associated with a running campaign. When you delete a rule, the campaign and job association with the rule is removed.

  • Create custom rules by using a custom Java class.

    For more information about creating a custom class for custom rules, see Developer Guide for Proactive Outreach Manager.

Note:

You cannot configure rules with duration greater than the data retention period configured in the purge schedule. If you modify the purge schedule, ensure you modify the rules accordingly if required.

You can configure strategy restrictions, attribute and system restrictions, and rules. The order of precedence is: strategy restrictions, attribute and system restrictions, and then rules.

Based on the completion code specified in the rule that restricts a contact, you can create a handler node in the campaign strategy. In a campaign strategy, POM supports only one action for each handler node.

For example,

  • Before making an attempt, Campaign Manager checks if the rule engine has restricted any calls by the 24Hours_AMD rule. If the contact is restricted by the 24Hours_AMD rule, you can switch the attempt to Preview mode.

  • If a contact list is associated with two different campaigns and the same records are selected after applying filter in both the campaigns, all records may get dialed from both the campaigns. If you want a contact to be dialed only once regardless of its selection in any of the campaigns, create a rule by using the rule editor.

You can configure the rule at a global or campaign level to restrict the number of dialing attempts made on a contact or address within a specified time.

For example, you can create a rule to dial a contact only once in 24 hours. If you create such a rule at a global level, a contact is dialed only once in 24 hours even if it is part of multiple campaigns. If you create such a rule at a campaign level, then associate the rule with the campaigns where such behavior is desired.

Limitations

The rule editor has the following limitation:

  • The rules are applied at zone level, but the rule engine counts the attempts across all zones for a contact. Also, the rules are specific to any particular organization.

Rule association with organizations

Every rule created is associated with the organization. When creating a rule, the owner organization information is stored in PIM_Rule table. The rules created are owned by the user organization. The organization association with the rules does not specify if user is default organization, they can associate rules to multiple organizations.

Rules association behavior for different roles:
  • If a user is logged in as a default organization user, the user can view and edit all rules irrespective of the rule being created by any organization.

  • If user is logged in as organization-specific user, the user can view only the rules that are associated with the specific organization. The user cannot edit any rules, but can view the rules created.

When creating a rule, if the rule is marked as All Organizations, it cannot be modified to be assigned to specific organizations later. The default organization user can view and edit rules created by other organization user. The default organization user cannot modify the organization association for those rules.

Important:

When you create a new organization in Experience Portal, an organization-specific rule order is created and all global rules that are marked as All Organization are added under this order for the new organization. When the organization is deleted, rule association for this organization which is created at the global and campaign level is also deleted. Rules earlier associated with this organization do not exist. Rules which were earlier associated with a campaign mapped with this organization are also removed from the association.