Configuring groups

Configuring groups

Overview

In the User Admin area of the Vonage Contact Center (VCC) Admin Portal, you can configure groups in the account you are logged in to. Groups allow you to organise agents and control their routing settings, presence states, and wrap time limits.

For more information about groups, see User Admin.

Prerequisites

Prerequisite

Detail

Prerequisite

Detail

Manage Routing Settings permission

Required to create or edit a group.

For more information about permissions, see Configuring admin and supervisor feature permissions.

Delete group and skill permission

Required to delete a group. Admin users only.

For more information about permissions, see Configuring admin and supervisor feature permissions.

VCC Admin Portal access

You must be logged in to the VCC Admin Portal to configure groups.

Supervisor group access

Supervisors can only view or edit groups for which they have Read or Write permissions.

Navigating groups

The Groups tab in User Admin supports URL navigation. You can directly navigate to the Groups tab or bookmark your most frequently changing group.

  • To open the Groups tab, use the following pattern: https://***.cc.vonage.com/CallCentre/portal/useradmin/groups where *** represents the subdomain for the region of your VCC account.

  • To open a specific group, add the group's ID at the end of the URL: https://***.cc.vonage.com/CallCentre/portal/useradmin/groups/### where *** represents the subdomain and ### represents the ID of the group.

Creating a new group

Permission required

To create a group, you need the Manage Routing Settings permission. For more information, see Configuring admin and supervisor feature permissions.

To create a new group in the account you are logged in to, perform the following steps:

  1. Navigate to User Admin, then click the Groups tab. For information about accessing User Admin, see Accessing and finding your way around User Admin.

  2. Click Create group in the top right corner.

Unavailable button

If the Create group button is unavailable, you do not have permission to create a new group.

  1. A new group form appears. Provide the following information:

Details

Field

Description

Mandatory

Field

Description

Mandatory

ID

A unique identifier automatically assigned to the group.

-

Name

The display name for the group.

Yes

Maximum time in unexpected state

The maximum time (in seconds) an agent in this group can remain in an unexpected state before an alert is triggered.

No

Maximum time in wrap state

The maximum time (in seconds) an agent in this group can remain in a wrap state.

No

New group.png

Presence states

Presence state selection summary

The number shown next to the Presence states drop-down indicates how many states are selected. For example, (13/14) means 13 of 14 states are selected. If all states are selected, (all) is displayed.

Field

Description

Field

Description

Presence state

The name of the presence state. Select the checkbox next to each state to make it available to agents in this group.

For configuration steps, see Configuring group-based agent states later on this page.

Category

The category the presence state belongs to (for example, Ready, Away, Wrap Up).

New presence states

When a new presence state is added in Account Settings > Configuration (legacy) > Agent States, it is automatically disabled for all groups within the account. You must manually enable it for each group as required.

For more information about agent states, see Configuring agent states.

Presence State.png

Users

Field

Description

Field

Description

Select users to add to group

Search for and select the users you want to add to this group.

Users.png
  1. If you leave a mandatory field empty or enter an invalid value, an error message appears. The number of errors appears alongside Create. You cannot click Create until you have corrected all errors.

  2. When you have provided valid information in all mandatory fields, click Create.

Automatic write access

After creating a new group, you are automatically granted write access to it as an admin or supervisor user.

Alternatively, click Cancel to cancel creating the group.

Viewing an existing group's details

Go to the Groups tab in User Admin to see a list of groups in the account you are logged in to. From this list you can see each group's name and ID. The number of users in the group also appears, displayed as Users (12).

  • The icon on the right indicates whether you can edit (pencil icon) or view (eye icon) a listed group.

  • As an admin user, you can see and edit all groups in the VCC account.

  • As a supervisor user, you can see or edit only those groups for which you have Read or Write permissions. You will not see groups for which you do not have permission.

For information about supervisor user permissions, see Supervisor permissions in User Admin.

Editing an existing group

Permission required

To edit a group, you need the Manage Routing Settings permission. For more information, see Configuring admin and supervisor feature permissions.

To edit an existing group in the account you are logged in to, perform the following steps:

  1. Navigate to User Admin, then click the Groups tab. For information about accessing User Admin, see Accessing and finding your way around User Admin.

  2. Locate the group you want to edit using search or by scrolling the list.

  3. Click on the group you want to edit. The group's details appear across three sections: Details, Presence states, and Users.

  4. Update the information in the fields as required. Refer to the field descriptions in Creating a new group, located earlier on this page, for guidance.

  5. If you leave a mandatory field empty or enter an invalid value, an error message appears. The number of errors appears alongside Save. You cannot click Save until you have corrected all errors.

  6. When you have finished making changes, click Save.

Alternatively, click Cancel to undo all your changes.

Adding a user to a group

You can add one or more users while creating or editing a group as described above.

You can also add users to a group in the following ways:

Removing a user from a group

Permission required

To remove a user from a group, you need the Manage Routing Settings permission. For more information, see Configuring admin and supervisor feature permissions.

To remove one or more users from a group, perform the following steps:

  1. Navigate to User Admin, then click the Groups tab.

  2. Locate the group you want to edit using search or by scrolling the list.

  3. Click on the group. The group's details appear.

  4. In the Users section, click the minus icon (-) next to the name of the user you want to remove.

    • Click Clear all to remove all users from the group at once.

  5. Click Save to save your changes.

Configuring group-based agent states

Group-based agent states allow you to control which presence states are available to agents based on the group they belong to. You can configure this in User Admin > Groups.

Group-based agent states are supported in both ContactPad and Intelligent Workspace.

Account-level defaults

Account-level presence states are automatically enabled for newly created groups. When a presence state is deleted from Account Settings > Configuration (legacy) > Agent States, all related group configurations are also removed.

To configure group-based agent states, perform the following steps:

  1. Log in to the VCC Admin Portal.

  2. Navigate to User Admin.

  3. Click the Groups tab.

  4. Locate and select the group you want to configure from the list.

Multiple groups

If an agent belongs to more than one group, they inherit the union of all presence states enabled across those groups.

  1. Click the Presence states drop-down to expand it.

  2. Select the checkbox next to each presence state that agents in this group should be able to view and use in their ContactPad or Agent Workspace.

Default states

Ready and Logged out are always included for all groups and cannot be deselected. These states appear greyed out in the UI.

  1. Click Save.

Sorting and filtering

You can sort the Presence state and Category columns using the column arrows. Use the filter icon next to Category to filter the states displayed in the table.

Presence states table

The following table describes the columns available in the Presence states section:

Column

Description

Sort order

Column

Description

Sort order

Presence state

The name of the presence state.

Ascending: A–Z / Descending: Z–A

Category

The category the state belongs to.

Ascending: Wrap Up → Ready → Away → Extended Away → Ready (Offline) → Logged out / Descending: reverse of above

Supervisors and Team Monitoring

Supervisors can set presence states for agents from Team Monitoring dashboards, including states the agent cannot set themselves.

For more information about agent states, see Configuring agent states.

Deleting an existing group

Permission required

To delete a group, you need the Delete group and skill permission. Only admin users can delete groups. For more information, see Configuring admin and supervisor feature permissions.

To delete a group in the account you are logged in to, perform the following steps:

  1. Navigate to User Admin, then click the Groups tab.

  2. Locate the group you want to delete using search or by scrolling the list.

  3. Click the group. The group's details appear.

  4. Click Delete group. A confirmation dialog box appears.

  5. Click Delete to confirm.

Alternatively, click Cancel to cancel deleting the group.

Deleting a group

When you delete a group, all related presence state configurations for that group are also permanently removed.

Support and documentation feedback

For general assistance, please contact Customer Support.

For help using this documentation, please send an email to docs_feedback@vonage.com. We're happy to hear from you. Your contribution helps everyone at Vonage! Please include the name of the page in your email.