Users can be added individually by following these steps or can be imported in
bulk. When a user is added, they will need to activate their account. The
account activation is done by clicking on the link in the email to complete the
process.

For details about each default user role and how to create custom roles, see
[Default user roles and permissions: Agent, Managers,
Admin](https://docs.cloud.google.com/contact-center/ccai-platform/docs/user-roles-permissions#default-roles)
and [Custom roles \&
permissions](https://docs.cloud.google.com/contact-center/ccai-platform/docs/user-roles-permissions#custom_roles_permissions).

See [Bulk user
management](https://docs.cloud.google.com/contact-center/ccai-platform/docs/bulk-user-management) for details
on adding more than one user at a time.

## Add a user

To add a user, follow these steps:

1. In the CCAI Platform portal, click **Settings \> Users \& Teams** . If
   you don't see the **Settings** menu, click **Menu** . The **Users \& Teams Settings**
   page appears.

2. Click **Add Users** . The **Add User** pane appears.

3. To add user information, open the **User Information** section, and then do
   the following:

   1. In the **Work Email Address** field, enter the email address that the
      agent uses to sign in.

   2. In the **First Name** field, enter the agent's first name.

   3. In the **Last Name** field, enter the agent's last name.

   4. Optional: In the **Aliases** field, enter the agent's alias. For more
      information, see [Agent
      aliases](https://docs.cloud.google.com/contact-center/ccai-platform/docs/agent-alias).

   5. In the **Agent ID** field, enter the agent ID.

   6. In the **Location** list, select the location of the user. This controls
      the default language of the agent adapter.

4. To assign roles to the user, open the **Role** section, and then do the
   following:

   1. Click **Assign role** . The **Assign role** dialog appears.

   2. In the **Select role** list, select a role, and then click **Assign**.

   3. To assign additional roles, repeat the previous step.

   > [!NOTE]
   > **Note:** If you're creating a user for an administrator or manager and you want that user to have access to the agent adapter, assign the agent role in addition to any other roles.

   For more information about roles, see [Custom roles and
   permissions](https://docs.cloud.google.com/contact-center/ccai-platform/docs/user-roles-permissions#custom_roles_permissions).
5. To configure preferences for the user, open the **Preferences** section,
   and then do the following:

   1. Optional: Configure the user's call concurrency or chat concurrency
      settings. Enter the maximum number of calls or chats that the user can
      handle at one time. This setting overrides the general call and chat
      concurrency settings.

   2. Optional: To enable your global phone management settings' international
      calling configuration, click the **International calling** toggle to the
      on position. For more information, see [Phone number
      management](https://docs.cloud.google.com/contact-center/ccai-platform/docs/call-settings#phone-number-management).

   3. Optional: In the **Availability Preference** list, select the availability
      preference for the user.

6. Click **Add**.

### Invitation email

After you click the **Add** button in the create user flow, an email will be
sent to the email address specified with an invite link to activate their
account.

- **Email subject:** Invitation to \<Your Company Name\> Support. The company
  name used here is set in **Settings \> Support center details**.

- **Email body:** You have been invited to join YOUR COMPANY NAME on
  the CCAI Platform.

- **Invite Link:** Takes the user to the CCAI Platform portal sign in page set up
  their password or sign in using SSO if enabled. The link doesn't have a
  defined expiration duration, however, it will be invalidated once it is
  accepted or a new invitation link has been sent.

## View existing users and teams

The user list for any selected team will only display the list of users
that are directly assigned to that team or sub-team. To avoid confusion
and not show an agent or user assigned to a sub-team multiple times in any
higher-level teams, users only show in the team they are directly
assigned to.

Example:

- Parent team A (450 users) - all 450 agents are assigned to sub-teams, none are
  directly assigned to team A - user list will show: **0 users**

  - Team A-1 (200 users) - user list will show: **200 users**

  - Team A-2 (150 users) - user list will show: **150 users**

  - Team A-3 (100 users) - user list will show: **0 users**

  - Team A-3.1 (90 users) - user list will show: **90 users**

  - Team A-3.2 (10 users) - user list will show: **10 users**

The **filter** drop-down can be used to restrict the users that are displayed.
Filter options include:

- Unactivated users.

- Unassigned agents.

## Edit a user

Edit a user only when that user isn't signed in. Otherwise, your edits might not
be saved.

To edit a user, follow these steps:

1. In the CCAI Platform portal, click **Settings \> Users \& Teams** . If
   you don't see the **Settings** menu, click **Menu** . The **Users \& Teams Settings**
   page appears.

2. For the user that you want to edit, click , and then click **Edit user** . The **Edit User** pane
   appears.

3. Edit the user's information, and then click **Update**.

## Remove a user from teams

In the **Edit User** pane, you can remove them from one or more teams either one
at a time or all at once.

### Remove a user from a single team

To remove a user from a specific team, follow these steps:

1. In the CCAI Platform portal, click **Settings \> Users \& Teams** . If
   you don't see the **Settings** menu, click **Menu** . The **Users \& Teams Settings**
   page appears.

2. For the user that you want to edit, click , and then click **Edit user** . The **Edit User** pane
   appears.

3. Open the **Teams** section.

4. Find the row for the team that you want to remove.

5. Click the **X** at the right of that row.

6. Repeat for any other teams that you want to remove.

7. Click **Update** to save your changes.

### Remove a user from all teams at once

Use the **Remove from all teams** button to clear every team assigned to a user
in a single step, instead of removing each team one at a time.

To remove a user from all teams at once, follow these steps:

1. In the CCAI Platform portal, click **Settings \> Users \& Teams** . If
   you don't see the **Settings** menu, click **Menu** . The **Users \& Teams Settings**
   page appears.

2. For the user that you want to edit, click , and then click **Edit user** . The **Edit User** pane
   appears.

3. Open the **Teams** section.

4. Click **Remove from all teams**, located directly below the teams table. All
   teams are immediately cleared from the list. There is no confirmation
   dialog.

5. Click **Update** to save your changes.

Clicking **Remove from all teams** only clears the list on the screen. It
does not delete the user's team assignments right away. The removal is saved
only when you click **Update** . If you close the form or refresh the page before
clicking **Update**, none of the teams are removed and the user's original team
assignments remain in place.

> [!IMPORTANT]
> **Important:** The **Remove from all teams** button only appears when the user is assigned to at least one team. If the user has no teams assigned, the **Teams** section shows "No teams assigned" and the button is not displayed. The button is also not available when viewing a user's teams in read-only (view) mode, since that view has no **Update** button to save the change.