# Creating and Managing Roles

## Interactive Guide

{% embed url="<https://app.arcade.software/share/SbtTSJrbTAm3jlCF6btF>" %}

***

### What is Roles?

The Roles section allows administrators to create custom permission sets that define what team members can view, modify, or delete across different areas of the BotPenguin platform.

This helps enforce access control, strengthen data security, and maintain workflow governance within your organization.

By using roles effectively, you can ensure that every team member only accesses what is necessary for their responsibilities.

**Navigation -** More > User & Teams > Roles

***

### Benefits of Roles

* 🔐 Granular access control based on hierarchy or function.
* 🛡️ Enhanced security by restricting sensitive actions.
* ⚙️ Modular permission assignment (Read, Write, Delete).
* 🎯 Structured operational governance.
* 👥 Scalable permission management for growing teams.

***

## Guidance Video

{% embed url="<https://youtu.be/ohwk2rEms6g?feature=shared>" %}

***

## How to use the Roles Section?

#### View Existing Roles

1. Go to the “More” section from the left sidebar.
2. Click on “User & Teams”.
3. Navigate to the “Roles” tab.
4. Here you can view:
   * Role Name
   * Description
   * Status (Active/Inactive)
   * Actions (Edit/Delete)

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2F488dpluLqHKj6c1csv0o%2Fimage.png?alt=media&#x26;token=27343c13-5e7c-4509-8b74-d2503ff61846" alt=""><figcaption></figcaption></figure>

#### Create a New Role

1. Inside the Roles tab, click on the Create Role button.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FBIY5jM2im2YdkSj4PTEI%2Fimage.png?alt=media&#x26;token=9f8b590e-a481-42bc-97e8-986f74efc995" alt=""><figcaption></figcaption></figure>

2. Add a Name and Description for your role.
3. Assign permissions by selecting the relevant sections.

Permissions include:

* **Read** → Allows users to view the selected section.
* **Write** → Allows users to modify content in the selected section.
* **Delete** → Allows users to delete items within the selected section.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FRznoXEsEmF0VmtSpvK9N%2Fimage.png?alt=media&#x26;token=9939cb7b-269e-46e0-b39b-c2579f2bbaca" alt=""><figcaption></figcaption></figure>

***

#### Permission Example (Inbox → Chats)

To understand better, here’s how permissions work in **Inbox → Chats**:

* **Read Access**\
  Users can view all chats across chatbots but cannot edit or delete them.
* **Write Access**\
  Users can view and edit chats but cannot delete them.
* **Delete Access**\
  Users can view and delete chats but cannot edit them.

4. After assigning necessary permissions, click on **“Create Role”** at the bottom.

Your role will now be created.

***

#### Edit a Role

1. Go to the “Roles” tab.
2. Locate the role you want to update.
3. Click on the Edit icon under the “Action” column.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FhfxK3iOJu7K3UZOPw7wi%2Fimage.png?alt=media&#x26;token=cf647f7f-2cd0-4ebb-baa8-8072839fbe22" alt=""><figcaption></figcaption></figure>

4. Modify permissions, name, or description.
5. Click on **“Save Changes”** to apply updates.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FETSWFlapNyAQpQecBjEI%2Fimage.png?alt=media&#x26;token=4198925f-0573-49ce-bb2a-928ac0b70c63" alt=""><figcaption></figcaption></figure>

#### Delete a Role

1. Navigate to the “Roles” tab.
2. Click on the Delete icon under the “Action” column.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2Fd1BArKLaeabKLZSWXBgk%2Fimage.png?alt=media&#x26;token=418e79ad-73dc-4b5f-8388-a718b0ad033b" alt=""><figcaption></figcaption></figure>

3. Confirm the deletion.

⚠️ Deleting a role may affect members currently assigned to it. Reassign users before deletion if required.

***

#### Role Status (Active/Inactive)

* **Active** → The role can be assigned to team members.
* **Inactive** → The role cannot be assigned but remains stored in the system.

You can toggle the role status from the Roles table.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FcPvHofZ85OsKRxBnH215%2Fimage.png?alt=media&#x26;token=56966451-4fda-4cb9-b26e-f87159528b9d" alt=""><figcaption></figcaption></figure>

***

🎉 Congratulations, you have successfully completed this section!

***

## FAQ's

<details>

<summary>Can I assign multiple roles to a team member?</summary>

No, each team member can be assigned only one role at a time.

</details>

<details>

<summary>What happens if I deactivate a role already assigned to someone?</summary>

That role will become non-functional, and the user will lose access to assigned permissions.

</details>

<details>

<summary>Can I duplicate an existing role to create a similar one?</summary>

Currently, role duplication is not available. You must manually create a new role.

</details>

<details>

<summary>Is there a default admin role?</summary>

Yes, the platform includes a default admin role with full access.

</details>

<details>

<summary>How many roles can I create?</summary>

There is no hard limit — you can create as many roles as needed.

</details>

<details>

<summary>Can I assign roles to myself?</summary>

Yes, users with admin privileges can assign roles to themselves.

</details>

<details>

<summary>Can I track which role a team member is using?</summary>

**Can I track which role a team member is using?**\
Yes, the assigned role is displayed in the team member's profile under the “Teams” section.

</details>

<details>

<summary>Do permissions apply to integrations or just BotPenguin UI?</summary>

Permissions apply only to the in-platform UI and management capabilities.

</details>

<details>

<summary>Can a user with write access delete items?</summary>

No, delete access must be granted explicitly.

</details>

<details>

<summary>Where can I audit role changes?</summary>

Changes to roles are not yet reflected in audit logs but may be included in future updates.

</details>

If everything is correct and you are still unable to move forward, write to us at <support@botpenguin.com>. We will respond back within 48 business hours.
