Skip to content

Users ​

When a new colleague joins the Acme Support team, all you need is their name, their email and a role — they'll be signed in to the Studio within minutes.

The Users page (/users) is your team roster — the people who sign in to the Studio to build agents and handle conversations. From here you invite someone, change their roles, resend an invite, deactivate or reactivate access, reset someone's two-step verification, or remove a member, with guards that stop you from ever locking yourself (or the whole team) out.

Before you start ​

This page is about your team members. The people who chat with your agents are customers and appear under Engage → Customers. Roles are defined on the Roles page; this page assigns them to people.

You need admin access to see or manage Users. Without it you see an "insufficient permissions" message instead of the roster.

PageRouteWhat you do there
Users (this page)/usersInvite, re-role, resend invites, deactivate, reactivate, reset two-step verification and delete team members
Roles/rolesDefine the permission sets you assign here

The roster ​

Go to Admin → Users. The header shows how many team members you have, a Search users... box and an Invite User button. Each member appears as a card.

Admin → Users — the team roster

Each card shows:

  • Initials avatar, tinted by the member's main role.
  • Name and one badge per role (a member with no role shows a grey No role badge).
  • Email.
  • Status — a coloured dot and label (see below).
  • Last active — a relative time such as "25m ago" or "15h ago", or a date. For someone who has never signed in, it shows when the account was created.
  • For invited members, Invite sent N× · date — how many invites you've sent and when the last one went out.
  • Actions on the right: Edit, and — depending on the member's status — resend invite, deactivate / reactivate, Reset two-step verification (lock icon) and delete icons.

Status ​

StatusDotMeaning
ActivegreenSigned in and holding roles
InvitedamberInvite sent; not signed in yet
InactivegreyDeactivated — no access

The search box filters the roster as you type, matching any part of a member's name or email (case-insensitive) — "asha" or "@acme" both work.

SituationWhat you see
No team members yetNo team members yet, with an Invite User button
Nothing matchesNo users match your search — No results for "…"

If you arrive from a link that filters by role (for example from an app's access settings), the roster shows only that role's members and a Role: … ✕ chip appears next to the member count — click it to clear the filter.

Inviting a user ​

Click Invite User and fill in Full Name, Email and at least one role. Send Invite stays disabled until all three are set.

The Invite User dialog with two roles selected and the effective-access summary

When you send the invite, Perfox creates the account (with no password for the invitee to set), assigns the roles, marks the member Invited, and emails them a sign-in link. Opening it shows a "Finish signing in" page — clicking Continue completes the sign-in; this extra click stops email security scanners from using the link before the invitee does. The first time they sign in, they're also asked to accept the Terms of Service and Privacy Policy. After that they land on a welcome page with your workspace name. If the link has already been used or has expired, the page explains why and offers to send a fresh one, or you can resend it from here.

A confirmation appears — "Invite sent to … They'll receive an email with a link to join." — and the new member shows up in the roster with an amber Invited status, which flips to Active on their first sign-in. If something goes wrong, the error appears inside the dialog so you don't lose what you typed.

Credits required

Adding a teammate uses credits. If your balance is zero, the invite is refused and the Add credits pop-up opens. Every new workspace starts with 100 free credits — see Accounts & Billing.

Resending an invite ​

Invited members have a resend invite (envelope) icon that emails a fresh sign-in link ("New invite link sent to …"). On an Inactive member, the same icon reactivates them — restoring their previous roles — and emails a fresh sign-in link.

Worked example — inviting Asha

Setup: Asha is joining Acme Support as a team lead. She needs to build and publish agents and handle conversations.

Action: Click Invite User, enter her name and work email, and tick Workflow Builder and Support Agent. The Effective access panel shows Build, Connect and Engage as Full access. Click Send Invite.

Result: Asha receives an email with a sign-in link, clicks it, confirms on the "Finish signing in" page, and lands in the Studio. Her card shows an Active status with Workflow Builder and Support Agent badges.

Editing a user's roles ​

Click Edit on a card to open Edit User with the member's current roles ticked. Change the selection and save. The dialog holds roles only — a person's contact-center skills, languages, chats at once and wrap-up time are set on each agent's Operator node (see Contact Center setup).

Saving replaces the member's whole role set at once, and the change applies on their next request — no sign-out needed. Clearing every role removes all their permissions.

Your own card

You can edit your own roles, but the deactivate, reset two-step verification and delete icons are hidden on your own card so you can't lock yourself out by accident.

The role picker ​

The Invite and Edit dialogs share the same role list — each role's name and description, with a checkbox.

  • A member can hold several roles; their permissions are everything those roles grant combined.
  • A role with full access (such as Admin) carries a Full access badge. Ticking it marks the other roles Included — they're covered already, so they're shown ticked and greyed out. Unticking the full-access role restores your earlier picks.
  • The Effective access panel underneath summarises what the selection actually grants, section by section (Full access, the specific permissions, or Not granted). With nothing selected it reads "No access — select at least one role."

Deactivate, reactivate, delete ​

ActionShown forReversible?What happens
DeactivateActive and invited membersYesThey lose all access immediately and are signed out everywhere. Their roles are set aside and restored if you reactivate.
ReactivateInactive members—Restores their previous roles and sets them Active.
DeleteAny member except yourselfNoPermanently removes the account and signs them out. The same email can be invited again later.

Each action asks for confirmation first; Delete uses a red confirmation button.

Safety guards ​

Two guards stop your workspace from locking itself out. They are enforced on the server, whichever way the request arrives.

  • Not yourself — you can't deactivate or delete your own account.
  • Not the last admin — you can't deactivate or delete the last active member with admin access. You'll see: "Cannot remove the last administrator — assign the Admin role to another user first."

Built-in roles ​

Four built-in roles are always available:

RoleAccess
AdminFull access to everything
Workflow BuilderBuild and publish agents, manage MCP servers and the knowledge base, read conversations
AnalystRead-only access to analytics, conversations and customers
Support AgentHandle conversations and manage customers

You can also create your own roles on the Roles page.

Two-step verification ​

Any team member can add a second step to their sign-in with an authenticator app (Google Authenticator, Microsoft Authenticator, 1Password, Authy and similar). It's optional and each person turns it on for themselves.

  1. Open the account menu (your avatar, top right). Two-step verification shows Off. Click it.
  2. Click Set up authenticator and scan the QR code with your app. (On your phone already? Use Open in your authenticator app. Can't scan? Choose Enter a setup key instead.)
  3. Save the 10 backup codes shown. Each works once if you lose your phone, and they're shown only this one time.
  4. Enter the 6-digit code from your app to finish. You're emailed to confirm it's on, and the menu now shows On.

From then on, after signing in you're asked for a code from your app before the Studio opens. A verification lasts 12 hours, then you're asked again, however active you've been. Lost your phone? Choose Lost your phone? Use a backup code on that screen. Until you enter a code, your session can't open pages, connect an MCP client or open an app.

There is no switch to turn it off yourself. To replace a lost authenticator, ask an admin to reset it (below).

Resetting someone's two-step verification ​

Click the lock icon (Reset two-step verification) on a member's card. A reset is never done by one person alone:

  1. Confirm Ask for reset. Nothing changes yet, and the member is emailed that a reset was asked for.
  2. The request appears at the top of the page under Two-step verification resets waiting for approval. A second admin of your workspace clicks Approve (or Reject) within 24 hours. You can Cancel your own request; a request about you is decided by another admin.
  3. Once approved, the member's authenticator stops working, they're signed out and emailed, and they set up a new one the next time they sign in if their account requires it.

If your workspace has no other admin to approve, the request goes to Perfox support instead ("Reset requested. Perfox support … must approve it.") and the row shows Waiting for Perfox support. A request that isn't decided within 24 hours expires.

Sign-in and sessions ​

Sign-in is passwordless. Team members sign in with a one-time link emailed to them (the same kind of link as the invite) or, if you've set it up in Settings → Authentication, with your company's Single Sign-On. Password sign-in isn't available.

Single Sign-On doesn't create accounts — invite people here first. Each person then connects SSO to their own account once, from Connect single sign-on in the account menu, after signing in with their emailed link. See How each person starts using SSO.

Sessions last 30 days and renew while you keep using the Studio. Permissions are checked on every request, so role changes take effect straight away.

See Authentication for the full sign-in model.

Where to go next ​

  • Roles — define the permission sets you assign here
  • Accounts & Billing — your credit balance (inviting a teammate uses credits)
  • Settings — sign-in methods, including Single Sign-On
  • Customers — the people who chat with your agents