Roles and Permissions

Note: If you are in Talkdesk Workspace, you can access “Admin” and all features described below by navigating to the Admin app. For more information, please refer to this article.

The Roles and Permissions tab in Talkdesk offers advanced usability and allows you to manage your team more effectively.

In this tab, Administrators can define and edit user roles (Administrator, Supervisor, Agent, or any other custom role), specify unique Talkdesk settings for each role and assign agents to specific roles. 

By default, when a Talkdesk account is created, the following roles are simultaneously created with the ensuing permissions: 

  • Administrator: Can access the Administrator dashboard and the apps within - "Calls", "Contacts", "Voicemails", "Teams", "Reporting", "Admin", and "AppConnect"; can edit preferences and configure settings. This role encompasses all the account’s permissions and cannot be modified in any way, making it not possible to rename, deactivate or change its default permissions. Only by creating a role based on this one, can the permissions be changed.
  • Agent: Can only access the "Calls", "Contacts", and "Voicemails" applications of the "Agent Dashboard". The “Agent” default role is preconfigured to not be able to edit Preferences, configure settings, or view advanced reports. This role can have its permissions changed, but its name cannot be modified, and it cannot be deactivated.
  • Supervisor: Can access the "Supervisor Dashboard" and the Applications within - "Calls", "Contacts", "Voicemails", "Teams", "Reporting", and "App Connect" (view access). The “Supervisor” default role is preconfigured to not be able to edit preferences or configure settings. This role can have its permissions changed, but its name cannot be modified, and it cannot be deactivated. 

Before learning how to configure Roles and Permissions, let’s get to know the main concepts of this area: 


Role: the identifier of an aggregation of permissions that defines the applications and data users can access in Talkdesk.

  1. Application: is a set of functionalities that serves a specific purpose – business domain.
  2. Area: represents a group of functionalities within an application area (e.g.: users, roles, calls, numbers, among others) upon which permissions are taken.
  3. Section: a way to group areas that manage more than one function or resource within the same context (e.g.: Admin’s Billing section)
  4. Permission: specific action that determines a capability within the application.
  5. Scope: a data segregation mechanism that determines the object(s) to which the users can perform a given action. 

To learn how to configure roles and permissions, follow the directions below.

Creating New Roles

Defining and Editing Permissions

Assigning Users to Roles

Removing Permissions

Deactivating Roles


Creating New Roles


  1. Log in to your Talkdesk account as an Administrator.
  2. Select the Admin app [1].
  3. Click on the Roles and Permissions tab [2].
  4. The account’s default roles will be displayed. You can define the permissions for Supervisor or Agent default roles or create a new role by clicking the Create role button [3]


  1. Provide a “Name” [4] and aDescription” [5] for the new role. 
  2. Use the toggle to define the initial status of the role: “Active” or “Deactivated” [6].
  3. When finished, click Create [7].

image10.png8. When the new role is created, the “Details” page will be displayed. Verify that the details entered correspond to your needs, or click Edit [8] to make changes, if necessary.

9. To start adding permissions to your newly created role, click the Permissions [9] tab.


Defining and Editing Permissions


  1. You can define permissions, for the newly created role, by selecting the option Add permissions [1].


  1. You can also use a permission setup that has been previously configured for another role by clicking on Copy from an existing role[2], choosing the desired role from the dropdown menu, and clicking Copy to confirm your selection.


  1. Adding permissions can also be done on the “Roles” main page, by clicking on the more options "...” button [A] next to the role that you wish to configure.

Note: The more options "..." button is not available in the Administrator role because its default permissions cannot be edited.


  1. In both cases, you will be directed to this page, where all the permissions are listed. Click the expand-collapse arrow button to configure the permissions and scope for each application [3].
  2. Select the buttons next to the name of the area to define the level of access you wish to grant to the users that belong to this role [4]. You can allow them to (when applicable): 
  • Create (e.g, create new contacts, add new numbers or agents, among others).
  • View the feature or item (e.g., call recordings).
  • Update settings (e.g., edit ring groups in the agent’s profile).
  • And/or Delete settings for the feature (e.g. delete agents, and numbers, among others).

Selecting scopes while configuring permissions:

Talkdesk products support scoping on two levels: 


  1. Scope by Application: the scope selected is applied to all the application areas and permissions. 


Scope by Area: the administrator is able to define a different scope for each area within the application. This means that the selected scope is applied only to the area it belongs. For example, you can define a different scope per dashboard:

6. Select the data scope that users can view in each specificTalkdesk application from the “Select scope” dropdown menu [5]: 

  • All: The user will see all the information related to the account.
  • Team: The user will only see information related to the team assigned to them.
  • Child Teams: The user will only see information related to the child teams of the team assigned to them.
  • Team + Child Teams: The user will only see information related to the team assigned to them and their child teams.
  • Ring Group: The user will only see information related to the ring groups assigned to them.
  • User: The user will only see information related to them.

7. When you have finished configuring the permissions, click Save at the top of the screen.

image5.png8. On the Roles’ main page, you will be able to see your created roles, along with the default roles. Here, you can: 

  • Search for the desired role [C].
  • Choose the number of results you wish to view on the page [D]. 
  • Filter by Role status – “Active”, “Deactivated”, or “All status” [E].
  • See the filter selection result [F].
  • Clear all the filters in use [G].
  • Use the up-down arrow buttons next to “Name” and “Status” to order the results alphabetically [H].
  • Confirm the status of the role [I].

9. When the roles and permissions are configured, you can proceed to assign agents to the roles.


Assigning Users to Roles


  1. Click on the Agents tab  [1], select the checkbox of the desired agents, and scroll down to the “Role” section [2].
  2. Choose the role you wish to assign to the user from the drop-down menu [3].
  3. Click Save at the bottom of the page. 
  4. If necessary, repeat the procedure to assign additional users to roles.


Removing Permissions


  1. To remove permissions, click on the more options “...” button of the relevant role [1] and select Edit permissions [2]


  1. Alternatively, you can click on the name of the desired role and select the Permissions tab [3]. Here, you can see the number of applications that are enabled for the role [4], as well as the permissions that are currently active within the application [5] and that you may wish to remove. If you wish to see all the permissions available for the roles, switch the toggle to the “on” position [6]
  2. Select Edit [7]


  1. Scroll down to the desired application and click the expand-collapse arrow button [8]. 
  2. Click on the permission that you wish to remove [9] or click on Deselect all [10] button if you wish to remove all the permissions for the area.  
  3. When finished, click Save [11]

Note: Please be aware that the permissions of the Administrator roles cannot be changed or removed. 


Deactivating Roles


  1. On the “Roles” page, click on the name of the role that you wish to deactivate [1] or click on the more options “...” button of the relevant role [2], followed by Edit details [3].
  2. Once on the “Details” page, click “Edit”. 


  1. When the role’s page is displayed, switch the toggle to its “off” position [4].
  2. Click Save [5] to complete the process.

Note: Please be aware that only the custom roles can be deactivated and that the default roles – Agent, Supervisor, and Administrator – cannot be deactivated. 

All Articles ""
Please sign in to submit a request.