Creating and Managing Roles

This section contains essential information and usage guidelines for managing roles and permissions inside BotPenguin.

Interactive Guide


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


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)

Create a New Role

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

  1. Add a Name and Description for your role.

  2. 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.


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.

  1. 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.

  1. Modify permissions, name, or description.

  2. Click on β€œSave Changes” to apply updates.

Delete a Role

  1. Navigate to the β€œRoles” tab.

  2. Click on the Delete icon under the β€œAction” column.

  1. 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.


πŸŽ‰ Congratulations, you have successfully completed this section!


FAQ's

chevron-rightCan I assign multiple roles to a team member?hashtag

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

chevron-rightWhat happens if I deactivate a role already assigned to someone?hashtag

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

chevron-rightCan I duplicate an existing role to create a similar one?hashtag

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

chevron-rightIs there a default admin role?hashtag

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

chevron-rightHow many roles can I create?hashtag

There is no hard limit β€” you can create as many roles as needed.

chevron-rightCan I assign roles to myself?hashtag

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

chevron-rightCan I track which role a team member is using?hashtag

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.

chevron-rightDo permissions apply to integrations or just BotPenguin UI?hashtag

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

chevron-rightCan a user with write access delete items?hashtag

No, delete access must be granted explicitly.

chevron-rightWhere can I audit role changes?hashtag

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

If everything is correct and you are still unable to move forward, write to us at [email protected]envelope. We will respond back within 48 business hours.

Last updated

Was this helpful?