Assign by hand
Any teammate can assign any conversation, to anyone on the team or to nobody.- In a conversation: use the Assignee menu in the header. It lists Unassigned and every teammate, with you marked (me).
- From the keyboard: press
ato assign the open conversation (or the highlighted row) to yourself. - From the command palette (
CtrlKwith a conversation open): Assign to me, Assign to teammate… or Unassign.
Round robin
With round robin on, the desk gives each conversation that starts needing a person to the next teammate who has the desk open.Turn it on
1
Open the assignment settings
Go to Settings → Inbox → Assignment. Owners and admins can change it; agents see the current choice.
2
Pick Round robin
Choose Round robin (“Give each chat to the next teammate who has the dashboard open.”). The default is Manual (“Chats wait in Unassigned until someone takes them.”).
3
Set a limit (optional)
Most open chats per teammate caps how many open conversations a teammate can hold and still be picked.
0 means no limit; the most is 100.4
Save
Press Save. It applies to the next conversation that needs a person.
When it assigns
Round robin runs at the moment a conversation starts needing a person:- The AI hands off. For any reason: the AI decides it can’t help, the customer presses Talk to a person, a website action the site marked for a person, the AI’s reply limit, the monthly AI cap, or an AI error. See Handoff.
- A new chat arrives while AI replies are off. It goes straight to the team.
- a teammate takes over from the AI (by replying or with Take over),
- a conversation already has an assignee,
- the chat began with a teammate’s invite from the Visitors page (it belongs to that teammate),
- the conversation isn’t open, or the AI is still handling it.
Who it picks
The desk looks only at teammates who are online (see Presence) and still members of the workspace. Of those under the limit, it picks the one who has waited longest since their last round-robin assignment. A tie goes to the teammate with fewer open conversations. The open-conversation count includes chats assigned by hand. When it assigns a conversation, the thread gets an internal note:Assigned to <name> automatically (round robin). The teammate gets a New chat assigned to you notification if they want either A chat is assigned to you or A chat needs a person.
If nobody is online, or everyone is at the limit, the conversation stays in Unassigned and every teammate who wants A chat needs a person is notified.
Assigning someone by hand always wins. Round robin only touches unassigned conversations, so it never moves a conversation someone already has.
desk.yaml as inbox.assignment (mode, capacity); saving here updates the file. See desk.yaml.
Presence
A teammate counts as online while they have the desk open in a browser tab. The desk keeps a live connection per tab and pings it every 30 seconds; a tab that hasn’t answered for 75 seconds counts as gone, so a laptop that went to sleep or a closed tab doesn’t keep someone online. You see who’s online in the account menu at the bottom of the sidebar: your name shows <workspace> · N online, and the menu lists everyone under Online now. Presence drives two things:- Round robin picks only from online teammates.
- The widget’s email ask. When nobody is online, the widget offers the visitor Get the reply by email? right away instead of after a minute. See the inbox.
Next steps
Notifications
Know when a chat is assigned to you.
Business hours
Tell visitors when your team is away.