Managing Roles and Permissions

maaiiconnect lets Staff administrators assign different roles for Staff members. Depending on their roles or departments, Staff members will have different data scope, i.e., levels of access to data within your maaiiconnect service account, as well as different permissions when using the maaiiconnect features.

Staff administrators can use the default roles and data scope in maaiiconnect or they can create their own custom roles.

maaiiconnect Roles and Permissions

📘

Note:

Please be aware that you are doing some advanced settings and you understand the risks behind them. Any changes in the settings may affect other Staff members in the Service Account.

Roles and Data Access Level

The following default roles and their corresponding data scope are available in maaiiconnect:

Role

Data Access Level

Administrator

Full

Manager

Department

Leader

Team

Agent

Restricted

The Data Access Level is defined as follows:

  • Full: Staff members can access all account data
  • Department: Staff members can access all data in the Department they belong to and its teams
  • Team: Staff members can access all data in the Team they belong to
  • Restricted: Staff members can only access individual data

Feature Permissions

Depending on their role, Staff members may have any of the following permissions to maaiiconnect features:

  • Enabled: the Staff member can use the feature. This applies mostly to call and chat features in maaiiconnect.
  • View: the Staff member can see or read contents displayed on their Dashboard or App. This applies mostly to reports and campaigns.
  • Edit: the Staff member can modify or overwrite the contents displayed on their Dashboard or App. This applies mostly to campaigns and account and service settings.
  • Download: the Staff member can save an offline copy of the contents displayed on their Dashboard or App. This applies mostly to reports and campaigns.
  • Delete: the Staff member can remove the contents displayed on their Dashboard or App. This applies mostly to campaign account and service settings.
  • Approve: the Staff member can approve or deny a submission or process done by another Staff member. This applies to campaigns only.

Below is a summary of maaiiconnect features available for Staff members and the corresponding permissions according to their roles:

Feature

Administrator

Manager

Leader

Agent

Permission Controls

Permission Settings

Enabled

Administration Permissions

Department

View, Edit, Delete

Widget Appearance

View, Edit, Delete

Widget Installation

View, Edit, Delete

Visitor Forms

View, Edit, Delete

Service Numbers

View, Edit, Delete

Storage

View, Delete

Call Recording Settings

View, Edit

Destination Management

View, Edit, Delete

Directory Management

View, Edit, Delete

Virtual Number Management

View, Edit

Omnichannel Management

View, Edit, Delete

Account Security

View, Edit, Delete

Reporting and Monitoring

Inquiry Report

View, Download

View, Download

View, Download

View, Download

Call Report

View, Download

View, Download

View, Download

View, Download

Chat Report

View, Download

View, Download

View, Download

View, Download

SMS Report

View, Download

View, Download

View, Download

View, Download

Visitor Report

View, Download

View, Download

View, Download

View, Download

Staff Report

View, Download

View, Download

View, Download

View, Download

Conference Report

View, Download

View, Download

View, Download

View, Download

Inquiry Overview

View

View

View

Audit Trail

View, Download

Communication

Internal Call

Enabled

Enabled

Enabled

Enabled

Off-net Call

Enabled

Enabled

Enabled

Enabled

Send SMS

Enabled

Enabled

Enabled

Enabled

Conference Call

Enabled

Enabled

Enabled

Enabled

Video Call and Screen Sharing

Enabled

Enabled

Enabled

Enabled

Call Recording

Enabled

Enabled

Enabled

Enabled

Call Forwarding

View, Edit

Enabled

Enabled

Enabled

Personal Number as Caller ID

View, Edit, Delete

View, Edit, Delete

View, Edit, Delete

View, Edit, Delete

Campaign Permissions

SMS Campaign

View, Edit, Delete, Download, Approve

View, Edit, Delete, Download, Approve

View, Edit, Delete, Download, Approve

View, Edit, Delete, Download

Contact Permissions

Internal Contacts

View, Edit, Delete

View, Edit, Delete

View, Edit, Delete

External Contacts

View, Edit, Delete, Download

View, Edit, Delete, Download

View, Edit, Delete, Download

View, Edit, Delete, Download

Plan

Plan Monitoring

Enabled

Rate Table

Enabled

Creating Custom Roles

Staff administrators can create custom roles based on any of the default roles and data scope available in maaiiconnect to align with their organisation’s requirements.

To create a new custom role:

  • From the navigation menu, go to Administration > Organization > Roles and Permissions.
  • Under Custom Roles, click on the Create Role button at the right side of the page.
  • On the pop-up window that will appear, type in the Role Name for the role you wish to create.
  • On the Data Scope dropdown box, select a default role closest to your requirements.
  • Click on Next.
  • On the Create Role page, scroll down and tick or untick the checkboxes next to the features and permissions. You may use the Quick Access links on the right side of the page to jump to specific sections of the features list.
    • If you wish to undo all your changes in the permissions settings, click on Reset Settings.
    • If you want to edit the Role Name and Data Scope you previously entered, click on Edit under each of these details on the lower-right side of the screen.
  • Click on Create. maaiiconnect will automatically save this new role and will redirect you to the role’s details page where you can edit its Feature Permissions and assign Staff members to it.

Viewing and Editing Roles

To view a Role’s details:

  • From the navigation menu, go to Administration > Organization > Roles and Permissions.
  • Click on any of the listed default roles under Default Roles or on any of the custom roles listed under Custom Roles.

The following information will be displayed on the page that will appear:

  • Feature Permissions
  • Custom Roles

Role details

To edit a Role’s Permissions Settings:

  • From the navigation menu, go to Administration > Organization > Roles and Permissions.
  • Under Custom Roles, click on the custom role you wish to edit or click on the gear icon on the right.
  • On the details page that will appear, under Feature Permissions, click on Edit Permissions.
  • On the page that will appear, scroll down through and tick or untick the checkboxes next to the features and permissions. You may use the Quick Access links on the right side of the page to jump to specific sections of the features list.
    • If you wish to undo all your changes in the permissions settings, click on Reset Settings.
    • If you wish to edit the Role Name and Data Scope, click on Edit under each of these details on the lower-right side of the screen.
  • Click on Save. A pop-up message will appear, asking you to confirm the changes.
  • Enter an optional Change Note, then click on Assign.

📘

Note:

You can only edit the permission settings of custom roles. Default roles available in maaiiconnect cannot be edited.

Deleting Roles

To delete a Role:

  • From the navigation menu, go to Administration > Organization > Roles and Permissions.
  • Under Custom Roles, go to the custom role you wish to delete and click on the trash icon on the right. A pop-up message will appear, asking to confirm the action.
  • Click on Delete. The custom role will be removed from the Role List.

📘

Note:

You can only delete custom roles. Default roles available in maaiiconnect cannot be deleted.

Assigning Roles to New Staff Members

To assign a role to a new Staff member, refer to the Staff Management section of this Guide.

Reassigning Roles to Staff Members

Staff administrators can assign existing Staff members new roles by adding them to a newly-created role or moving them out of an existing one.

To add a Staff Member to a new Role:

  • From the navigation menu, go to Administration > Organization > Roles and Permissions.
  • Click on any of the listed default roles under Default Roles or on any of the custom roles listed under Custom Roles.
  • On the details page that will appear, under Custom Roles, click on Assign Staff Member(s).
  • On the pop-window that will appear, scroll down through or search for the Staff member you wish to add, then tick on the checkbox beside their name.
  • Enter an optional Change Note, then click on Assign. The Staff member will then be added to this new Role and removed from their previous one.

To transfer a Staff Member from an existing Role:

  • From the navigation menu, go to Administration > Organization > Roles and Permissions.
  • Click on any of the listed default roles under Default Roles or on any of the custom roles listed under Custom Roles.
  • On the details page that will appear, under Custom Roles, scroll down through or search for the Staff member(s) you wish to assign to another Role, tick on the checkboxes beside their name(s), then click on Assign Other Role
  • On the pop-window that will appear, on Role Name dropdown box, select the new role you wish to assign to the Staff member(s).
  • Enter an optional Change Note, then click on Assign. The Staff member(s) will then be removed from this current Role and will be added to the new one.

Updated 3 months ago


Managing Roles and Permissions


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.