13.1 Overview

AIUNIFY Assistant contains two separate user-management concepts:

Platform User Management
Create accounts, assign roles and plans,
activate or deactivate users

Team-Sharing Configuration
Store selected Lead Tags, AI Agents,
and Campaigns as shared resources

However, the current source shows that the team-sharing interface is not fully connected to the application’s resource-access rules.

The application stores these sharing fields on a User record:

sharedTags
sharedAgents
sharedCampaigns

An administrator-facing Users page can select and display these values. However, the current Leads, AI Agents, and Campaigns routes continue to grant access primarily according to resource ownership rather than those sharing fields. Shared Access should therefore be treated as an unfinished or partially implemented feature in the current build.

Understanding the Current User Structure

13.2 Individual User Accounts

Each person accessing AIUNIFY Assistant should have an individual account containing:

Name
Email address
Password or Google account
Role
Plan
Plan status
Account status
Personal Settings
Owned resources

Resources are generally connected to the account that created them.

13.3 No Confirmed Organization or Team Container

The reviewed source does not contain a separate organization or team model connecting:

Business Owner
Team
Team Members
Shared subscription and resources

Instead, each account exists as an independent platform User.

The current system does not clearly store:

Parent account
Organization ID
Team owner
Department
Manager
Membership invitation
Team subscription

13.4 Platform Users Versus Team Members

The application’s primary backend User roles are:

admin
user

The backend User model does not include a stored member role.

This differs from the unfinished Team Users interface, which presents:

Admin
Member

as its visible choices.

Current Navigation

13.5 Main Sidebar

The normal Sidebar contains:

Dashboard
Leads
Phone Numbers
SIP Trunks
AI Agents
Knowledge Base
Campaigns
Call Logs
Appointments
Support
Settings

Administrators additionally see:

Admin

The current Sidebar does not contain a normal:

Users
Team
Members
Shared Resources

menu item.

13.6 Admin Navigation

The Admin link appears only when the locally stored user record identifies the person as:

role = admin

or:

isSuperAdmin = true

Normal users do not see the Admin link.

13.7 Protected Admin Routes

Routes beginning with:

/admin

are protected in the frontend.

A user who is not an Administrator or Super Administrator is redirected to the Dashboard.

The backend also protects administrative actions and returns:

Access denied. Admin only.

when an unauthorized account attempts to use them.

13.8 Separate Users Page

The source contains a separate page at:

/users

with the heading:

Users

and description:

Manage system users (Admin only)

However, this page is not linked from the current Sidebar or Admin navigation.

It should be treated as a legacy, unfinished, or development-stage interface rather than a dependable production Team page.

Roles

13.9 User Role

A standard account has:

role: user

A User can operate the ordinary customer sections available through the Sidebar but cannot use administrator-protected backend routes.

13.10 Administrator Role

An Administrator has:

role: admin

The Administrator passes the backend Admin check and can access the Admin area.

This includes powerful platform-level capabilities such as:

Listing users
Creating users
Changing user plans
Activating users
Deactivating users
Managing plans
Reviewing purchases
Reviewing administrative analytics
Managing platform settings
Managing support tickets

13.11 Super Administrator

Super Administrator status is stored separately:

isSuperAdmin: true

It is not a third value inside the primary role field.

A Super Administrator normally also has:

role: admin

13.12 First Registered User

The public registration process checks the total number of User records.

When the database contains no users, the first registered account receives:

role: admin
isSuperAdmin: true

Later public registrations receive:

role: user
isSuperAdmin: false

The submitted role is not used to override this first-user rule.

13.13 Super Administrator Cannot Be Selected Normally

The normal administrative Add User form allows:

User
Admin

It does not provide:

Super Admin

as a selectable role.

A normal administrator should not assume that creating another Admin also makes that person a Super Administrator.

13.14 Administrator Versus Super Administrator

Both an Administrator and Super Administrator pass the general Admin middleware.

However, several operational routes treat Super Administrators differently.

Examples include broader visibility into resources that normal accounts see only by ownership.

An ordinary Administrator should not be assumed to have the same global operational-resource access as the Super Administrator.

Backend Role Enforcement

13.15 Administrative Access Check

The backend authorizes Admin operations when:

User role is admin
OR
isSuperAdmin is true

Otherwise, access is rejected.

This backend check is more authoritative than whether a link happens to appear in the browser.

13.16 Frontend Visibility Is Not Security

Hiding an Admin link does not itself secure the application.

AIUNIFY Assistant also validates administrative permission on protected backend requests.

This prevents a normal user from obtaining administrator data merely by manually entering an Admin API address.

13.17 Cached Role Information

The Sidebar and frontend route checks read User information stored in the browser.

When a role changes, the browser may temporarily contain an older role value.

After changing a user’s role or status, the affected person should:

  1. Sign out.
  2. Close unnecessary AIUNIFY Assistant tabs.
  3. Sign in again.
  4. Confirm the correct navigation appears.

The backend uses the current database User during authentication, but the browser interface can remain visually stale until its locally stored User information is refreshed.

Admin User Management

13.18 Opening User Management

For an Administrator:

  1. Sign in.
  2. Select Admin.
  3. Confirm User Management appears.
  4. Review the User table.
  5. Search by Name or Email where necessary.

The Admin page describes its function as:

Manage all users and their plans across the SaaS platform.

This is global platform User Management, not a business-specific team list.

13.19 User Management Columns

The Admin User table contains:

User
Role
Plan
Status
Joined
Actions

13.20 User Column

The User column displays:

Name
Email address
Initial avatar

13.21 Role Column

The Role column displays:

user
admin

A Super Administrator receives a distinct:

Super Admin

badge.

13.22 Plan Column

The Plan column displays the User’s assigned Plan.

When no Plan is populated, the interface displays:

Free Trial

13.23 Status Column

The Status column can display:

active
trialing
inactive
canceled
Deactivated

A red status indicates that the account itself has been deactivated.

Plan status and account activation are separate conditions.

13.24 Joined Column

Joined displays the date the User record was created.

It does not represent:

Last login
Last activity
Plan start
Most recent call

Searching Users

13.25 Search Box

The Admin page includes:

Search users by name or email...

The search is applied to the currently loaded User list.

13.26 Name Search

The search compares the entered text with the User’s Name without case sensitivity.

13.27 Email Search

The same search field compares the entered text with the User’s Email Address.

13.28 No Role or Plan Filter

The current User Management page does not provide separate filters for:

Role
Plan
Status
Join date

Use the Name or Email search and review the table columns.

Adding a User Through Admin

13.29 Add User

Select:

Add User

to open:

Add New User

The form explains:

Create a new user account within the platform.

13.30 Add User Fields

The form contains:

Full Name
Email Address
Password
Role
Plan

13.31 Full Name

Enter the individual’s actual business name.

Recommended:

Danielle Carter
Marcus Hill
Alicia Thompson

Avoid:

Sales User
Employee 1
Team Login
Shared Account

13.32 Email Address

Each User must have a unique Email Address.

The backend returns:

User already exists

when the address is already registered.

13.33 Initial Password

The Admin form requires an initial Password.

The placeholder recommends:

Minimum 8 characters

The Administrator should transmit the initial credentials securely.

13.34 No Invitation Email

The current Add User route directly creates an account.

It does not show an automated:

Invitation email
Set-your-password link
Email-verification link
Account-acceptance workflow

The Administrator is responsible for securely providing the initial sign-in information.

13.35 Role Selection

The functioning Admin form allows:

User
Admin

Choose User for ordinary account access.

Choose Admin only when the person requires platform-level administrative capabilities.

13.36 Plan Selection

The Plan selector contains:

Free Trial

and the active Plans configured by the platform Administrator.

A selected Plan controls resource limits such as:

AI Agents
Campaigns
Leads
Monthly calls

13.37 Creating the Account

After reviewing the fields:

  1. Confirm the Email Address.
  2. Confirm the Role.
  3. Confirm the Plan.
  4. Select Create User once.
  5. Wait for processing.
  6. Confirm the account appears in the table.

The backend creates default Settings for the new account.

User Versus Admin Selection

13.38 Standard User Recommendation

Use the standard User role when the person only needs to operate:

Leads
Agents
Campaigns
Call Logs
Appointments
Phone Numbers
Settings
Support

for that account’s resources.

13.39 Administrator Recommendation

Assign Admin only when the person is authorized to:

Create platform users
View all platform users
Change Plans
Activate or deactivate accounts
Manage platform configuration
Access administrative support functions

13.40 Administrator Is Not a Department Manager

The current Admin role is not restricted to one organization or department.

The administrative User-list endpoint returns all platform Users.

Do not grant Admin merely because someone supervises one Campaign or sales team.

Changing a User Plan

13.41 Opening Change Plan

From the User’s Actions menu:

  1. Select the three-dot menu.
  2. Select Change Plan.
  3. Choose the new Plan.
  4. Review the expiration date where available.
  5. Select Update Plan.

13.42 Removing a Plan

Selecting the no-Plan option causes the backend to:

Remove the Plan
Set Plan Status to trialing
Remove Plan Expiry

13.43 Assigning a Plan

Assigning a Plan causes the backend to:

Store the Plan
Set Plan Status to active
Set Plan Expiry

When no explicit expiration date is supplied, the current route defaults the expiration to approximately one year from the update date.

13.44 Plan Change Does Not Transfer Resources

Changing a User’s Plan does not transfer:

Leads
Agents
Campaigns
Phone Numbers
Knowledge Bases
Call Logs
Appointments

between accounts.

It changes capacity and subscription status.

Activating and Deactivating Users

13.45 Deactivate User

The Actions menu displays:

Deactivate User

for an active account.

Selecting it changes:

isActive = false

13.46 Effects of Deactivation

A deactivated User can no longer authenticate successfully.

Protected API requests are rejected with a message explaining that the account has been deactivated.

The browser can redirect the person to:

Account Deactivated

13.47 Activate User

For a deactivated account, the Actions menu displays:

Activate User

Selecting it restores:

isActive = true

13.48 Activation Does Not Repair the Plan

Reactivating an account does not automatically:

Assign a Plan
Renew an expired Plan
Restore deleted resources
Reset a Password
Repair provider credentials

Review the Plan and operational configuration separately.

13.49 No User Delete Action

The current Admin User Management page does not provide:

Delete User
Permanently Remove User
Archive User

Deactivation is the supported visible action for disabling access.

This reduces the risk of unintentionally destroying a User record connected to historical activity.

Legacy Team Users Page

13.50 Users Page Purpose

The separate /users page was designed to display:

Name
Email
Role
Shared Access
Joined
Edit

It also contains:

Create User
Edit User

dialogs.

13.51 No Sidebar Link

Users cannot reach this page from the normal current navigation.

Direct access requires manually entering the route or using a custom link.

13.52 Administrative Label

The page identifies itself as:

Manage system users (Admin only)

and its backend User-list and User-update routes require Admin access.

13.53 Global User List

The page’s backend request retrieves all User records.

It is not scoped to:

Users created by this Administrator
One company
One team
One Plan
One department

Legacy Create User Dialog

13.54 Visible Role Choices

The legacy Create User dialog presents:

Admin
Member

13.55 Backend Role Choices

The signup backend accepts:

admin
user

It does not accept:

member

13.56 Member Creation Failure

Selecting Member can fail validation because member is not an accepted backend role or User-model value.

The resulting error can contain validation wording indicating that Role must be one of the accepted values.

13.57 Admin Selection Is Ignored by Signup Logic

Selecting Admin passes the signup schema, but the current signup process independently calculates the role:

First database user:
Admin and Super Administrator

Every later registration:
User

Therefore, selecting Admin in this legacy dialog does not reliably create another Administrator.

13.58 Correct Administrative Creation Path

Administrators should use:

Admin
→ User Management
→ Add User

rather than the legacy /users Create User dialog.

The Admin Add User route properly accepts:

user
admin

roles.

Legacy Edit User Dialog

13.59 Edit Control

The /users table contains a Pencil action that opens:

Edit User: [Name]

with the description:

Update role and manage shared resources.

13.60 Editable Areas

The dialog contains:

Role
Shared Tags (Leads Access)
Shared Agents
Shared Campaigns

13.61 Role Mismatch During Editing

The dialog presents:

Admin
Member

but the backend update route accepts:

admin
user

Selecting Member is therefore incompatible with the current backend validation.

13.62 User Role Is Not Shown as a Choice

A User whose stored role is:

user

can open in an Edit dialog whose available choices are only Admin and Member.

This is another indication that the legacy Team interface and the current backend role model are not aligned.

Shared Tags

13.63 Intended Purpose

The Edit User dialog labels the feature:

Shared Tags (Leads Access)

Its apparent intended purpose is to grant a User access to Leads carrying selected Tags.

Example:

Shared Tag:
Detroit Sales

Intended result:
User sees Leads tagged Detroit Sales

13.64 Available Tag List

When the Edit dialog opens, it retrieves Leads available to the signed-in Administrator and extracts their unique Tags.

Those Tags appear as selectable badges.

13.65 Manual Tag Entry

The Administrator can also type a Tag and select:

Add

This adds the text to the target User’s sharedTags array.

13.66 Shared Tag Is Metadata

The current Leads route retrieves normal User Leads using:

createdBy = signed-in User

It does not consult the signed-in User’s:

sharedTags

array.

Therefore, saving a Shared Tag does not currently prove that the User can see or manage Leads with that Tag.

13.67 No Read-Only or Edit Permission

The current Shared Tags interface does not distinguish:

View Leads
Edit Leads
Delete Leads
Export Leads
Use Leads in Campaigns

No granular Lead permission is stored.

13.68 Manually Added Tag Need Not Exist

The dialog permits a manually entered Shared Tag even when no Lead currently carries that Tag.

Saving it stores the text but does not create or retag any Leads.

Shared Agents

13.69 Intended Purpose

The Shared Agents section appears intended to make selected AI Agents available to another User.

13.70 Available Agent List

The Edit dialog retrieves AI Agents available to the Administrator who opened the dialog.

The Administrator can select or deselect each Agent.

13.71 Stored Relationship

Selected Agent IDs are stored in:

sharedAgents

on the target User record.

When the Users list is retrieved, those IDs are populated with Agent Names for display.

13.72 Current Agent Access Rule

The operational AI Agent route retrieves Agents using:

createdBy = signed-in User

for a normal account.

It does not include Agent IDs stored in:

sharedAgents

Therefore, the current sharing record does not grant confirmed Agent access through the standard Agents page or API.

13.73 No Agent Permission Level

The current sharing field does not distinguish:

View Agent
Use Agent in Campaign
Edit Agent
Delete Agent
Change Phone Number
Change Prompt

13.74 Shared Agent Dependencies

Even after Agent sharing is fully implemented, an Agent can depend on:

Outbound Phone Number
Knowledge Base
Provider credentials
Appointment Settings

The current User-sharing model does not contain equivalent sharing fields for those dependencies.

Shared Campaigns

13.75 Intended Purpose

Shared Campaigns appears intended to provide another User access to selected Campaign records.

13.76 Available Campaign List

The Edit dialog retrieves Campaigns available to the Administrator who opened it.

Selected Campaign IDs are stored in:

sharedCampaigns

on the target User.

13.77 Current Campaign Access Rule

The Campaign routes retrieve normal User Campaigns through:

createdBy = signed-in User

They do not include records listed in the User’s:

sharedCampaigns

array.

Saving Shared Campaigns therefore does not currently provide confirmed Campaign access through the normal Campaigns interface.

13.78 No Campaign Permission Level

The sharing record does not distinguish:

View Campaign
View results
Start Campaign
Stop Campaign
Duplicate Campaign
Delete Campaign

13.79 Campaign Dependencies

A Campaign depends on:

AI Agent
Leads
Phone Number
Provider configuration
Call capacity

Sharing only the Campaign ID would not automatically grant access to all those resources.

The current design does not define how those dependencies should be resolved for a shared User.

Shared Access Display

13.80 Shared Access Column

The legacy Users table can display:

Tags
Agents
Campaigns

assigned to each User.

13.81 None

When no sharing values exist, the column displays:

None

13.82 Unknown Shared Resource

When an Agent or Campaign ID cannot be populated into an active record, the Users table can display:

Unknown

This can occur when the referenced resource was removed or cannot be resolved.

13.83 Display Does Not Confirm Permission

A Tag, Agent, or Campaign appearing under Shared Access confirms only that its value is stored on the User record.

It does not confirm that the resource routes actually authorize access.

Resource Ownership

13.84 Ownership Is the Current Operational Rule

For normal users, operational resources are generally returned according to ownership.

Examples include:

Lead.createdBy
Agent.createdBy
Campaign.createdBy
PhoneNumber.createdBy
KnowledgeBase.createdBy
SipTrunk.createdBy
CallLog.userId
Appointment.userId
Settings.userId

13.85 Lead Ownership

A normal User sees Leads whose:

createdBy

matches the signed-in User.

Lead updates, bulk Tags, and deletions are also ownership-scoped.

13.86 Agent Ownership

A normal User sees and manages AI Agents created by that User.

When an Agent references a Phone Number or Knowledge Base, the backend also verifies that those resources belong to the same User.

13.87 Campaign Ownership

A normal User sees and manages Campaigns whose:

createdBy

matches the signed-in User.

Campaign creation verifies ownership of:

Selected Agent
Every selected Lead

13.88 Sharing Metadata Does Not Change Ownership

Adding a resource ID to another User’s sharing array does not change:

createdBy

on the actual resource.

The original creator remains the owner.

13.89 Ownership and Usage Limits

Plan usage counts are also ownership-based.

The Usage endpoint counts resources such as:

Agents created by User
Campaigns created by User
Leads created by User
Call Logs belonging to User

Shared-resource metadata is not included in those usage calculations.

Independent User Settings

13.90 Default Settings

Every newly created User receives a separate Settings record.

That record can contain the User’s own:

Twilio credentials
ElevenLabs key
Deepgram key
OpenRouter key
Time Zone
Time Format
Recording preference
Automatic Analysis preference
Google Sheets connection
Webhooks
Email notifications
Auto Hangup settings

13.91 Credentials Are Not Shared

Creating a second User does not automatically provide access to the first User’s:

Twilio account
SIP Trunks
AI provider keys
Google Sheets
Webhooks
Email settings

13.92 Shared Agent Cannot Automatically Use Owner Credentials

Even if Shared Agents becomes operational, a shared User’s Settings and credentials remain separate unless additional development explicitly defines credential ownership.

Do not assume a shared Agent will automatically call through the Agent owner’s provider credentials.

Independent Plans and Capacity

13.93 Separate Plans

Each User can have an individual:

Plan
Plan Status
Plan Expiry
Resource limits

13.94 No Pooled Capacity

The current source does not define pooled team limits such as:

100,000 shared Leads
50 shared Agents
10 team members
Combined monthly call allowance

Usage belongs to individual User records.

13.95 Administrator Plan Does Not Cover Other Users

An Administrator’s Plan does not automatically apply to accounts created by that Administrator.

Assign or verify the Plan for each User separately.

Account Creation Strategies

13.96 Public Registration

A person can register through the public Signup page.

Except for the first database User, the new account receives:

role: user

13.97 Administrator-Created Account

An Administrator can create an account from User Management and select:

User or Admin
Plan
Initial Password

This is the preferred current method when the platform operator is provisioning access directly.

13.98 Google Registration

A new Google-authenticated account is assigned according to the same first-user concept:

First User:
Admin

Later Users:
User

13.99 No Team Invitation

The current source does not provide a team owner with an interface that sends:

Join my team
Accept invitation
Choose Password
Access shared workspace

Recommended Current Team Workflow

13.100 Create Individual Accounts

Every staff member should have a separate account.

Do not create one shared login for an entire department.

13.101 Assign the Least Powerful Role

Use:

User

unless the person genuinely requires platform Administration.

13.102 Assign the Correct Plan

Review the staff member’s expected:

Lead volume
Agent count
Campaign count
Monthly calls

and assign the appropriate Plan.

13.103 Configure Resources in the Correct Account

Because ownership controls access, create or import operational resources under the account that will use them.

Examples:

Leads imported by that User
Agents created by that User
Campaigns created by that User
Phone Numbers added by that User
Credentials saved by that User

13.104 Do Not Rely on Shared Access Yet

Do not assign Shared Tags, Agents, or Campaigns and assume that the target User can operate them.

Test the result by signing in as the target User before announcing that access has been granted.

13.105 Test with Nonproduction Resources

When evaluating sharing behavior, use:

Test Lead Tags
Test Agent
Test Campaign
Internal telephone numbers

Do not test unfinished permissions with active customer Campaigns.

Security

13.106 Individual Credentials

Each person should use:

Individual Email Address
Individual Password
Individual Google account where applicable

This improves accountability and makes it possible to deactivate one person without affecting the rest of the staff.

13.107 Do Not Share Passwords

Avoid:

One shared sales login
One shared Administrator login
Password sent in group messages
Credentials stored in public documents

13.108 Administrator Risk

An Administrator can manage platform Users and Plans.

Granting Admin access can allow the person to:

Create other Admins
Deactivate Users
Change Plans
Access administrative support data
Modify platform settings

13.109 Super Administrator Protection

The Super Administrator account should have:

Unique strong password
Protected Email Address
Restricted personnel access
Secure recovery method
Regular access review

13.110 Initial Password Delivery

Provide initial Passwords using an approved secure method.

Do not send the Email Address and Password together in an unsecured public channel.

13.111 Deactivate Departed Staff

When a person leaves:

  1. Deactivate the account promptly.
  2. Review operational Campaigns.
  3. Review Phone Numbers and credentials.
  4. Review Webhooks.
  5. Review Google Sheets access.
  6. Preserve required records.
  7. Rotate exposed provider credentials.

13.112 Deactivation Does Not Rotate External Keys

Deactivating an AIUNIFY User does not automatically rotate:

Twilio Auth Token
SIP Password
ElevenLabs key
Deepgram key
OpenRouter key
Google OAuth authorization
Webhook secret

Review external credentials separately.

Troubleshooting Roles

13.113 Admin Link Does Not Appear

Check:

Stored User role
isSuperAdmin value
Correct account
Browser local User data

Sign out and sign back in after a role change.

13.114 “Access Denied. Admin Only.”

The backend does not recognize the signed-in account as:

admin

or:

Super Administrator

Confirm the User record and sign in again.

13.115 User Was Created as User Instead of Admin

Determine which creation form was used.

The legacy /users dialog submits to public Signup, whose current logic assigns every non-first account the User role regardless of an Admin selection.

Use Admin → User Management → Add User for reliable role assignment.

13.116 Member Role Will Not Save

The current backend does not support:

member

as a User-model role.

Use the functioning:

user

role through the Admin User Management page.

13.117 User Page Shows Empty Data

A normal user role can enter the legacy /users page directly, but the page stops before requesting the protected User list.

Because its visible Access Denied condition checks for member rather than user, the page can appear empty instead of displaying the intended denial screen.

This does not grant backend access.

13.118 Admin User List Will Not Load

Check:

Authentication
Admin role
Super Administrator status
Backend API
Network

The Admin Users route is protected.

Troubleshooting Shared Resources

13.119 Shared Tag Appears but Leads Do Not

This is consistent with the current implementation.

The Shared Tag is stored on the User, but the Leads route remains ownership-based.

13.120 Shared Agent Appears but Agent Is Missing

The Shared Agent relationship can appear in the legacy Users table while the target User’s Agents page still returns only owned Agents.

13.121 Shared Campaign Appears but Campaign Is Missing

The Campaign ID can be stored under Shared Access, but the target User’s Campaign route does not currently consult sharedCampaigns.

13.122 Shared Resource Displays Unknown

The referenced Agent or Campaign may have been deleted or may no longer populate successfully.

Remove the stale sharing value through the legacy Edit dialog only when the interface is being used under developer supervision.

13.123 Shared User Cannot Start Campaign

Even after the Campaign ID is stored as shared, the target User may not own:

Campaign
Agent
Leads
Phone Number
Provider credentials

The Campaign backend continues to enforce ownership and provider configuration.

13.124 Shared Lead Tag Cannot Be Used in Campaign

Campaign creation verifies that every selected Lead belongs to the signed-in User.

A Shared Tag value alone does not satisfy that ownership validation.

Current Sharing Limitations

13.125 No Permission Types

There is no stored distinction between:

Viewer
Operator
Editor
Manager
Owner

13.126 No Resource-Level Actions

The current sharing model does not define which actions are permitted.

For example, a Shared Campaign record does not specify whether the User may:

View
Start
Stop
Duplicate
Delete
Export results

13.127 No Sharing of Dependencies

The User model stores sharing arrays only for:

Tags
Agents
Campaigns

It does not contain equivalent arrays for:

Phone Numbers
SIP Trunks
Knowledge Bases
Call Logs
Appointments
Settings
Provider credentials

13.128 No Sharing Audit Log

The current interface does not show:

Who shared a resource
When it was shared
When it was removed
What permission was granted

13.129 No Expiration

Shared Access values do not contain:

Start date
Expiration date
Temporary access
Automatic revocation

13.130 No User Notification

Saving Shared Access does not show an invitation or notification sent to the target User.

Production Guidance

13.131 Treat Accounts as Separate Workspaces

Until team sharing is completed and tested, operate each account as a separate workspace.

13.132 Verify Ownership Before Campaigns

Before launching:

Lead owner
Agent owner
Campaign owner
Phone Number owner
Knowledge Base owner

should align with the signed-in User.

13.133 Avoid Cross-Account Production Assumptions

Do not assume that an Administrator can create a resource under one account and make it fully operational for another account merely by adding it to Shared Access.

13.134 Preserve Historical Ownership

Do not delete and recreate Users merely to move resources.

Deleting or changing records without a migration plan can damage:

Call Log references
Campaign references
Appointment references
Ownership reporting
Historical audits

Administrator Onboarding Workflow

13.135 Create the Account

Use:

Admin
→ Add User

13.136 Assign Role

Select:

User

unless administrative access is formally approved.

13.137 Assign Plan

Choose the Plan appropriate for the account’s expected activity.

13.138 Provide Credentials Securely

Send the initial Email and Password using an approved process.

13.139 Require Initial Setup

The new User should configure:

Profile
Time Zone
Time Format
AI provider keys
Telephony credentials
Notifications
Webhooks

where applicable.

13.140 Create Owned Resources

The User should then create or import:

Leads
Phone Numbers
SIP Trunks
Agents
Knowledge Bases
Campaigns
Availability

inside that account.

13.141 Run an Access Test

Confirm that the User:

Can sign in
Sees only expected navigation
Cannot access Admin when not authorized
Can access owned resources
Cannot access another User’s resources
Can open Support

Offboarding Workflow

13.142 Review Active Work

Before deactivation, review:

Running Campaigns
Scheduled Campaigns
Active calls
Upcoming Appointments
Phone Numbers
Provider credentials
Google Sheets
Webhooks

13.143 Stop Active Operations

Stop or transfer authorized operational activity before disabling access.

13.144 Preserve Records

Preserve required:

Call Logs
Recordings
Transcripts
Campaign results
Appointments
Support history

13.145 Deactivate the User

Use the Admin Actions menu and select:

Deactivate User

13.146 Rotate External Credentials

Rotate any external credential the person could access.

13.147 Confirm Access Is Blocked

Attempt an authorized verification that the former account can no longer sign in or use protected requests.

User and Role Checklists

13.148 New User Checklist

Confirm:

Full Name correct
Email Address correct
Initial Password secure
Role correct
Plan correct
Account appears in User Management
Default Settings created
Credentials delivered securely
First login tested

13.149 Role Checklist

Confirm:

User does not need Admin access
Admin responsibilities are approved
Super Administrator access remains restricted
Role change tested after sign-out and sign-in

13.150 Admin Checklist

Confirm:

Admin understands global User access
Admin can create other Admins
Admin can deactivate accounts
Admin can change Plans
Admin credentials are protected
Administrative actions are reviewed

13.151 Resource Ownership Checklist

Confirm:

Leads owned by correct User
Agents owned by correct User
Campaigns owned by correct User
Phone Numbers owned by correct User
Knowledge Bases owned by correct User
Credentials stored under correct User

13.152 Shared Access Checklist

Before representing a resource as shared, confirm:

Shared value saved
Target User signed in
Resource appears to target User
Target User can perform intended action
Dependencies are accessible
Unauthorized actions remain blocked

In the current build, this checklist will generally reveal that the stored sharing values do not yet grant complete operational access.

13.153 Deactivation Checklist

Confirm:

Running Campaigns reviewed
Scheduled Campaigns reviewed
Appointments reviewed
Historical records preserved
Account deactivated
External credentials rotated
Access verification completed

Current-Build Summary

13.154 Functioning User Features

The current production-oriented Admin interface supports:

List Users
Search by Name or Email
Create User
Create Admin
Assign Plan
Change Plan
Activate User
Deactivate User
Display role, status, Plan, and join date

13.155 Incomplete Team Features

The current legacy Team interface contains:

Admin and Member role choices
Shared Tags
Shared Agents
Shared Campaigns
Shared Access display

but contains significant mismatches:

Frontend Member role
Backend User role

Legacy Create User role selection
Signup route overriding the selected role

Stored Shared Access
Operational routes ignoring Shared Access

Hidden Users page
No Sidebar navigation

13.156 Operational Conclusion

At present, AIUNIFY Assistant should be operated using:

Individual accounts
Administrator-managed account provisioning
Role-based Admin protection
Ownership-based resource access
Separate Plans and Settings

The Shared Access fields should not be treated as a complete team-collaboration system until the resource routes, permissions, dependencies, and User-role model have been completed and tested.

Chapter Completion

At the end of this chapter, the user should understand the difference between a normal User, Administrator, and Super Administrator; how the first registered account receives Super Administrator status; how the Admin User Management page creates accounts, assigns roles and Plans, searches Users, and activates or deactivates access; why the Admin role is a global platform responsibility rather than a limited department-manager role; and why each User currently operates with separate Settings, credentials, Plans, usage, and owned resources.

The user should also understand that the source contains a separate legacy Users page with Shared Tags, Shared Agents, and Shared Campaigns, but that its visible Member role conflicts with the backend user role. The legacy Create User dialog does not reliably honor its selected role, and the current Leads, Agents, and Campaigns routes do not use the stored sharing arrays when authorizing resource access.

The current reliable rule is:

Resource access
=
Signed-in account ownership
+
Applicable Administrator or Super Administrator authority

not:

Resource access
=
A resource appearing under the legacy Shared Access column


Write Your Comment