- System administrators, particularly in on-premises installations.
- Advanced users who need to manage multiple organizations or adjust global settings.
Key Features
- User and Organization Management. Create, modify, remove users, and add them to specific organizations, which serve as isolated environments within Cognigy.AI.
- Resource Control through Quotas. Set specific quotas for organizations to manage resource usage, including user seats, Projects, and messages. Quotas let you prevent overuse and ensure equitable resource allocation.
- Security and Privacy Settings. Change password policies and manage data privacy settings, ensuring compliance with security standards and protecting sensitive information through features like data masking and retention policies.
- Multitenancy and Impersonation Features. Cognigy.AI supports multitenancy, enabling the management of multiple organizations under one installation, along with the ability to impersonate users for troubleshooting and assistance.
Before you Begin
1. Check Availability
1. Check Availability
- Cognigy SaaS – the Management UI is managed by Cognigy technical support in most cases. Contact Cognigy support if you want to change any values.
- On-Premises – the Management UI is available and can be used by the customer. For more information on how to install the Management UI, refer to the Cognigy GitHub repo.
2. Log in to the Management UI
2. Log in to the Management UI
Manage Organizations
Organizations define the environment for users, Projects, and data in Cognigy.AI. Use the Management UI to create and configure organizations, adjust quotas and policies, and manage data privacy and expiration settings. Each organization has its own limits, users, and settings, allowing for secure and flexible multi-tenant environments. Each installation includes at least one organization, which is created automatically. This initial organization is nameddefaultOrg-xxx.
Create an Organization
Create an Organization
- In the Management UI, select Organisations from the left-side menu, then click
in the bottom-right corner.
- In the Create new Organisation window, fill in the following fields:
- Name – enter the name of the organization.
- CXone Business Unit ID – this field is optional. Enter the Business Unit ID if applicable for NiCE Cognigy billing.
- CXone Tenant ID – this field is optional. If you want users to log in to Cognigy.AI via their NiCE CXone accounts, enter the Tenant ID for your NiCE CXone instance. This way, users can log in via single sign-on (SSO), so they don’t need a separate Cognigy.AI username or password. Each Tenant ID is tied to a single Cognigy.AI organization. When users log in via SSO, they can access only the organization associated with that Tenant ID.
Specifying a Tenant ID allows NiCE CXone users to log in to Cognigy.AI under the Automation category in the app selector of the NiCE CXone interface. This option is available only if the Cognigy.AI application is activated in NiCE CXone. For more information, refer to the NiCE CXone documentation.
- Click Create. The organization will be created with the default settings and appear in the list of organizations.
View Organizations
View Organizations
Change Organization Information
Change Organization Information
Change Organization Quotas
Change Organization Quotas
Change Password Policy
Change Password Policy
Change Expiration Values
Change Expiration Values
- In Cognigy.AI, refer to Data Expiration in the Cognigy.AI documentation.
- In Insights, refer to Data Expiration in the Insights documentation.
Change Data Privacy Settings
Change Data Privacy Settings
Change Organization Products
Change Organization Products
Manage Users
Create and manage users within your Cognigy.AI installation. You can add users to organizations, view user details, impersonate users for troubleshooting, and enforce security settings like password policies or impersonation restrictions.Create a User
Create a User
- In the Management UI, ensure that you have created an organization where you want to add a user.
- You can open a Create new User window by using one of the following options:
- Select Users from the left-side menu, then click
in the bottom-right corner.
- Select Organisations from the left-side menu, select the organization where you want to add a user, then click Create User in the upper-right corner.
- Select Users from the left-side menu, then click
- In the Create new User window, fill in the following fields:
- Name – enter the name of the user.
- Email – enter the email address of the user. This is used for login and notifications.
- Organisation – select the organization to which the user will be added. If you have opened the Create new User window from the Organisations page, the organization will be preselected.
- Password – enter a password for the user. You can generate a random password by clicking
.
- Click Create. The user will be created with the
adminrole by default, which grants them full access to the organization. You can change the user’s role later on the Access Control page for the organization where the user was added.
View User Details
View User Details
Impersonate a User
Impersonate a User
Block User Impersonation
Block User Impersonation
- For Cognigy SaaS installations, contact Cognigy technical support.
- For on-premises installations, use the
BLOCK_IMPERSONATE_USER_ORG_WHITELISTfeature flag. You can block user impersonation for:- One organization — enter the
organisationIdin theBLOCK_IMPERSONATE_USER_ORG_WHITELISTfeature flag. - More than one organization — enter the
organisationIdvalues separated by commas, for example,BLOCK_IMPERSONATE_USER_ORG_WHITELIST=63c6af010aa7a0eadd88edbd,63c6af010aa7a0eadd88edbe. - All organizations — set
BLOCK_IMPERSONATE_USER_ORG_WHITELIST=*.
- One organization — enter the
Other Operations
Other Operations
System Message
Use the System Message feature in the Management UI to notify users across all organizations about important events, such as scheduled maintenance or platform updates. This feature is especially useful for notifying users in on-premises installations about planned downtimes or system-wide changes.Create a System Message
Create a System Message
- In the Management UI, select System Message in the left-side menu, then click
in the bottom-right corner.
- Specify the expiration date and time in the Until when field.
- Enter your message in the Message field. This message will be displayed to all users in the organization.
- (Optional) Activate Show on Login Screen to display the message before users log in.