Home Features Explained Manage team access control with flexible role-based permissions

Manage team access control with flexible role-based permissions

Last updated on Nov 07, 2025

VowChat's role-based permissions system allows you to create custom roles with specific permissions, giving you fine-grained control over what team members can access and do within your account.

What are Custom Roles?

Custom roles are flexible permission sets that you can create and reuse across your team. Instead of just having "Admin" or "Agent" roles, you can create specialized roles like:

  • Support Specialist: Manage own conversations and contacts only

  • Team Lead: Manage team conversations and view reports

  • Reporting Analyst: View-only access to all reports

  • Knowledge Base Editor: Manage help center content only

  • Full Support Agent: Manage all conversations but not settings

Available Permission Levels

VowChat offers six main permission categories:

1. Manage All Conversations

Full access to view and respond to any conversation in the account, regardless of assignment.

2. Manage Unassigned & Own Conversations

Access to unassigned conversations and conversations assigned to the agent.

3. Manage Participating Conversations

Access only to conversations where the agent is actively participating or assigned.

4. Manage Contacts

Ability to create, edit, and delete contacts in the CRM.

5. Manage Reports

Access to view and generate various reports and analytics.

6. Manage Knowledge Base

Ability to create, edit, and publish help center articles and categories.

How to Create Custom Roles

Step 1. Navigate to Settings → Custom Roles

Step 2. Click Add custom role

Interface for creating a new custom role

Step 3. Fill in the role details:

  • Role Name: Give it a descriptive name (e.g., "Junior Support Agent")

  • Description: Explain the role's purpose and typical use cases

  • Permissions: Select the appropriate permission checkboxes

Step 4. Review the selected permissions

Step 5. Click Create to save the custom role

The new role is now available for assignment to team members.

How to Assign Roles to Teammates

Step 1. Go to Settings → Agents

Agents settings page with edit button

Step 2. Find the teammate you want to assign a role to

Step 3. Click the Edit button (pencil icon) next to their name

Dropdown menu for selecting roles

Step 4. In the edit modal, locate the Role dropdown

Step 5. Select the desired role from the list:

  • Administrator (default)

  • Agent (default)

  • Your custom roles

Step 6. Click Update to save the changes

The teammate's permissions will be updated immediately.

How to Edit Custom Roles

Step 1. Go to Settings → Custom Roles

Step 2. Find the role you want to modify

Step 3. Click Edit next to the role

Step 4. Update the role name, description, or permissions

Step 5. Click Update to save changes

Important: Changes to a role affect all team members currently assigned that role.

How to Delete Custom Roles

Step 1. Go to Settings → Custom Roles

Step 2. Find the role you want to delete

Step 3. Click Delete next to the role

Step 4. Confirm the deletion

Important: You cannot delete a role that is currently assigned to team members. First, reassign those team members to different roles.

Common Custom Role Examples

Junior Support Agent

Permissions:

  • Manage Participating Conversations only

  • View own performance in Reports

Use Case: New team members who need supervision and limited access while learning.

Team Lead

Permissions:

  • Manage All Conversations

  • Manage Contacts

  • Manage Reports

Use Case: Team leaders who need visibility into all team activity and performance metrics.

Content Manager

Permissions:

  • Manage Knowledge Base

  • View Reports (to track article performance)

Use Case: Dedicated help center content creators who don't handle customer conversations.

Quality Analyst

Permissions:

  • View All Conversations (read-only via reporting)

  • Manage Reports

Use Case: QA team members who audit conversations but don't respond to customers.

Senior Support Agent

Permissions:

  • Manage All Conversations

  • Manage Contacts

Use Case: Experienced agents who help across all conversations but don't need admin settings access.

Best Practices

1. Plan Your Roles

  • Identify common permission patterns in your team

  • Create roles based on job functions, not individuals

  • Keep the number of roles manageable (5-10 maximum)

2. Use Descriptive Names

  • Choose clear, self-explanatory role names

  • Include the permission level in the name if helpful

  • Example: "Support Agent - Own Conversations Only"

3. Document Role Purposes

  • Use the description field to explain when to use each role

  • Document role expectations in team onboarding materials

  • Review roles quarterly to ensure they still match needs

4. Follow Least Privilege Principle

  • Give team members only the permissions they need

  • Start with minimal permissions and add as needed

  • Regularly audit role assignments

5. Test Before Deployment

  • Create test roles and verify permissions work as expected

  • Have a team member test the role in a non-production environment

  • Adjust based on feedback before wide deployment

Frequently Asked Questions

Can I modify default Admin and Agent roles?

No, the default Administrator and Agent roles cannot be modified. Create custom roles for specialized permissions.

What happens when I delete a custom role?

You can only delete roles that aren't assigned to anyone. Reassign team members first, then delete the role.

Can one person have multiple roles?

No, each team member can have only one role at a time. The role determines their complete set of permissions.

Do role changes take effect immediately?

Yes, when you update a role or reassign a team member to a different role, the changes are applied immediately.

Can agents see what role they have?

Yes, agents can see their assigned role in their profile settings, but they cannot see detailed permission breakdowns unless they have admin access.