Skip to content

Who can take calls

Not every CXGear user is a phone agent. Taking live calls needs three things to line up: the right role, a configured extension, and presence that says “I am ready.”

This page is the checklist supervisors use when someone says “I never get calls.”

A person can take live dialler calls when:

  1. They have the Agent or Supervisor system role (or a custom role with the same dialler agent permissions).
  2. They saved an extension on Dialler → Agent desk (tied to your telephony gateway).
  3. Their presence is Available (not Offline).
  4. Telephony routing can reach that extension for inbound, or place outbound through a trunk for lists / click-to-call.

Admins can configure everything and still not receive the call floater until they also meet the agent setup above.

RoleLive callsTypical use
AgentYesDesk staff who answer and place calls
SupervisorYes, plus desk toolsTeam leads, live supervisor views
AdminOnly if also set up as an agentConfigure org, projects, integrations

CXGear ships these as system roles. You can extend Agent or Supervisor into a custom role if you need one extra permission, but you cannot invent “take calls” without the underlying dialler agent capabilities.

Screenshot needed
Roles list highlighting Agent and Supervisor.
Where: Manage users → Roles
Save as: src/assets/screenshots/12-roles-list.png

Invite users under Manage users and assign Agent or Supervisor when they join the desk.

The extension is the agent’s identity on the PBX — the same number their desk phone registers as.

  1. Open Dialler → Agent desk.
  2. Enter the extension.
  3. Save (CXGear associates it with your Asterisk-style gateway when one exists).

Without an extension, CXGear does not treat the user as a live agent for the event stream and floater.

Screenshot needed
Agent desk form with extension field and presence controls.
Where: Dialler → Agent desk
Save as: src/assets/screenshots/24-dialler-presence.png

Presence tells the router whether to offer new work:

StatusMeaning
AvailableReady for new inbound offers and dialler work
On callBusy on a live call
Wrap upFinishing notes; usually do not offer new calls
OfflineDo not offer new calls; event stream not needed

Only Available agents should receive new inbound offers. Agents should go Offline at end of shift so calls route to people who are actually at the desk.

Use this when onboarding a new agent:

  1. Invite user → assign Agent or Supervisor.
  2. Confirm Integrations → Telephony gateway and trunks exist.
  3. Confirm Call routing has inbound DID → extension (and outbound patterns for dial-out).
  4. Agent sets extension on Agent desk.
  5. Agent registers the desk phone to that extension on the PBX.
  6. Agent sets presence to Available.
  7. Place a test inbound call or use click-to-call.
  8. Confirm floater appears and audio is on the phone.
  • Agent list / live views show the person as Available with an extension.
  • Inbound test offers the floater only to that agent (or the correct routed agent).
  • Outbound list and click-to-call work without configuration errors.
  • Going Offline stops new offers immediately.
SymptomLikely causeWhat to try
“I have Admin, why no calls?”Admin ≠ agentAssign Agent/Supervisor and set extension
Role is Agent, still nothingExtension missingSave extension on Agent desk
Extension set, still nothingPresence OfflineSwitch to Available
Floater for wrong personInbound route points at another extensionFix Call routing target
Two people share one extensionPBX / process issueOne extension per agent
Supervisor cannot see live deskPermission or tabUse Supervisor role; open Dialler → Live supervisor

Agent presence can store skills for future routing (for example language or product line). Voice dialler today is primarily extension- and presence-based. Skills-based assignment is part of the broader conversations roadmap — see Sticky sessions & skills.