Context
For our previously created Tenant, let us onboard/import 10 users in the application with various User roles.
When creating Users in Luma, ensure that information used for user authentication and reconciliation such as user name, email id, phone number, etc. are the same as that are in your 3rd party system. This will ensure that the user is auto authenticated by Luma and correctly identified during integration with the third-party system.
For example, if you are using ISM as your ITSM system, use the same email id to register in both the systems. This way Luma will be able to access the correct information like your tickets, assets, etc. in ISM.
Add New Users
Follow the below steps to Add a New user and assign required access:
In the Bot builder application, Navigate to User Management under Tenant Menu.
Click on the Create User button to navigate to the User details section.
On the User Details section, add
Username, Firstname, Lastname, Email Address, and other user details
Assign a User Role, to the User you are onboarding.
For more details, refer to Manage Users
Click on Create to create the user.
Default Groups are automatically assigned to the new user based on the User role assigned in step 3.
The new user can now log in to Luma Virtual Agent and execute skills as per the permissions assigned.
Import Users
The system requires the information in a predefined format for the users to be imported to the application. Follow the below steps to import the users:
Before the import process is initiated, make sure that Custom User Attributes are created in the Luma Bot builder application.
Navigate to the Custom User Attributes tab on User Management to view the list of custom attributes created. Click on Create Custom User Attribute.
On, Create Custom User Attribute details page, provide details of the new field. Add Name and Data type. For more information, refer to Custom User Attributes.
Click on Create.
Now, in the Luma Bot builder application, navigate to User Management under Tenant Menu.
Click on the Import Users button.
On the Import Users section, click on Download Sample User Import File to download the sample file.
Select the required import file format CSV or JSON and Click on Download.
Populate the user information to the sample file or use an already existing file of the same format. For more information, refer to Import Users and Groups.
Note:Do not change the file format or existing column names. The incorrect format may lead to errors in the Import process.
Add information to all mandatory columns- Username, Firstname, Lastname, Email Address.
Add additional information of the users if required for your organization.
We are now ready to import users in Luma Virtual Agent. Navigate to the Users tab on User Management.
Reconciliation fields for your import are set to ID and UserName fields by default.
Click on Edit to update the fields. Select the reconciliation field in Field Name drop-down. Click on Set.
Click on 'X' next to the field to be removed from the list.
Click on the Save button to update the fields.
Click on the Import Users button.
On the Import Users tab, click on the Import icon.
Browse to the file to be uploaded and click Import.
The imported file will now appear in the Import History list. Click on Refresh to refresh import status. You may cancel the upload by clicking on Abort.
Click on the record and view the upload summary. You will find here upload information and Error/Warning details (if any).
The new users, uploaded without error, will now be available in the Users list for your Tenant. You may select and edit the user details as required.
