Learning how agent groups and available agents function in MaestroQA can help with also understanding your access within the tool.
This article will introduce you to:
- User Accounts
- Agent Groups
- Role Permissions
Please keep in mind, your access to User Roles within the gearbox may vary depending on your role. This article is primarily geared towards Admins.
The essential features within User Accounts are the following:
- Invite new users
- Change user roles
- Linking Users to Agents/Agent Groups
Within User Accounts, you can manually send invites to invite users to Maestro. Typically we suggest to manually invite Managers, Graders, and Admins via this method.
If you are a Zendesk user, have integrated with Zendesk, and have agent dashboard access, agents can sign in via "Sign in with Zendesk".
Adjusting User Access
Within this tab, you can also change user roles and change user groups.
Here is where you can select what role you want to user to have. The roles available are:
- Limited Agent
Linking agents is primarily used for agents, since they cannot join agent groups.
If the user is an agent, the agent needs to be linked to him/herself in order to view tickets within Maestro (if they have Maestro access).
This refers to providing your managers, graders, and admins access to specific agent groups. Agent Groups determine what tickets users have access to.
Within the Agents tab, you can view:
- Agent Name: The display name for the agent. No special characters allowed when naming your agent.
- Agent ID: If you have successfully integrated with a helpdesk, this will sync with their Agent ID on the helpdesk
- Helpdesk: Displays how the agent joined Maestro or what helpdesk the agent is attached to
- Email: If you are not using a helpdesk, this is used as the identifying factor for agents. You can edit the email as well.
- Available in Maestro: This determines what agents will have their ticket information synced with Maestro. You can manually turn on and off agents at any time.
- Delete: You can only delete agents after you have deactivated them. We advise to not delete agents as deactivating agents will provide the same results, but you can revisit these agents at any moment in time in the future.
You will also see that at the bottom of the page, you can add new agents. If you are integrated with a helpdesk, agents who have answered tickets will be automatically synced with Maestro.
At the moment, it is not possible to bulk add new agents. If you are looking to bulk add agents, please reach out to us!
At the bottom of the agents tab, you will see the following settings pop up:
The key settings to highlight here would be:
- Ability to upload CSV files to make agents available or unavailable. The CSV will just need a single column that is all the Agent IDs or emails for all agents being set to available/unavailable.
- You can also upload a CSV to bulk invite agents to become users on MaestroQA. Same as above, the CSV will need a column that has the Agent IDs or emails for all agents being invited. This is different than the Adding New Agent function from earlier. You will still need to add the agents to Maestro manually if they are not synced with Maestro.
The purpose of Agent Groups is to help organize your agents into separate teams and help provide the proper access to graders, managers, and admins.
You can create as many groups as you like, or if you are integrated with Zendesk, you can import your groups from Zendesk seamlessly.
If you have just started with Maestro, you will notice that you only have one agent group, which is All Agents.
All of your agents will automatically be put into this group when they join Maestro. If you are the primary admin for the account, be sure to associate yourself with this group first.
Every single Agent Group will show you the number of available agents vs total agents. Here you can also check to see what agents your Managers, Graders, and other Admins have access to.
Some things to keep in mind:
- While you can turn off and on all agents in a group, you will have to go to the Agents tab in order to turn individual agents off and on.
- Agent Groups determine your access to specific tickets. If you are unable to find tickets from a particular agent or are unable to see tickets within a ticket review, this may have to do with what Agent Groups you are shared on.
- Agents and Limited Agents only have access to their own tickets. They cannot be given access to other Agent Groups.
- By clicking on the pencil icon, you can also upload a CSV to add agents to a specific agent group.
The Role Permissions tab allows you to customize how specific roles interact with Maestro. The last column serves as a general guide on access to tickets for specific roles. Keep in mind to always double check the user’s actual Agent Group access within the User Roles tab.
To walk through the roles:
- Admin: This user has access to everything on Maestro with no restrictions.
- Grader: This user has the second most access within Maestro. However, unless granted access, Graders cannot edit or create rubrics, agents, agent groups, or see the calibrations report within reporting.
- Managers: Typically handles coaching and reviewing tickets with agents. They have less access than Graders, but can be given the same permissions to act as a Grader.
- Agents: These are your agents who are handling the tickets directly. They only have access to their own tickets and cannot be assigned to an agent group.
- Limited Agents: Limited Agents have an extremely limited view of Maestro. They are restricted to their own tickets, and there is even an option to only allow them to see their own comments rather than see scores.
For the roles mentioned, only Admins, Graders, and Managers will have access to the tool if you are on the Essentials or Team package. If you would like to have agent access to Maestro, you will need to be on the Professional package.