View a markdown version of this page

OnSchedulePublish - Amazon Connect
Forecast group conditionStaffing group conditionImpacted agents conditionExample rule function

OnSchedulePublish

The OnSchedulePublish event source runs a rule when a schedule is published.

Scheduling rules have the following requirements:

  • The rule function must contain exactly one of the following conditions: forecast group, staffing group, or impacted agents.

  • All conditions use the CONTAINS_ANY operator and Negate must be false.

  • Each condition can be used only once in a rule function. To match more than one resource, list them in the Operands of that condition.

  • The rule function is a single AND operator whose operands are conditions. The OR operator and nested AND or OR groups aren't supported.

  • Supported actions are CREATE_TASK, SEND_NOTIFICATION, SEND_IN_APP_NOTIFICATION, and GENERATE_EVENTBRIDGE_EVENT. A rule can have 1 to 4 actions, and each action type can be used only once.

Forecast group condition

The rule runs when the event belongs to one of the specified forecast groups.

Parameters

  • Operator - "CONTAINS_ANY"

  • Operands – A list of 1 to 100 forecast group IDs.

  • ComparisonValue – "$.Scheduling.ForecastGroup.Id"

  • Negate - false

{
    "Operator": "CONTAINS_ANY",
    "Operands": ["forecastGroupId"],
    "ComparisonValue": "$.Scheduling.ForecastGroup.Id",
    "Negate": false
}

Staffing group condition

The rule runs when the event affects at least one of the specified staffing groups.

Parameters

  • Operator - "CONTAINS_ANY"

  • Operands – A list of 1 to 100 staffing group IDs.

  • ComparisonValue – "$.Scheduling.StaffingGroups[*].Id"

  • Negate - false

{
    "Operator": "CONTAINS_ANY",
    "Operands": ["staffingGroupId1", "staffingGroupId2"],
    "ComparisonValue": "$.Scheduling.StaffingGroups[*].Id",
    "Negate": false
}

Impacted agents condition

The rule runs when the event affects at least one of the specified agents.

Parameters

  • Operator - "CONTAINS_ANY"

  • Operands – A list of 1 to 100 agent (user) IDs.

  • ComparisonValue – "$.Scheduling.ImpactedAgents[*].Id"

  • Negate - false

{
    "Operator": "CONTAINS_ANY",
    "Operands": ["agentId1", "agentId2"],
    "ComparisonValue": "$.Scheduling.ImpactedAgents[*].Id",
    "Negate": false
}

Example rule function

{
    "Version": "2022-11-25",
    "RuleFunction": {
        "Operator": "AND",
        "Operands": [
        {
            "Operator": "CONTAINS_ANY",
            "Operands": ["staffingGroupId1", "staffingGroupId2"],
            "ComparisonValue": "$.Scheduling.StaffingGroups[*].Id",
            "Negate": false
        }
        ]
    }
}