Users
Users are the people who access your Ensoras project. Each user is assigned a role that determines exactly what they can see and do.
Navigate to Project > Users in your project sidebar.
Inviting a User
- Click Invite User
- Enter the person's Email Address
- Select a Role from your project's available roles
- Click Send Invitation
An invitation email is sent to the address. If the email matches an existing Ensoras account, the user is added to your project when they accept. Otherwise, a new account is created for them and they complete setup through the invitation link.
Managing Users
The Users table shows each team member with their name, avatar, and role badge. You can:
- Edit a user's role by clicking on their row and selecting a different role
- Remove a user from the project using the "Remove from project" button on their edit page
You cannot change the Owner's role, and you cannot remove yourself from the project.
Roles & Permissions
Ensoras uses a granular permission system that lets you create custom roles with fine-tuned access control. Instead of fixed "Admin" and "Member" roles, you define exactly what each role can and cannot do.
Navigate to Project > Roles in your project sidebar.
Owner Role
The project creator is automatically the Owner. The Owner always has full access to everything and cannot be restricted. This role is not editable and does not appear in the Roles list.
Custom Roles
You can create as many custom roles as you need. Each role is a named set of permissions.
Creating a Role
- Click New Role
- Enter a Role Name (e.g., "Support Agent", "Team Lead", "Viewer")
- Expand each permission group and check the permissions this role should have
- Save
Permission Groups
Permissions are organized into collapsible groups. Each group has a base permission (typically "List" or "View") that acts as a prerequisite — if you uncheck it, all other permissions in that group are automatically removed.
| Group | Available Permissions |
|---|---|
| Dashboard | View |
| Inbox | View, Bulk Approve, Bulk Close |
| Active Chats | View |
| Tickets | List, View, Respond, Approve, Reject, Close, Assign, Change Priority, Regenerate |
| Users | List, Invite, Update, Remove |
| Teams | List, Create, Update, Delete |
| Roles | List, Create, Update, Delete |
| Workflows | List, Create, Update, Delete |
| Tools | List, Create, Update, Delete, Test |
| Actions | List, Create, Update, Delete |
| Knowledge Base | List, Create, Update, Delete |
| Tags | List, Create, Update, Delete |
| Email Rules | List, Create, Update, Delete |
| Macros | List, Create, Update, Delete |
| Project Settings | View, Update, Manage Channels, Manage Integrations |
| Billing | View, Manage |
| API Keys | List, Create, Delete |
Use the Select All / Deselect All toggle at the top of each group to quickly enable or disable all permissions in that group.
Example Roles
Here are some common role configurations to get started:
| Role | Recommended Permissions |
|---|---|
| Support Agent | Dashboard (View), Inbox (View), Tickets (List, View, Respond, Close), Knowledge Base (List), Tags (List), Macros (List) |
| Team Lead | Everything a Support Agent has, plus Tickets (Approve, Reject, Assign, Change Priority), Users (List), Teams (List) |
| Admin | All permissions except Billing (Manage) and Roles (Create, Update, Delete) |
| Viewer | Dashboard (View), Inbox (View), Tickets (List, View) |
Editing a Role
- Click on a role in the Roles list
- Modify the role name or permissions
- Save
Changes take effect immediately for all users assigned to that role.
Deleting a Role
You can delete a role from the edit page. A role cannot be deleted if users are still assigned to it — reassign those users to a different role first.
How Permissions Work
- Navigation visibility — Users only see sidebar items they have permission to access. If a user lacks the "List" permission for Workflows, the Workflows menu item is hidden.
- Page access — Attempting to visit a page without permission redirects the user to their first accessible page.
- Action gating — Individual actions like "Send Reply", "Close Ticket", or "Delete Workflow" are gated by their specific permissions. A user can view a ticket without being able to respond to it.
- Per-project scoping — A user can have different roles in different projects. Permissions are always scoped to the current project.
Teams
Teams let you group users together for ticket routing and assignment. When a ticket is assigned to a team, any member of that team can handle it.
Navigate to Project > Teams in your project sidebar.
Creating a Team
- Click New Team
- Enter a Team Name (e.g., "Billing Support")
- Optionally add a Description
- Toggle Active on
- Select Team Members from your project's users
- Save
Using Teams
Teams are used in several ways:
Ticket Assignment — In the ticket view, you can assign tickets to a team instead of an individual. Any team member can then pick up the ticket.
Workflow Actions — The "Assign Team" action automatically routes tickets to a team when a workflow triggers.
Inbox Filtering — Filter the Inbox by team to see only tickets assigned to a specific team.
Example Team Structure
| Team | Members | Handles |
|---|---|---|
| General Support | All agents | Default incoming tickets |
| Billing | Finance team members | Payment and billing issues |
| Technical Support | Tech-savvy agents | Product issues and troubleshooting |
| VIP | Senior agents | High-value customer requests |
Best Practices
Create roles that match your team structure — Define roles based on actual job functions. A "Support Agent" role that only has ticket-handling permissions keeps your workspace secure without slowing anyone down.
Start with fewer permissions and add more — It's easier to grant additional access than to realize someone had access they shouldn't have. Begin with minimal permissions and expand as needed.
Use Workflows for Routing — Instead of manually assigning tickets to teams, create workflows with Assign Team actions to automate routing based on the conversation topic.
Balance Team Sizes — Distribute team members so no single team is overloaded. Monitor the Dashboard to see ticket distribution across teams.
Review roles periodically — As your team grows and Ensoras adds new features, revisit your roles to make sure permissions are still appropriate.
Next, learn about Billing & Usage.