# Manage users and roles

> Invite colleagues to qutee, understand the roles, limit which agents people see and remove access again.

Source: https://docs.qutee.ai/en/einstellungen/benutzer-und-rollen/

Under **Users** you invite colleagues, decide which agents they see and remove access that's no longer needed. This page also explains what each of the two roles can see and do.

## Who can do this

Only people with the **Company Admin** role see the **Users** area. With the **User** role, the item is missing from the navigation.

## The roles at a glance

| | **Company Admin** | **User** |
| --- | --- | --- |
| For whom | People who set up qutee and are responsible for it | People who handle calls |
| **Overview** and **Calls** | Yes | Yes |
| **My details** (own profile, password, two-factor authentication) | Yes | Yes |
| Set up **Agents** | Yes | No |
| Invite and manage **Users** | Yes | No |
| **Campaigns** | Yes, depending on your plan | No |
| Under **Manage account**: **My tags**, **My CRM files**, **Customer settings**, **Email templates**, **Billing** | Yes | No |
| **Integrations** | Yes, depending on your plan | No |

Both roles only see the calls of the agents that are visible to them (see the next section). Features such as assigning calls or adding several comments per call are available depending on your plan. If a feature isn't enabled, the app shows a lock and a note such as "Upgrade to …". To enable it, write to [hey@qutee.ai](mailto:hey@qutee.ai).

There is also the **Partner Admin** role for qutee partners who look after several companies. It is assigned by qutee or a partner and can't be chosen in your role selection.

## Visible agents

For each person, you can set which agents they see in the field **Agents visible to the user**. This affects the call list: someone who only sees one location's agent also only sees that agent's calls.

- If the field is empty, the person sees all agents.
- Making no agent visible isn't possible at the moment. If someone no longer needs any access, delete their user.

## Invite colleagues

1. Open **Users**.
2. Click **Create new user**.
3. Optional: Under **Agents visible to the user**, select the agents the person should see.
4. Enter the person's email address under **Email\***.
5. Optional: Tick **Email variable** if the person may sign up with a different email address. Without the tick, the address is fixed.
6. Under **Role\***, choose either **User** or **Company Admin**.
7. Click **New link**. The app shows "Invitation created successfully!" and the invite link.
8. Click **Copy link**.
9. Send the link to the person, for example by email.

> **Note:** qutee doesn't send the invitation itself. The person can only create their account once you pass on the link. The link is valid for 30 days.

What happens next for the invited person is described in [Accept an invitation and sign in](https://docs.qutee.ai/en/erste-schritte/einladung-annehmen/). You can send them that page too.

## Statuses in the list

| Status | Meaning |
| --- | --- |
| **Pending invite** | The invitation has been created but not yet accepted. Next to it you see when it expires. |
| **Expired invite** | The 30 days have passed without the person signing up. |
| **Email not confirmed** | The account has been created, but the email address hasn't been confirmed yet. The person can't sign in yet. |
| **Email confirmed** | The account is fully set up. |

Use **Search users ...** and the **Email status** and **Role** filters to find entries faster in longer lists.

## Resend or revoke an invitation

The icons are in the invited person's row:

- **Copy invite link**: For a pending invitation, copy the link again, for example if the first message got lost.
- **Regenerate invite link**: For an expired invitation, create a new link that's valid for another 30 days. Copy it with **Copy link** and send it again.
- **Revoke invite**: The link stops working and the entry disappears from the list. Confirm with **Revoke invite**.

## Edit a user

1. Click **Edit** in the person's row.
2. In the **Edit user data** window, change the visible agents, **First name\***, **Last name\*** or **Phone number (optional)**.
3. Click **Save**.

To change the role of an existing account, click **Edit** in its row. In the **Edit user data** window, choose the new role under **Role\*** and click **Save**. To change several accounts at once, select them in the list and use **Change role**. As a **Company Admin**, you can switch between the roles of your company; you can't change the role of a **Partner Admin**.

### More actions in the row

- **Set as confirmed**: If a person doesn't receive the confirmation email, you can mark their address as confirmed yourself. Only do this if you're sure the address is correct.
- **Reset authenticator app**: If someone has lost or replaced the smartphone with the authenticator app, this removes the app from their account. The person sets it up again at their next sign-in if your company requires it. See [Set up two-factor authentication](https://docs.qutee.ai/en/einstellungen/zwei-faktor-authentifizierung/).

## Delete a user

1. Click **Delete** in the person's row.
2. Confirm the question "Delete user?" with **Delete**.

The person can no longer sign in after that. This can't be undone. The calls under **Calls** are kept. You can't delete your own account.

If you tick several people in the list, you can use **Confirm email** or **Delete** to handle several entries at once.

## Check that it works

After signing up, the invited person appears in the list with their role and the status **Email confirmed**. Ask them to sign in and check that they see the agents and calls they expect.

## Common problems

**"A user with this email address already exists."**: There is already an account for this address. Check the list. If the person has forgotten their password, they can reset it with **Forgot password**.

**"Error while creating the invitation."**: Check the email address and whether you chose a role. Choose **User** or **Company Admin**.

**The person doesn't see any calls**: Check under **Edit** which agents are visible to them.

## Next steps

- [Accept your invite and sign in](https://docs.qutee.ai/en/erste-schritte/einladung-annehmen/)
- [Set up two-factor authentication](https://docs.qutee.ai/en/einstellungen/zwei-faktor-authentifizierung/)
- [Assign calls and add comments](https://docs.qutee.ai/en/anrufe/anrufe-zuweisen-und-kommentieren/)
