External routing overview
Summarize
Summary of External routing overview
External Routing in Advanced Work Assignment (AWA) enables routing work items to external queues based on service channel and queue conditions, with assignment handled by third-party systems such as contact-center-as-a-service (CCaaS) providers. This integration allows ServiceNow customers to outsource agent selection while maintaining visibility and control over work items within ServiceNow.
Show less
Process Flow
- Work items enter an external queue in a "queued" but unassigned state.
- If a maximum wait time is set, work items expire after this timeout.
- The external system uses AWA APIs to monitor queued work items and agent availability, then assigns work items to agents.
- Agents receive inbox cards with Accept and Reject options (if configured) to manage assignments.
Key Features
- API Integrations: Utilizes AWA Assignment API for assignment, Work Item Table API to query queued items, and optionally AWA Agent API to verify agent availability.
- Queue Behavior: Queues do not support Assignment Eligibility Groups and related queue-related lists are hidden to reflect external control.
- Agent Components: Supports agent availability, accept button, and capacity tracking without enforcing max capacity limits internally; reject button available if manually enabled.
- Service Channel Components: Uses advanced channel conditions and inbox layouts but does not use assignment fields such as "assign to" or "assignment group".
- Capacity and Utilization: Tracks agent and universal capacity usage but does not enforce max capacity limits internally when external routing is active.
- Queue Components: Max wait time and routing conditions are honored; queue agent presence checks are bypassed since assignment is external.
- Inbox Experience: Supports configurable accept/reject buttons and timeout displays, with auto-assign options to streamline agent workflow.
Practical Implementation Steps
- Create a connection alias in ServiceNow to link with the third-party routing provider.
- Develop custom flow actions and subflows in Workflow Studio to enable external routing logic.
- Define payloads to send work items to external queues and link these to the workflows.
- Configure AWA to enable external routing on specific queues and set up event handling for provider communication.
- Utilize provided test tools and plugins to validate external routing implementations before production deployment.
Benefits for ServiceNow Customers
- Seamless integration with external contact center providers while maintaining ServiceNow's work item tracking.
- Reduced internal routing complexity by outsourcing agent assignment decisions.
- Enhanced agent experience with inbox cards and configurable acceptance workflows.
- Improved assignment visibility and control through AWA APIs and event tracking.
- Support for automated testing and contextual routing configurations to tailor assignment strategies.
External Routing involves routing to external queue based on the service channel and queue conditions, and then the assignment is completed by the third-party system.
Process flow
- Work items are routed to the queue in a queued state but are unassigned. Work items expire if the Max timeout is set.
- External solution looks for work items in queued state by the Work Item Table API.
- External solution looks for agent availability vi the AWA Agent API before assigning to agent.
- The external solution uses the AWA Assignment API to assign the work items to the agent.
- The agent sees an inbox card.
- Queues do not allow to have Assignment Eligibility Groups defined.
- Work items remain in the queue with a "queued" status until the external system assigns the work item or the queue maximum wait time elapses.
- Related lists do not display at the bottom of the Queues screen.
- AWA Assignment API to support the external routing system to assign work items. For information on AWA Assignment API, see AWA Assignment API .
- Work item table API (awa_work_item) to look up the queued work items waiting for assignment. For information on table API, see Table API.
- AWA Agent API if the external solution requires validation of agent availability within Workspace before assignment. For more information on the AWA Agent API, see AWA Agent API.
Functionality of AWA components
When external routing is enabled, the AWA components provide these capabilities:
- Components utilized
- Agent availability
- Accept button
- Agent capacity in use (Service channel capacity) increases but is not utilized against the max capacity of service channel
- Agent universal capacity in use increases but is not utilized against the max universal capacity
- Components not utilized
- Reject button with rejection reasons: The Reject button is used when configured in the manual assignment API. If the reject button is enabled (allowed_to_decline=true parameter in assignment API request), then the rejection reasons are supported.
- Max agent capacity
- Max universal capacity
- Components utilized
- Channel advanced condition
- Inbox layouts
- Queue order
- Components not utilized
- Assign to and assignment group fieldsThese fields are used to:
- Determine if a document should qualify for routing.
- Determine which field to update once the work item is successfully assigned to an agent.
- Capacity and utilization features
- Agent capacity overrides
- Work item override
- Assign to and assignment group fields
- Components utilized
- Max wait time will expire work items if set on queue
- Work item routing conditions
- Queue order
- Components not utilized
- Queue agents' presence checks: Agent's presence is checked during the assignment API request processing.
- Work items remain in the queue with a status of "queued" until the external system routes the work item
- Queue schedules
- The following related lists are hidden on the queue since they are not utilized:
- Assignment eligibility and rules
- Work item sort order
- Agent Affinity
- Agent assignments
- Group queue priorities
- Work items
Functionality of External routing in AWA
External routing enables AWA to integrate with third-party contact-center-as-a-service (CCaaS) providers. When the external provider has made an assignment decision, the work item gets assigned utilizing the existing AWA Assignment API.
- Send events to keep providers informed about the work item and agent status.
- Enhance the assignment API to handle provider-initiated work items.
- Track and offer contact center work items, while outsourcing agent selection to the contact center.
- AWA provides additional parameters for an Inbox experience.
- AWA provides additional logging and performance improvements.
- The Inbox card is presented to the Agent with both the Reject and Accept buttons when Auto-accept is false.
- The Inbox card shows the Time-out value to Agent. If auto-assign is true, this field is ignored, when the Time-out value of the Work Item is greater than 0.
- The presence state of the agent switches to the specified presence state. If auto-assign is true OR no timeout is passed in, this field is ignored.
- The work item is immediately assigned to Accept, when the Auto-assign value is true.
- The auto-assigned work item is either displayed as an Inbox card, or both Inbox card and workspace tab. If the auto-assign value is false, this field is ignored.