WebRTC Agents Tipology
On this page |
|
Overview
This page outlines the WebRTC agent’s editing options.
WebRTC Agents use the integrated softphone available in the XCALLY Motion web interface to manage voice communications directly from their browser.
Login/Logout: Agents can log in and out of the system using the browser-based control bar.
Pause/Unpause: Agents can set their status to pause or resume availability for handling calls at any time.
A green dot on the WebRTC control bar indicates that the softphone is active and ready to handle incoming or outgoing calls.
A red dot indicates that the softphone is not active.
Discover more about WebRTC here
Edit WebRTC Agent
To edit the Agent configurations:
Go Under Staff → Agents
Locate the agent of interest
Click the three dots menu → Edit
Access the configuration sections
When editing an Agent in XCALLY Motion, several configuration tabs and action buttons are available to manage the agent’s settings and permissions.
Agent Panel Header
In the Agent Panel Header, you will find the following action buttons:
Channels button to add the agent to one or more queues (voice or digital channels).
Associate teams button, to assign the agent to a team
Associate profiles button, to assign a profile to the agent
Key button, to change the agent's password
AI bot button, to associate an AI assistant with the Agent
Account
Personal Info
You can update the agent’s personal information, including Full Name, Alias, Typology, Email Address, Phone, Mobile Description fields.
Login in Pause
Default (disabled): when enabled, the agent will automatically log in with a Paused status on all assigned queues.
The agent must manually click the Play button to become available and start receiving interactions.
Security Suite
The Security Suite section provides tools to manage agent account security and privacy. You can view:
Last Password Reset: displays the timestamp of the agent’s most recent password reset.
This field is available only when the Security Suite feature is enabled.Disabled: temporarily deactivate the agent account. The toggle can be switched back at any time to reactivate the account.
Locked: manually unlock the agent account if it has been locked due to repeated failed login attempts. This behavior must be configured by an administrator under General Settings for all users and agents.
Mask Sensitive Data: prevents the agent from viewing contact personal details, including name, email, phone number
The specific masking behavior can be configured via: Settings → General → Security
Authentication
The Authentication section allows configuration of external login methods:
Active directory SSO: enable login using Active Directory (AD) credentials.
Requires prior AD integration setup.SAML Multi-login Configuration: define the SAML ID if you want to setup the SAML mutilogin configuration.
This enables secure access across multiple identity providers.
Change Avatar
Change Avatar: upload an Agent photo (PNG or JPG, max 8MB).
Notifications
Set the preferred position for toast notifications within the interface:
Default: Top-right
Other options: Top/Bottom + Left/Center/Right
Voice
The Voice section displays settings related to the agent's SIP (Session Initiation Protocol) client configuration. These parameters control how the agent interacts with telephony infrastructure, including call behavior, media handling, and security.
Host: insert Host IP (for fixed IP access only) or dynamic (for dynamic access) for SIP registration
NAT: SIP behavior behind firewalls (options: yes, no, force_rport, comedia, never, route)
Type: defines SIP behaviour in 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
Note: codec g729 is not compatible with Phonebar and WebRTC Agent
Caller ID: default caller ID shown to recipients
Context: 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: this option enable the H264 video codec. In any case, the video channel is not supported
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
Other Channels
Capacity
In the Other Channels section for all agent typologies, you can configure the Channel Capacity, which defines the maximum number of concurrent interactions an agent can handle per channel.
When an agent reaches the maximum number of open interactions on a given channel, they will not receive additional interactions on that channel until some are closed.
Channel Capacity can be set individually for the following channels: Chat, Email, SMS, Open Channel, Fax or WhatsApp
The default value is 0, which means unlimited concurrent interactions.
Tab Limit and Capacity Checks
Before an interaction is accepted—whether in auto-answer mode, manual mode, or when an agent receives a message related to a previously opened interaction—the system performs the following checks to ensure the agent is available:
Agents will only receive a popup notification for a new interaction if:
Reporting Behavior: Interactions routed to a queue are logged in the respective
Additional Scenarios:
|
Auto Answer
From the Auto Answer section, you can enable or disable the auto answer feature for the selected agent.
When enabled, interactions are assigned to the agent automatically, without requiring the agent to accept the notification manually.
This feature can be configured individually for each channel, including Chat, Email, SMS, Open Channel, Fax, and WhatsApp.
You must specify the auto answer delay in seconds for each channel.
Do not use the auto answer feature when using the beepall queue strategy.
Advanced Search
In the Advanced Search section, you can enable or disable the advanced search feature for the selected agent, for each channel.
WebRTC
This menu is available only if Agent's Setting for Typology is WebRTC. 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:
|
|
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 used for WebRTC signaling
Enable Settings: when enabled, the agent is allowed to view and modify their client settings directly from the interface (e.g. adjust audio devices, caller ID, auto answer behavior, etc.).
Auto Answer: when enabled, incoming calls are automatically answered without agent interaction after a configurable auto answer delay. The system prompts you to define a delay in seconds before the call is auto-answered. During this delay, the agent can prepare the answer.
Auto Answer Notification: when this option is enabled (Auto Answer enabled required), a browser notification is shown to the agent during the auto answer delay period. This alert informs the agent that a call is about to be automatically answered.
Ring in Use: When enabled, the system will forward incoming calls to the agent even if they are already on another call (i.e., their line is busy). Behavior:
Enabled: Calls are delivered to the agent regardless of line status (useful for call waiting scenarios).
Disabled (default): If the agent is busy, incoming calls are automatically rejected or handled based on queue strategy.
Enable Recording: allows the agent to manually start and stop call recordings during active conversations via the client interface.
Enable DTMF tones: when enabled, the agent hears DTMF tones (Dual-Tone Multi-Frequency) during number dialing. This provides audible feedback while entering digits.
Do not disturb during pause: when enabled, the agent will not receive any call notifications while in Pause status.
This ensures a true “Do Not Disturb” state during breaks or non-working periodsIgnore agent break status for preview calls: If enabled, the agent can initiate preview calls even while in Pause.
The agent is allowed to dial a contact using the Motion Preview button, bypassing the break status restriction.