Skip to main content
Human routing decides which agent gets a session that is waiting for a person. Here you set whether each agent can receive sessions and how many open sessions they handle at once.
Settings → Human Routing in your OpenCX dashboard. The page is titled Agent assignment. Viewing it requires the Members or Agent availability & capacity permission; changing availability and capacity requires write access to either one.

Set an agent’s availability and capacity

The Agent availability table lists every agent with their current status. Search by name or email. The table refreshes every 30 seconds. New members start Offline with a capacity of 5. Changing an agent’s availability here clears any availability status they picked, and their status shows as Online or Offline again.

Update capacity for all agents

1

Open the dialog

Click Update all… above the table.
2

Enter the capacity

Under Global capacity, enter a number from 0 to 1,000,000.
3

Save

Click Save. Every agent in the workspace gets this capacity. Per-team capacity set in Teams is not changed.

What counts toward capacity

  • Open sessions assigned to the agent count.
  • Snoozed sessions do not count while they are snoozed.
  • Sessions released with the Release Session From Capacity workflow action do not count until the customer sends a new message.
  • Capacity only limits automatic assignment. You can still assign a session to an agent by hand when they are full.
  • Chat capacity does not stop an agent from receiving phone calls. See Human calling.

How capacity works with team assignment

Sessions reach a team through a workflow such as Assign Ticket to Support Team, a teammate changing the team in the Inbox, an integration, or the API. What happens next depends on the team’s Support Assignment Strategy in Teams.
OpenCX assigns the session to an eligible team member. A member is eligible when all of these are true:
  • Their Availability is on.
  • They are Available in that team.
  • They have free capacity.
  • The team is within its office hours.
Among eligible members, the one with the most free capacity gets the session. If several tie, OpenCX prefers the member with fewer snoozed or released sessions, then picks at random.
A team can also set its own capacity per member in the team’s Members tab. The member’s limit in that team is the lower of the team capacity and their global capacity, and it counts only that team’s sessions. Free capacity is the smaller of what is left globally and what is left in the team. For example, an agent has a global capacity of 5 and a capacity of 2 in the Billing team. They have three open sessions in other teams and one in Billing. Globally they have 1 slot left, and in Billing they have 1 slot left, so Billing can assign them one more session. When nobody is eligible, the session waits in the team. OpenCX checks every support-enabled team’s waiting sessions about once a minute, and also right away when an agent comes online, becomes available in a team, or a session in the team closes. Waiting sessions are served in the team’s session assignment order.
Turning an agent’s availability off does not take away the sessions they already have. It only stops new automatic assignments.

Auto-assign on handoff

Each channel’s settings under Settings → Autopilot include Auto-Assign on Handoff, which is on by default. When the AI hands off a session, it assigns it to an available agent anywhere in the workspace, not within a particular team. It is not used when Zendesk or Salesforce handles your handoffs. If a workflow then moves the session to a team, the agent keeps it only if they belong to that team; otherwise the team assigns it as described above.

Calendar integration

Calendar integration is in early access. It marks agents unavailable during their calendar events. The Google Calendar and Microsoft Calendar switches stay disabled until your workspace is enrolled; hover a switch to see the support address to contact.

Troubleshooting


Availability statuses

Statuses agents pick to go online or offline

Teams

Assignment strategy, pacing and team capacity

Skills

Route sessions by expertise

Office hours

When teams accept new assignments