Skip to main content
Version: Latest
User ManualNeed configuration, code or deployment details? In the Technical Manual: Enhanced RolesFeature ID Reference

Roles and Permissions

What you see in the application depends on who you are. This page explains how that works, what each built-in role can do, and how to ask for more access when a menu or a button is missing.

Roles and permissions in plain language​

  • A permission allows one thing, such as Use the messaging workspace or Manage Contact Center queues. Each menu item and each button checks for a permission.
  • A role is a named bundle of permissions, such as Agent or Supervisor. Your administrator gives each user one or more roles.
  • You get every permission of every role you have. A team lead who also takes calls can have both the Agent and the Supervisor role.

A screen also needs its feature to be turned on. A feature is one part of the product, such as Contact Center Supervision & Live Dashboard. If a feature is off, nobody sees its screens, whatever their role. Only administrators turn features on; see Features and settings.

Why menus differ between people​

Two people at the same company see different menus because:

  1. Their roles differ. An agent sees My workspace and Activities; a manager also sees Interaction Center > Management; an administrator also sees Settings and Tools.
  2. Features differ by site. A site that does not use the CRM has no Leads menu, and a site without the dialer has no Dialer Profiles.
  3. Some screens also need a setup record. The live dashboard and shared voicemail show only the queues on your own agent entitlement record. Without one, the page opens but is empty, even for an administrator. A supervisor needs one too, with the queues they oversee.
  1. Some tabs and buttons need a site setting. For example, Pause recording in the agent workspace only appears when the administrator allows it in Contact Center settings.

The built-in roles​

The product comes with ready-made permission sets for three role names: Administrator, Agent and Supervisor.

  • The Administrator role has every permission.
  • When your administrator creates a role named exactly Agent or Supervisor, it receives the permissions below automatically, for every feature that is turned on. Turning on a feature later adds that feature's permissions to these roles too.
  • There is no built-in Manager role. Most companies create one and pick its permissions by hand (see A role for managers).

Your administrator can change any role's permissions at any time, so your site may differ from the lists below.

Agent​

Agents take and place calls, work their activities and answer text messages.

AreaPermissions the Agent role gets
Contact centerSign in to Contact Center queues and campaigns; View interactions; Pause recording on own live interactions; Initiate secure capture on own live interactions; Listen to own call recordings (when Contact Center Call Recording is on)
Contact centerSign in to Contact Center queues and campaigns; View interactions; Pause recording on own live interactions; Initiate secure capture on own live interactions
Call recordingsListen to own call recordings (never anyone else's)
ActivitiesList activities; List Contact activities; Complete own activity; Create and edit activities
CRMConvert leads
MessagingUse the messaging workspace

Agents usually also need, added by the administrator:

  • Use the telephony soft phone, to open the soft phone in the phone apps. The Agent role does not get it automatically: open Access Control > Roles, edit the Agent role, find the permission with Search permissions, tick it and save, and every agent has the soft phone.
  • The content permissions for your contact type, such as List content items, to see and edit contacts.

Supervisor​

Supervisors watch the floor, step into live calls, work the shared voicemail and read reports.

AreaPermissions the Supervisor role gets
Contact centerMonitor the Contact Center in real time; View interactions; Transfer Contact Center calls externally; View Contact Center reports; Take over, end, transfer and record live Contact Center calls, and set agents' state; Listen to anyone's call recordings (when Contact Center Call Recording is on)
Contact centerMonitor the Contact Center in real time; View interactions; Transfer Contact Center calls externally; View Contact Center reports; Take over, end, transfer and record live Contact Center calls, and set agents' state
Call recordingsListen to anyone's call recordings (which includes listening to their own)
VoicemailAccess shared queue voicemail for entitled queues; Manage shared queue voicemail: delete messages and take over other users' claims
MessagingUse the messaging workspace; Send group messages; View all messaging conversations; Manage the messaging workspace

The Supervisor role does not include signing in to queues. A supervisor who also takes calls needs the Agent role as well, and every supervisor needs an entitlement record with the queues they supervise.

Administrator​

The Administrator role can see and change everything, including Settings, Tools > Features, users and roles. Keep it for the few people who run the site.

Some permissions go to the Administrator role only, so nobody else has them until an administrator gives them: Delete call recordings, Manage Contact Center queue groups, Manage Contact Center queues, Manage Contact Center agents, Manage Contact Center skills, Manage Contact Center business hours, Manage the Contact Center dialer, Manage the Contact Center voice media library, Manage interactions, Manage the Contact Center, Manage telephony settings, Manage telephony extensions and Use the telephony soft phone.

A role for managers​

Managers build the contact center: contacts, subjects, campaigns, queues and so on. A manager role typically gets the Manage ... permissions for the screens that person looks after, for example:

To work on...Permission
Load activitiesManage activity batches
Manage activities in bulkManage activities
Subjects and subject flowsManage subject flows
DispositionsManage dispositions
CampaignsManage campaigns; Manage campaign groups
CadencesManage cadences
Lead statuses and opportunity stagesManage lead statuses; Manage opportunity stages
Omnichannel addressesManage omnichannel addresses
Queues and entry pointsManage Contact Center queues; Manage Contact Center queue groups (also covered by Manage Contact Center queues and by the administrator's full access)
Queues and entry pointsManage Contact Center queues
Queue groupsManage Contact Center queue groups
Call recordingsListen to own call recordings; Listen to anyone's call recordings; Delete call recordings
Shared voicemailAccess shared queue voicemail for entitled queues; Manage shared queue voicemail
Soft phoneUse the telephony soft phone
SkillsManage Contact Center skills
Agent entitlements and agent statesManage Contact Center agents
Business hoursManage Contact Center business hours
Dialer profilesManage the Contact Center dialer
Voice mediaManage the Contact Center voice media library
Call recordingsDelete call recordings (the Administrator role only, by default)
ExtensionsManage telephony extensions
ReportsView Contact Center reports; View Omnichannel reports; Run 'Phone Number Verifications' Report; Manage report subscriptions
Report BuilderBuild reports and manage own custom reports and views; Share custom reports publicly and through share links; Manage all custom reports and views

Each User Manual page names the permission it needs in the table at the top.

A role that looks after one settings page​

A settings page under Settings opens for anyone who has the permission listed for it below, together with Access admin panel. Your administrator can therefore let someone look after, say, the Stripe connection or the telephony provider without giving them the Administrator role or the permission to change every site setting.

Settings pagePermission that opens it
Settings > Payments > StripeManage Stripe Settings
Settings > Commerce > TransactionsManage transaction settings
Settings > Commerce > Offline paymentsManage transaction settings
Settings > Commerce > ReceiptsManage receipt settings
Settings > Commerce > Orders, Emails and ReturnsManage orders
Settings > Commerce > CheckoutManage checkout settings
Settings > Commerce > Customers, Rewards and ReferralsManage customers
Settings > Commerce > InventoryManage inventory
Settings > Commerce > DownloadsManage digital files and downloads
Settings > Commerce > ReviewsModerate product reviews
Settings > Commerce > Product feedsManage product feeds
Settings > Commerce > FundraisingManage fundraising
Settings > Commerce > MarketplaceManage the marketplace
Settings > Address suggestionsManage address suggestions
Settings > SubscriptionsManage subscriptions settings
Settings > Communication > TelephonyManage telephony settings
Settings > Communication > SMS (the Telnyx section, when Telnyx SMS is on)Manage SMS Settings
Settings > Contact CenterManage the Contact Center
Settings > Artificial IntelligenceManage AI profiles. A person with only Manage chat interaction settings, Edit any chat interactions, Manage Copilot Settings, Manage Claude Settings, Manage the MCP Server settings or Manage the WebMCP settings can open the page too, and sees only the sections that permission covers.
Settings > DNC Registries and Settings > Content ImportManage DNC registry settings
Settings > Phone Number VerificationsManage phone number verification settings
Settings > User Display NameManage the user display name settings.
Settings > User AvatarsManage the avatar settings.

On a page that several features share, such as Settings > Artificial Intelligence, each section is shown only to people who have that section's permission. The menu item itself follows the permission shown in the table, so someone who has only one of the other permissions may need the page's address from the administrator.

Give the roles to users​

Open Access Control > Users, edit a user, tick the roles in the Roles section and save. A team lead who also takes calls gets both the Agent and the Supervisor role.

Permissions behind recordings, voicemail and reports​

ScreenPermissionsDefault roles
Call recordingsListen to own call recordingsAgent, Supervisor, Administrator
Listen to anyone's call recordingsSupervisor, Administrator
Delete call recordingsAdministrator
Shared voicemailAccess shared queue voicemail for entitled queues and Manage shared queue voicemailSupervisor, Administrator
ReportsView Contact Center reportsSupervisor, Administrator

Ask your administrator for access​

When a menu, a page or a button is missing, look up the page for that task in this manual. The table at the top names the Menu, the Permission and the Feature it needs. Then send your administrator a message like this one, filled in with what you found:

Hi,

I need access to [screen or task, for example: Interaction Center > Management > Queues] for my work on [what you need to do].

According to the User Manual, this needs:

  • Permission: [permission name from the page]
  • Feature: [feature name from the page]

I currently have the [your role or roles] role. Could you add the permission to one of my roles, or give me a role that has it? If the feature is turned off on our site, could you let me know whether we plan to use it?

Thank you, [Your name]

For administrators​

  • To create users and give them roles, see Users.
  • To create roles such as Agent, Supervisor and Manager and choose their permissions, see Roles.
  • To turn on the features a role needs, see Features and settings.