V3 Users
- XCALLY Knowledge (Unlicensed)
- Product Knowledge
XCALLY section | Staff → Users |
On this page |
What’s about
XCALLY Motion Users can be either Administrators or Supervisors: they belong to the same Staff category (Users) but have a different role (Admin role versus User role).
The Users (Users with User Role) and the Administrators (Users with Admin Role) share the same U.I., although their abilities may differ.
Users with admin roles can for instance:
Create, modify or delete User Profiles
Create, modify or delete users, agents and telephones
Create and update Cally Square projects
Create and update Custom Dashboards and
enable other users to use themCreate and update lists in the Contact Manager
Create and update campaigns in Motion Dialer
Perform software update
Have access to all features in XCALLY Motion
and many others.
Users with user roles will be identified as belonging to a User Profile, which for instance may allow them to:
View, create, modify or delete agents and telephones (but they cannot manage other users)
View, create, modify or delete resources (like Queues, Accounts, Reports, and so on)
View, create and update Custom Dashboards
View, create and update XCALLY Square projects
View, create and update lists in the Contact Manager
View, create and update campaigns in Motion Dialer
and many others.
The Users having this role (Supervisors) will, for instance, monitor a group of Customer Center Agents' calls, chats, and emails (or any other communication the Agent is participating in with Customers), ensuring the quality of, and analysing the channels quantitative usage reports to track the volume of interactions per unit of time (day, week, month, etc).
They can coach their Agents to prevent customer complaints and manage escalation rise, reaching service levels and objectives set forth by management.
Explore User Profile Documentation to configure User Profiles for your Users.
The User Section
You can find the User section under the Staff menu.
The Role is the most important information related to the User because according to it, the User will be granted specific permissions:
Admin Role: all the Modules will be available, as well as any Channel Queue access
User Role: access to specific (or all) Modules and Channel Queues or other resources will follow the User Profile assigned to the User (it must be chosen during the user creation).
Create a User
To create a User with Admin or User Role click the + button under the Users Section:
To create an Admin Role Choose Admin
There is a check for which Admin account (admin with id=1) can not be editable by other admins
To create an User Role Choose User and select the proper User Profile from the list (the User Profile must be created in advance by the related section).
Then enter User Full Name, Username, Email and Password:
Username is used to login (only letters, numbers or special characters like ._ are allowed)
Email: the User email address. This field is used to receive a link to reset the password anytime the user forgets it
Password: insert here the password. According XCALLY Motion Security rules, if the Security Suite is enabled, it must contain least 8 characters and have at least 1 lowercase character, one uppercase character, one numeric character and one of the following special characters ~!@#$%^&-_=+[{]}.
By default, an internal number (Extension) associated to the User is automatically generated. If you like, you can manually specify the internal number you want to assign to the user extension during the user creation switching off the Auto Generate option.
Modify a User
After the Users are created, you can view them in the list of users:
You can edit, delete or add information in a User account, just by clicking on the three-dots menu and in this case click on Edit User:
Now you can modify the info in the relative tabs:
Account
Personal Info
In the Personal Info tab, you can edit the general info inserted (except for the Role and Username).
For the User Role, you can also change the associated User Profile
Security Suite
In the Admin Security Suite Section, you can see the last password reset time and date (if there is any). This value is shown only if the Security Suite feature is enabled in the Admin Settings
In the User Security Suite Section, you can check the last password reset time and date (if there is any). This value is shown only if the Security Suite feature is enabled in the Admin Settings.
Disabled: switch on to disable the User Account (this action can be reverted, switching the toggle off)
Locked: if the user's account has been locked out after a number of failed login attempts, switch it off to unlock it.
About incorrect logins
Administrators can define what is the maximum number of incorrect login attempts that the system can allow: when the number of attempts allowed is reached, the account of whoever exceeds it is temporarily blocked. It can be unlocked:
manually by the Administrator (editing the blocked user account and clicking on the Unlock function of the Security Suite Section)
automatically, after a certain period in minutes (which must be specified by the Administrator in the Settings Security section).
Note: when this happens, the user is asked to contact the administrator to unlock the account.
Authentication
In the Authentication section:
you can active directory SSO, to login with the Active Directory credentials
disable MFA for the User, when active
Change Avatar
If you want to change the User Avatar click upload and select the image file (Only PNG, JPG, GIF, SVG formats - max 8MB)
Internal messenger
If the toggle button is switched on, when receiving a new Internal Message, the admin/user will be notified by a sound.
Notifications
Defines the default position for displaying toast notifications throughout the application.
Default: top-right.
Voice
In the Voice Tab, you can also change some values of the User Voice setting:
Internal extension (not editable)
Transport: choose TCP/UDP/WS/WSS/TLS (according to the external phone used)
NAT: this variable changes the behaviour of Asterisk for Agent's access behind a firewall. Choose a value among the following: yes, no, force_rport, comedia, never, route
Allowed Codecs: audio Codecs to be used during the call. Choose a value from the list: ulaw, alaw, gsm, g722, g729, opus
Context: this value defines the User context (default and recommended value=from-sip)
Call Group: a call to the user’s phone is placed in one or several call groups
Pickup Group: the user’s phone will be able to pick up an incoming call if the call’s call group matches the user’s pickup group
Video support: Yes, No, Always
At the end, you must save the changes by clicking the status:SAVE button
Client Logs Tab
From the Client Logs section of the single User, you can enable client-side logging for debugging and issue troubleshooting:
Click on the toggle button to enable all Client scopes
Select the minimum logging level:
There are 4 levels available:
DEBUG_LEVEL | DEBUG | LOGS |
ERROR | The ERROR level designates error events that might still allow the application to continue running | error log |
WARNING | The WARNING level designates potentially harmful situations | error log, warn log |
INFO | The INFO level designates informational messages that highlight the progress of the application at coarse-grained level. | error log, warn log, info log |
DEBUG | The DEBUG Level designates fine-grained informational events that are most useful to debug an application. | error log, warn log, info log, debug log |
This feature allows the logs file output on the server (i.e. client/role-username folder), for the Agent/User logs have been enabled.
This feature generates high data traffic. So, it’s recommended to disable it when not neeed.
Delete Users
To delete a User, find it in the User list
click on 3 dots button and then on Delete User:
The deleted users will be sent to Deleted members section
Remember that the default Admin cannot be deleted!
Export list of Users
To export the list of Users in CSV, select the list of Users to export by marking the checkbox on the left side and click on the Export button.
User API KEY
From the API Key Manager button (on the top-right of the header), you can Generate an API key:
Generate: when there isn’t an API key (or the old one is removed, it's possible to generate an API key).
The button Generate is visible only if there isn't a previous API key.
Once an API Key has been generated, you can change or remove it. Clicking on the button, you can choose your action:
Remove: to remove the previous created API key to generate then a new one
Copy: to copy the API key
Change a User password
Admins can change the User password: find the User from the Users list (you can use the search box on the top-right of the page to filter) and then Edit the User profile.
Now click on the Change Password icon (on the top-right of the header), insert the new password and save it:
According to XCALLY Motion Security rules, if the Security Suite is enabled, it must contain at least 8 characters and have at least 1 lowercase character, one uppercase character, one numeric character and one of the following special characters ~!@#$%^&-_=+[{]}.
In the same way, the Administrators can also change their password, but in this case, the old one must also be provided:
Socket Disconnection Error Message
If you encounter a network problem during your XCALLY Motion work session, you will be warned by this error message:
which will disappear when the connection is reestablished.
FAQ
Related topics