Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

XCALLY section

Staff → Agents

On this page

Table of Contents
minLevel1
maxLevel3
outlinefalse
stylenone
typelist
printablefalse

📋 What’s about

Agents are skilled Contact Center representatives who can manage customer interactions through the multi-channel environment.

You can find the Agents section under the Staff menu. 

Note

You must have an admin role or a user role with agents permission to be able to manage Agents in XCALLY Motion. Note that a user can only operate on agents that are added to the queues to which they are enabled.

⚙️ Create a new Agent

🎬 Video Tutorial

To create an Agent click the New Agent button (blue star)  (you'll find it at the bottom right of the page):

Enter the Agent's details:

  • Full Name of the Agent

  • Username, which is used to login (only letters, numbers or special characters like ._ are allowed)

  • Alias: an alternative name for the Agent, which can be used to hide the real agent login name (e.g. in canned answer, email template, chat and so on)

  • Typology (choose the setting among: Phonebar, External, WebRTC and Mobile). Below we’ll explore the different typologies

  • Email: the Agent email address. This field is used to receive a link to reset the password anytime the agent forgets it 

  • Password: insert here the password. According 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 ~!@#$%^&-_=+[{]}.

  • By default, an Internal number (Extension) is automatically generated. You can manually specify the internal number you want to assign to the agent by editing his/her profile.

  • Description is optional

  • Optionally, you can enable Voicemail to automatically create a voicemail box for the agent.

  • For Phonebar agents, you need to switch on Remote Control in order to enable the Phonebar API web service (then you can change this editing in the Agent Motion Phonebar Setting). And indicate the Remote Control Port

  • For Mobile Agents, you have to specify Mobile App Push Gateway

The Agent can now login to the XCALLY general user interface (GUI) or Phonebar using the configured Username and Password.

Info

Remember to enable the agent to the service queues through which they can receive calls!

After the Agent has been created, the Agents will appear in the Agents List.

You can view, edit and modify Agent details and add Agent to Queues.

🔧 Agent Typology

The Typology field must be online with the Agent's client configuration: the Agents with WebRTC use a different transport protocol from the Agents with the Phonebar (see the Voice Section).

A wrong agent configuration will not make possible communication with the server, as shown in the Agent Status on the Phonebar:

image-20240418-072534.png

There are four Agent typologies:

🔵 WebRTC Agents

The agent will be able to login, logout, pause/unpause from the Web Interface. Bar integrated on the platform.
When red dot turns green, the bar is active:

By clicking on Edit button of a created agent, you can modify some settings.

image-20250114-104603.png

In the Agent Configuration, you'll find the tabs shown

image-20250114-105105.png

While on the panel Header you find these buttons:

  • black button to add Agent to a Queue of the different channels

  • orange button to add Agent to a Team 

  • red button to add Agent to a profile (if you have enabled multiprofile feature on your license)

  • key button to change password

  • blue button to add AI assistant to Agent

Account

image-20250114-105339.png
  • In Personal Info tab you can edit Full Name, Email or other description fields.  

In addition to these, you can enable the following:

  • Login in Pause (default: Disabled): if enabled, the agent will be by default on pause for all the queues he/she belongs to when he/she logs in, until the status is changed.

image-20240418-082238.png
  • In the Security Suite Section you have:

    • the last Agent's password reset time and date. This value is shown only if the Security Suite feature is enabled in the global Admin Settings

    • Disabled: switch on this toggle to disable the User Account (this action can be reverted, switching the toggle off)

    • Locked:  if the Agent's account has been automatically locked out after a number of failed login attempts, switch this toggle off to manually unlock it (this only happens if this automation has been configured by the administrator for all users and agents of the system in the General Settings).

    • Mask Sensitive Data: select this option if you want the Agent not to see the personal data of the Contacts, such as the telephone number, the Name and the Email address

Info

Remember to specify the number of characters / digits to mask in the Settings - General (Security section)

image-20250114-105717.png

  • In the Authentication section:

    • you can active directory SSO, to login with the Active Directory credentials

  • Change Avatar: If you want to change the Agent's picture click upload and select the image file (Only PNG and JPG formats - max 8MB).

  • Notifications: here you can define the default position for displaying toast notifications throughout the application.
    Default: top-right.
    You can choose among top or buttom + right/center/left

Voice

In the Voice Section, you can view Agent’s internal number change parameters related to an agent's SIP client settings:

image-20250114-110437.png

  • Host: insert Host IP (for fixed IP access only) or dynamic (for dynamic access) for SIP registration

  • 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

  • Type: this field defines the role of SIP within Asterisk, so the relationship between agent and outbound provider. Insert a value among User (used to identify incoming calls), Peer (for outgoing calls) or Friend (which covers both User and Peer)

  • Allowed Codecs: Audio Codecs to be used during the call. Choose a value from the list: ulaw, alaw, gsm, g722, g729, opus

Info

Please, note that codec g729 is not compatible with the Phonebar and WebRTC Agent.  

  • Caller ID: the default caller id shown to call recipients

  • Context: this value defines the Agent context (default and recommended value=from-sip)

  • Call Group: defines the Agent's call group 

  • Pickup Group: defines the Agent's pickup group

  • Chanspy if enabled administrator can monitor agent’s phone calls (for more information see ChanSpy documentation)

  • Video support: here you can indicate if your trunk supports stream video

  • Record calls to user extension (default=Inactive; other choices: waw, waw49, gsm) to allow the Agent who gets a call to be recorded automatically

  • Encryption (yes/no) using SRTP (Secure Realtime Protocol) Encryption

WebRTC

This menu is available only if Agent's Setting for Typology is WebRTC

image-20241126-143228.png

WebRTC Settings include the following parameters:

  • TLS certificate and TLS certificate's private key: To use a WebRTC function, you need to have valid SSL certificates (self-signed certificates cannot e used).
    To verify these settings, please check the following configuration:

  • ssl_certificate and ssl_certificate_key parameters in /etc/nginx/conf.d/motion.conf are properly set:

  • tlscertfile and tlsprivatekey parameters in /etc/asterisk/http.conf   are properly set:

(Please do not change the extension of .key and .crt files)

Whenever a change is applied, remember to run the following commands:

-service nginx restart

-service asterisk restart

  • WSS Port: Show the port being used by the Bar for WebRTC signaling

image-20241126-143350.png

  • Enable Settings: Enable an agent to view and modify the settings on the bar

  • Auto Answer: If enabled, any call to the agent will be automatically answered (default delay time in seconds is asked)

  • if you enable auto answer, you can also choose if you want to show the Auto Answer Notification (disabled by default):this option shows a browser notification to agent until call is automatically answered (during seconds of indicated delay)

image-20241126-144055.png

  • Enable Recording: Enable an agent to manual recording the incoming calls

  • Enable DTMF tones: When enabled, the Agent hears dtmf tones when he dials a number

  • Do not disturb during pause: if you enable this feature, the Agent will not be disturbed when on pause

  • Ignore agent break status for preview calls: if you enable this feature, the Agent, even if in Pause status, will be able to make a call with the preview mode. The Agent could dial the contact from the Motion Preview button

image-20241126-144447.png

  • Ring in Use: Enable this option to allow the system to forward calls to this agent even when busy. If the option is disabled and the agent is already busy, the system will automatically reject any incoming calls

  • Sip Expires: Time intervals in seconds for client SIP registrations

🔵 Phonebar Agents

Agent enters to phonebar with his/her credentials to activate calls from it. In fact any action should start on the Phonebar and the Web Interface reflects the changes:

In the Agent Configuration form you'll find the tabs shown:

image-20250114-115621.png

image-20250114-105105.png

While on the panel header you find these buttons:

  • black button to add Agent to a Queue of the different channels

  • orange button to add Agent to a Team 

  • red button to add Agent to a profile (if you have enabled multiprofile feature on your license)

  • key button to change password

  • blue button to add AI assistant to Agent

Account

ab471af1-3fb6-4308-8a5b-1150be953220-20240523-140314.png
  • In Personal Info tab you can edit Full Name, Email or other description fields.  

In addition to these, you can enable the following:

  • Login in Pause (default: Disabled): if enabled, the agent will be by default on pause for all the queues he/she belongs to when he/she logs in, until the status is changed.

image-20240418-082238.pngImage Removedimage-20240418-082238.pngImage Added

  • In the Security Suite Section you have:

    • the last Agent's password reset time and date. This value is shown only if the Security Suite feature is enabled in the global Admin Settings

    • Disabled: switch on this toggle to disable the User Account (this action can be reverted, switching the toggle off)

    • Locked:  if the Agent's account has been automatically locked out after a number of failed login attempts, switch this toggle off to manually unlock it (this only happens if this automation has been configured by the administrator for all users and agents of the system in the General Settings).

    • Mask Sensitive Data: select this option if you want the Agent not to see the personal data of the Contacts, such as the telephone number, the Name and the Email address

Info

Remember to specify the number of characters / digits to mask in the Settings - General (Security section)

  • In the Authentication section:

    • you can active directory SSO, to login with the Active Directory credentials

    • disable MFA for the Agent, when active

  • Change Avatar: If you want to change the Agent's picture click upload and select the image file (Only PNG and JPG formats - max 8MB).

  • Notifications: here you can define the default position for displaying toast notifications throughout the application. Default: top-right.
    You can choose among top or buttom + right/center/left

Voice

In the Voice Section, you can view internal number and change parameters related to an agent's SIP client settings:

image-20240418-084636.png
  • Transport: Set the default transports in order of preference. Use:

    • udp/tcp/tls if the Agent uses the Windows Phonebar

  • Host: insert Host IP (for fixed IP access only) or dynamic (for dynamic access) for SIP registration

  • 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

  • Type: this field defines the role of SIP within Asterisk, so the relationship between agent and outbound provider. Insert a value among User (used to identify incoming calls), Peer (for outgoing calls) or Friend (which covers both User and Peer)

  • Allowed Codecs: Audio Codecs to be used during the call. Choose a value from the list: ulaw, alaw, gsm, g722, g729, opus

Info

Please, note that codec g729 is not compatible with the Phonebar and WebRTC Agent.  

  • Caller ID: the default caller id shown to call recipients

  • Context: this value defines the Agent context (default and recommended value=from-sip)

  • Call Group: defines the Agent's call group 

  • Pickup Group: defines the Agent's pickup group

  • Chanspy if enabled administrator can monitor agent’s phone calls (for more information see ChanSpy documentation)

  • Video support: here you can indicate if your trunk supports stream video

  • Record calls to user extension (default=Inactive; other choices: waw, waw49, gsm) to allow the Agent who gets a call to be recorded automatically

  • Encryption (yes/no) using SRTP (Secure Realtime Protocol) Encryption

About Record calls to user extension

When this field is active, the Agent will be notified the call is being recorded by the record button image-20240418-085652.png becoming red on the Phonebar

Clicking on this button the Agent can pause the recording:

and start it again

or start a new recording clicking on (only two recording files maximum per call).

XCALLY Phonebar Settings 

This Menu is available only if Agent's Setting for Typology is Phonebar.

  • Enable Settings: Enable an agent to see and modify the settings on the phonebar 

  • Auto Answer: If enabled, any call to the agent will be automatically answered (default delay time in seconds is asked)

  • Ring in Use: Enables or disables ringing when the agent is already engaged in a conversation

  • Enable Recording: Enable an agent to manual recording the incoming calls

  • Enable DTMF tones: When enabled, the Agent hears dtmf tones when he dials a number

  • Do not disturb during pause: When enabled the agent cannot receive direct or internal calls when in pause on the phonebar (default=enabled)

  • Show unanswered call badge: when enabled, it allows showing the number of unanswered calls on the Agent Phonebar Call History icon 

  • Enable Jaws Integration allows the Agent to use the screen reader Jaws integrated with the Phonebar (for blind agents)

Warning

The following two options are mutually exclusive and require the use of the Phonebar ver. 5.1.31.0 (and following) and the Screen Recording License activation

  • Enable Screen Recording by Agent allows the Agent using the Phonebar to record video sequences of what happens on his/her desktop clicking a specific button that will be displayed 

Info

About Screen Recording by Agent

When this flag is selected, the Agent will find a REC button  on the Phonebar to start recording a video sequence. In order to display that the recording has been activated and is going on, the REC button becomes red image-20240418-090541.png  and blinks: to stop recording the Agent can just click on the same icon (which turns grey again and stops blinking). 

  • Enable Automatic Screen Recording means that the system starts recording a video sequence every time a voice call is received or placed by the Agent using the Phonebar (it stops automatically when the call ends) 

Info

About Automatic Screen Recording

When this flag is selected, the Agent has nothing to do to start  or stop the video recording: the REC button will become red and blink image-20240418-090552.png in order to display that the desktop activities are being recorded. The Video recording cannot be stopped or started manually by the Agent

The files generated using one of the Screen Recording functions mentioned above will be available on the Agent PC. By default they will be saved in: Video/AgentId_AgentName/<year>/<month>/<day>/

A different path (e.g. on a network drive) can be specified in the Settings/General section, and it will be used for all Agents.

  • Remote Control: switch on to enable Phonebar API Web Service

Info

Phonebar API activation

Remote Control

This setting enables/disables the Phonebar API web service for the Agent Profile (enable this setting for using features like click-to-dial).

You need to specify:

  • Remote Control Port (default 9888).

  • SIP Expires: Configures the registration expires (in seconds) of the SIP server. The default value is 3600s.

  • SIP Port: Configures the port of the SIP server. The default value is 5060. 

It this way the Motion Phonebar remote control is active in localhost.

After the Remote control is enabled, the Agent at the first login should accept the following popup (admin pwd is required):

image2017-8-3_14-45-24.png
Warning

Enabling the Windows firewall on the port 9888 (or on the Remote Control Port you set), it is possible to call the API also through the private IP

image-20241015-102310.png

  • SIP section with:

    • SIP Expires: Time in seconds between consecutive SIP registration

    • SIP Source Port: by default 5160

    • SIP Destination Port: by default 5060 port (required)

Info

SIP Destination Port setting has effect only on Phonebar with version >= 5.7

Note

Consider that if you want to enable TLS (in addition to transport protocol), you need to set agent port = SIP Destination Port 5061

  • Call Forwarding=Unconditional: set this flag if you want your agent can set this feature on the phonebar and insert the chosen forwarding phone number (it can be changed by the agent on the phonebar)


🔵 External Agents

The agent will be able to login, logout, pause/unpause from the Web Interface.
The Admin can set an Hot Desk feature for a specific Agent:

If this option is set to on, at login time the Agents will be able to select which one of the available registered Telephones they want to be associated with (click on the down arrow to see the complete list. Telephones must already be configured):

By clicking on Edit button of a created agent, you can modify some settings.

image-20250114-104603.png

In the Agent Configuration form you'll find the tabs shown

image-20250115-143108.png

image-20250114-105105.png

While on the panel Header you find these buttons:

  • black button to add Agent to a Queue of the different channels

  • orange button to add Agent to a Team 

  • red button to add Agent to a profile (if you have enabled multiprofile feature on your license)

  • key button to change password

  • blue button to add AI assistant to Agent

Account

image-20250115-142033.png

  • In Personal Info tab you can edit Full Name, Email or other description fields.  

In addition to these, you can enable the following:

  • hot desk feature: at login time the Agents will be able to select which one of the available registered Telephones they want to be associated with

  • Login in Pause (default: Disabled): if enabled, the agent will be by default on pause for all the queues he/she belongs to when he/she logs in, until the status is changed.

image-20240418-082238.png

  • In the Security Suite Section you have:

    • the last Agent's password reset time and date. This value is shown only if the Security Suite feature is enabled in the global Admin Settings

    • Disabled: switch on this toggle to disable the User Account (this action can be reverted, switching the toggle off)

    • Locked:  if the Agent's account has been automatically locked out after a number of failed login attempts, switch this toggle off to manually unlock it (this only happens if this automation has been configured by the administrator for all users and agents of the system in the General Settings).

    • Mask Sensitive Data: select this option if you want the Agent not to see the personal data of the Contacts, such as the telephone number, the Name and the Email address

Info

Remember to specify the number of characters / digits to mask in the Settings - General (Security section)

  • In the Authentication section:

    • you can active directory SSO, to login with the Active Directory credentials

    • disable MFA for the Agent, when active

  • Change Avatar: If you want to change the Agent's picture click upload and select the image file (Only PNG and JPG formats - max 8MB).

  • Notifications: here you can define the default position for displaying toast notifications throughout the application. Default: top-right.
    You can choose among top or buttom + right/center/left

Voice

In the Voice Section, you can view internal number and change parameters related to an agent's SIP client settings:

image-20240418-084636.png
  • Transport: Set the default transports in order of preference. Use:

    • udp/tcp/ws/wss/tls (according to the external phone used) if the used Phone is External

  • Host: insert Host IP (for fixed IP access only) or dynamic (for dynamic access) for SIP registration

  • 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

  • Type: this field defines the role of SIP within Asterisk, so the relationship between agent and outbound provider. Insert a value among User (used to identify incoming calls), Peer (for outgoing calls) or Friend (which covers both User and Peer)

  • Allowed Codecs: Audio Codecs to be used during the call. Choose a value from the list: ulaw, alaw, gsm, g722, g729, opus

  • Caller ID: the default caller id shown to call recipients

  • Context: this value defines the Agent context (default and recommended value=from-sip)

  • Call Group: defines the Agent's call group 

  • Pickup Group: defines the Agent's pickup group

  • Chanspy if enabled administrator can monitor agent’s phone calls (for more information explore ChanSpy documentation)

  • Video support: here you can indicate if your trunk supports stream video

  • Record calls to user extension (default=Inactive; other choices: waw, waw49, gsm) to allow the Agent who gets a call to be recorded automatically

  • Encryption (yes/no) using SRTP (Secure Realtime Protocol) Encryption

🔵 Mobile Agents

The agents login with XCALLY mobile app to manage voice calls directly from the smartphone

Note
Mobile typology is visible only if Mobile feature is enabled on license.
Available from version 3.33.0

795d8f50-2e33-4e5a-b9ae-6b377e72efe1-20240613-104750.png
image-20240613-104705.png

By clicking on Edit button of a created agent, you can modify some settings.

In the Agent Configuration form you'll find the tabs shown

image-20250115-143006.png

While in the Header of the panel you find these buttons:

  • black button to add Agent to a Queue of the different channels

  • orange button to add Agent to a Team 

  • red button to add Agent to a profile (if you have enabled multiprofile feature on your license)

  • key button to change password

Account

image-20250115-143341.png

  • In Personal Info tab you can edit Full Name, Email or other description fields.  

In addition to these, you can enable the following:

  • Login in Pause (default: Disabled): if enabled, the agent will be by default on pause for all the queues he/she belongs to when he/she logs in, until the status is changed.

image-20240418-082238.png

  • In the Security Suite Section you have:

    • the last Agent's password reset time and date. This value is shown only if the Security Suite feature is enabled in the global Admin Settings

    • Disabled: switch on this toggle to disable the User Account (this action can be reverted, switching the toggle off)

    • Locked:  if the Agent's account has been automatically locked out after a number of failed login attempts, switch this toggle off to manually unlock it (this only happens if this automation has been configured by the administrator for all users and agents of the system in the General Settings).

    • Mask Sensitive Data: select this option if you want the Agent not to see the personal data of the Contacts, such as the telephone number, the Name and the Email address

Info

Remember to specify the number of characters / digits to mask in the Settings - General (Security section)

image-20250116-103854.png

  • In the Authentication section:

    • you can active directory SSO, to login with the Active Directory credentials

  • Change Avatar: If you want to change the Agent's picture click upload and select the image file (Only PNG and JPG formats - max 8MB).

  • Notifications: here you can define the default position for displaying toast notifications throughout the application. Default: top-right.
    You can choose among top or buttom + right/center/left

Voice

In the Voice Section, you can view internal number and change parameters related to an agent's SIP client settings:

image-20250116-104218.png

  • Transport: Set the default transports in order of preference. Use:

    • if you use TLS, you need to select tls protocol; moreover it’s necessary to enable encryption=yes

    • if you use a configuration with tcp/udp, you have to select tcp option

Note
It is recommended to avoid using the UDP protocol due to potential performance issues and functionality problems, such as CallerID not being displayed correctly in push notifications. So if you have UDP enabled in your mobile agent, remove the option and leave only TCP transport
  • Host: insert Host IP (for fixed IP access only) or dynamic (for dynamic access) for SIP registration

  • 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

  • Type: this field defines the role of SIP within Asterisk, so the relationship between agent and outbound provider. Insert a value among User (used to identify incoming calls), Peer (for outgoing calls) or Friend (which covers both User and Peer)

  • Allowed Codecs: Audio Codecs to be used during the call. Choose a value from the list: ulaw, alaw, gsm, g722, g729, opus

Info

Please, note that codec g729 is not compatible with the Phonebar and WebRTC Agent.  

  • Caller ID: the default caller id shown to call recipients

  • Context: this value defines the Agent context (default and recommended value=from-sip)

  • Call Group: defines the Agent's call group 

  • Pickup Group: defines the Agent's pickup group

  • Chanspy if enabled admin can monitor agent’s phone calls (for more information explore ChanSpy documentation)

  • Video support: here you can indicate if your trunk supports stream video

  • Record calls to user extension (default=Inactive; other choices: waw, waw49, gsm) to allow the Agent who gets a call to be recorded automatically

  • Encryption (yes/no) using SRTP (Secure Realtime Protocol) Encryption

Motion App Settings

image-20240409-130521.png

In this section you can see Mobile App configurations, where you can insert Mobile App Push Gateway, so push gateway address and port (you need to insert YOUR_IP_SERVER:5060).

Note

You need to configure your own push gateway to use Mobile App

💬 Other Channels

In the Other Channels Section of all Agents typologies, you can set the Channel Capacity (the maximum number of concurrent channel interactions per agent).

When the maximum number of open interactions is reached, the Agent cannot receive any further interaction on the same channel.

You can change channel capacity for Chat, Email, SMS, Open Channel, Fax or WhatsApp (where the default value is 0=unlimited).

How checks on the tab-limit and capacity work?

Screenshot 2024-11-27 170706-20241127-160706.png

Before an interaction is accepted (whether it is in autoanswer mode, manual mode, or also when the agent receives a message about a previously opened and handled interaction), the system verifies that the agent has not already reached the maximum open tab limit (set in Global settings section) or max capacity:

  • if the Max Open Tab Limit is reached, the interaction is not notified to the agent

  • if the Max Tab Limit is not reached, the system checks the condition Max Capacity to verify if agent has reached the Capacity Limit on the specific channel:

    • if Max Capacity is reached, the interaction is not notified to the agent

    • if Max Capacity is not reached, interaction is accepted

So agents can receive popup for a new interaction only in these conditions:

  • they are not in pause status on the channel

  • they have not reached the maximum open tab limit and they have not reached the maximum capacity for this channel

About reports:

  • A message routed to a queue is saved in reports in the related report_{{channel}}_queue:

    • if the message exceeds the timeout set in the routing, the entry in the report_{{channel}}_queue will show as reason timeout

    • if the message is accepted, the entry in the report_{{channel}}_queue will show as reason accepted

    • if the customer abandons conversation before an agent answers (e.g. he closes the website with the chat snippet), the entry in the report_{{channel}}_queue will show as reason abandoned

  • Scenarios:

    • if agent reaches the maximum number of Max Capacity or Max Tab Limits, the new request must not be notified and in the report_{{channel}}_queue of the specific channel, the request must have as reason timeout

    • If an agent has the auto answer enabled, but he has already reached the Max Tab Limit or the Max Capacity, the new request must not be automatically accepted as long as the number of tabs/capacity decreases by 1

  • A routing with several queues inserted one after the other will create a report entry for each executed queue and relative reason (e.g. if QueueA goes in timeout, while QueueB answers → you will view in report an entry related to QueueA with reason timeoutand an other one related to QueueB with reason accepted

  • When an agent accepts a message, in report_{{channel}}_queue you will see the relative UserId

From Auto answer section, you can enable/disable the auto answer for the Agent selected. 

The interaction is assigned to the Agent without him accepting the notification. 

You can enable this feature for each channel (Chat, Email, SMS, Open Channel, Fax and Whatsapp), by setting the auto answer delay in seconds. 

Note

Don’t use this feature when using beepall queue strategy

From Advanced Search section, you can enable/disable the advanced search for the Agent selected. 

✅ Permissions

In this section, the admin can give permission to a specific Agent to: 

image-20250114-113037.png

  • Enable Internal Messenger: allow/disable the use of the internal messenger on the Agent's Desktop 

  • Messenger sound notification: when receiving a new Internal Message, the Agent will be notified by a sound 

  • Prefix Required: the Agent has to choose a service label "prefix" when placing a call 

  • Select Recall Me Campaign: if enabled, the Agent can choose the Motion Bull - Queue Campaign to which the Recall me option will be associated

  • Reschedule Hopper calls: if enabled, the Agent can schedule and edit the date, time and agent assigned for all the calls in his queue

image-20250114-113226.png

  • Download Permissions

    • Attachments: Download interactions' Attachments (chat, email, openchannel…)

    • Omnichannel Interactions: Download interactions carried out for each channel (chat, email, SMS, openchannel, fax, WhatsApp)

    • Voice Recordings: Download recordings of the calls

image (13)-20240523-142503.jpg
  • Permissions: Enable/Disable Agents to use features and applications.

    • When you create a new Agent, all Modules Permissions are enabled by default.

    • If you disable one or more applications, they will not be shown on the Agent Omni Channel Desktop sidebar.

    • From time to time we release new sections but they will not be automatically applied to previously created Agents: if you want the new modules to be displayed in the menu, check the permissions and for each Agent and enable the section!

Note

If you disable Voice permissions, the Agent will still receive and place calls (if the Agent belongs to an active Voice Queue). However, the sections Calls List and Abandoned Calls List will not be available when the voice function is disabled.

Clicking on the Enable/Disable switch will cause immediate changes in the Agent Settings.

🗒️ Client Logs

image-20240418-090956.png

From the Client Logs section of the single Agent, you can enable client-side logging for debug and issue troubleshooting.

Info

This feature is available for Onmi Desktop Interface activities only, WEB CLIENT only. Phonebar Logs can be retrieved from the Agents' pc.

  • Click on the toggle button to enable all Client scopes

  • Select the minimum logging level:

There are 4 levels available. Below, the basic information in this regard:

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

As logs are enabled, the Agent receives a corresponding notification, as in the following example:

This feature allows the logs file output on the server (i.e. client/role-username folder), for the Agent/User logs have been enabled.

Note

This feature generates high data traffic. So, it’s recommended to disable it when not needed.

(plus) Add an Agent to a Team

Administrators can add agents to teams. To do so, find the agent from the agents' list and click on 3 dots button and then on Add Agent to Team.

You can also add an agent to a Team by clicking the orange button in the Edit Agent panel.

image-20250116-110733.png

(plus) Add an agent to a queue

Admin or user with relative permissions must add an agent to a queue to enable him/her handle calls headed to the queue. 

In order to add an agent to a queue, find the agent from the list (you can use the search box on the top-right of the page to filter), click on 3 dots button  and then on Edit Agent.

Now click on black button and you will see the list of the available Queue Channels (the list may vary according to your system modules): 

When you click on the icon referred to the chosen Channel (Voice, Chat, Email, SMS, Other Channels) the pop-up screen will show you the list of available queues for each of them. 

In order to add the agent to one queue you just need to click on the queue name.
You can add more than one queue.

Click on  to add ALL the queues to the agent.

Warning
All changes you make are automatically saved and operational!

Info

Remember to add the selected Agents to any Website/Account you create! If you don't do this, the Agents will not be able to see the interactions exchanged through them. You can do this in the specific account configuration and setting.

(minus) Delete Agents

To delete a single agent, find the agent in the agents list and Delete:

To delete multiple agents you can select the list of agents to delete by marking the checkbox on the left side and then click on Delete  button (ok to confirm).

Export list of agents

To export list of agents in CSV, select the list of agents to export by marking the checkbox on the left side and click on the Export  button:

❓ FAQ

Expand
titleHow can an agent recover a forgotten password?
  • open the login panel

  • click on 

  • enter the e-mail address associated to the login name

  • the agent will receive a link via email. Click on this link and change the password (This link expires in one hour: if the agent cannot use it, it’s necessary to start a new reset procedure). 

This function works only if SMTP service is set properly.

According to XCALLY Motion Security rules, if the Security Suite is enabled, the new password must comply to the following security rules: 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 ~!@#$%^&-_=+[{]}.


(blue star) Related topics

Filter by label (Content by label)
showLabelsfalse
max5
spacescom.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@957
maxCheckboxfalse
showSpacefalse
sortmodified
typepage
reversetrue
labelswebrtc agent asterisk
cqllabel = "agents" and type = "page" and space = "XM"