Managing Playbooks¶
A Playbook is a saved scenario that specifies how one or more Traffic Distribution Groups (TDGs) redistribute agents and phone numbers between Regions. Each Playbook:
- Selects one or more TDGs
- Sets agent distribution percentages for each Region
- Sets telephony (phone number) distribution percentages for each Region

When you execute a Playbook, these distributions are applied automatically. This lets you move traffic quickly without making manual changes during an incident.
You can configure Playbooks for different situations, such as:
- Full failover to a secondary Region
- Partial traffic shifts for testing
- Distributing specific business lines independently
Before You Begin¶
- You need the ACGR Admin role.
- At least one Traffic Distribution Group must exist. You cannot create a Playbook without one. See Managing Traffic Distribution Groups.
Viewing Playbooks¶
Navigate to CxPortal > ACGR > Playbooks. The All Playbooks table displays:
| Column | Description |
|---|---|
| Name | The Playbook name, shown as a clickable link. Clicking the name opens the Edit Playbook dialog. |
| Description | A short summary of the Playbook's purpose. |
| Date created | The date and time the Playbook was created. |
| Last used | The date and time the Playbook was last executed. |
| No. TDGs | The number of Traffic Distribution Groups included in the Playbook. |
| Actions | Edit (pencil) and Delete (trash) icons. |
Creating a Playbook¶
- Open Playbooks — Navigate to CxPortal > ACGR > Playbooks.
- Create a new Playbook — Click Create New Playbook.
- Name the Playbook — Enter a clear, recognizable name.
- Add a description — Provide context to help others quickly choose the correct Playbook.
- Select TDGs — Choose the Traffic Distribution Groups to include.
- Set distributions — Configure agent and phone number percentages for each Region.
- Click Create Playbook to save the Playbook — Once saved, the Playbook appears in the All Playbooks table and is available for selection from the Failover Now dialog.
Info: Agent Distribution percentages for the primary and secondary Regions must total 100 within each TDG. The same applies to Telephony Distribution.
Editing a Playbook¶
To update an existing Playbook:
- Locate the Playbook in the All Playbooks table.
- Click the pencil (Edit) icon.
- Update the fields as required.
- Click Update Playbook to save your changes.
From the Edit Playbook dialog you can also:
- Update agent and telephony distribution percentages per TDG.
- Remove a TDG from the Playbook using the delete icon next to it.
Deleting a Playbook¶
- Locate the Playbook in the All Playbooks table.
- Click the trash (Delete) icon in the Actions column.
- Confirm the deletion.
Danger: Deleting a Playbook is permanent and cannot be undone. Deleting a Playbook does not affect the TDGs or agents it referenced; only the Playbook definition is removed.