State Rule Groups

What a State Rule Group Is

A state rule group is the top-level container that
bundles state holidays, call limits, and business hours
into a single named compliance policy.

Key Fields

• Name: a descriptive label.
• Description: optional notes about the group.
• Rule Scope: either "company" (applies to all offers) or "offer" (applies only to specific offers).
• Offer IDs: which offers this group applies to. Required when rule scope is "offer".
• State Business Hours: which business-hour rules are included.
• State Call Limits: which call-limit rules are included.
• State Holidays: which holiday rules are included.

Relationship to Child Rules

A state rule group references its child rules (business
hours, call limits, holidays) directly. There is no
separate linking step required beyond selecting them
when configuring the group.

Multiple Groups Can Apply

Unlike a single-active-group model, multiple rule groups
can apply simultaneously. All company-scoped groups plus
any offer-specific groups whose offer IDs include the
current offer are collected and evaluated. The first group
that blocks the call determines the outcome.

Validation

A rule group must have at least one of holidays, call
limits, or business hours selected. The rule scope and
company are required.

Enforcement Priority

Within a single rule group, all three rule types are
evaluated independently. A call must pass all three checks
to proceed:

1. Today must not be a holiday for the destination state.
2. The phone number's contact count must be within the call limit for the destination state.
3. The current time must fall within the business hours for the destination state and day of week.

If any check fails, the call is suppressed with a reason
and rescheduled for later.