Advanced Assignment Policies
Overview
Section titled “Overview”The advanced assignment introduces a comprehensive policy-based conversation assignment system. This provides centralized management, advanced algorithms, and enterprise-grade capacity controls.
Feature Availability
Section titled “Feature Availability”-
Open Source: Assignment policies with round-robin algorithm
-
Enterprise and Business: All OSS features plus balanced assignment and agent capacity management
Core Concepts
Section titled “Core Concepts”Assignment Policies
Section titled “Assignment Policies”Assignment policies are centralized rules that control how conversations are automatically assigned to agents. Each policy defines:
-
Assignment Order: How agents are selected (round-robin or balanced)
-
Conversation Priority: Which conversations get assigned first
-
Fair Distribution: Rate limiting to prevent agent overload
Agent Capacity Policies (Enterprise)
Section titled “Agent Capacity Policies (Enterprise)”Capacity policies set conversation limits per agent with inbox-specific granularity and advanced filtering rules.
Assignment Policies
Section titled “Assignment Policies”Creating Assignment Policies
Section titled “Creating Assignment Policies”-
Navigate to Settings → Agent assignment → Assignment policy
-
Click Create Assignment Policy
-
Configure the following:
Basic Configuration
Section titled “Basic Configuration”-
Name: Unique policy identifier
-
Description: Optional policy description
-
Enabled: Toggle policy activation
Assignment Settings
Section titled “Assignment Settings”-
Assignment Order:
-
Round Robin: Cycles through available agents sequentially (OSS & Enterprise) -
Balanced: Distributes based on current workload, equal assignment (Enterprise only)
-
-
Conversation Priority:
-
Earliest Created: Assigns oldest conversations first -
Longest Waiting: Prioritizes conversations with longest wait times
-
-
Fair Distribution:
-
Limit: Maximum conversations per agent within time window (default: 100)
-
Window: Time period in seconds for rate limiting (default: 3600)
-
Linking Policies to Inboxes
Section titled “Linking Policies to Inboxes”-
Go to Settings → Agent Assignment
-
Edit a policy.
-
Add an Inbox.
Agent Capacity Management (Enterprise)
Section titled “Agent Capacity Management (Enterprise)”Creating Capacity Policies
Section titled “Creating Capacity Policies”-
Navigate to Settings → Assignment Policy → Capacity
-
Click Create Capacity Policy
-
Configure:
-
Basic Settings
-
Name: Policy identifier
-
Description: Optional description
-
-
Inbox Capacity Limits
-
For each inbox, set:
-
Conversation Limit: Maximum open conversations per agent
-
-
Exclusion Rules (JSON Configuration)
-
Excluded Labels: Conversations with these labels won’t be auto-assigned
-
Age Threshold: Exclude conversations older than specified hours
-
-
Assigning Capacity Policies to Agents
Section titled “Assigning Capacity Policies to Agents”-
Go to Assignment Policy → Agent Capacity Policy
-
Select an Agent Capacity Policy
-
Add Inbox capacity limits
-
Assign agents to the policy
Assignment Algorithms
Section titled “Assignment Algorithms”Round Robin (OSS & Enterprise)
Section titled “Round Robin (OSS & Enterprise)”Cycles through available agents sequentially, ensuring equal distribution over time.
Balanced Assignment (Enterprise)
Section titled “Balanced Assignment (Enterprise)”Intelligently distributes conversations based on:
-
Current agent workload
-
Equal assignment
Troubleshooting
Section titled “Troubleshooting”Common Issues
Section titled “Common Issues”Conversations Not Being Assigned
Section titled “Conversations Not Being Assigned”-
Verify assignment policy is enabled and linked to inbox
-
Check if agents are available and online
-
Ensure agents haven’t reached capacity limits (Enterprise)
-
Verify exclusion rules aren’t filtering out conversations
Uneven Distribution
Section titled “Uneven Distribution”-
Review fair distribution settings
-
Consider switching to balanced assignment (Enterprise)
-
Check agent availability patterns
Debugging Steps
Section titled “Debugging Steps”-
Check assignment policy configuration
-
Verify inbox-policy linkage
-
Review agent capacity settings (Enterprise)
-
Monitor assignment service logs
-
Validate agent availability status
Assignment V2 provides a robust, scalable solution for conversation management that grows with your organization’s needs while maintaining optimal agent workload distributio