Introduction
Nectar DXP users can install the Nectar DXP WebRTC extension to capture WebRTC metrics from browser-based telephony platforms.
WebRTC users have to authenticate against Nectar DXP in order to send call records. This authentication is facilitated by the Nectar DXP SSO integration, which is a prerequisite for WebRTC. This document describes how to configure an existing Nectar DXP SSO configuration to work with WebRTC.
WebRTC Data Source Configuration
To enable the WebRTC data source in DXP, navigate to Admin -> Advanced Settings -> Configuration -> Data Sources, then scroll to WebRTC and click Add Source.
Select the desired platforms, set the Collection and Reauth. intervals, toggle Extension Logging if desired, then click Save.
WebRTC Platforms
Currently supported platforms include:
- AirPhone
- Amazon Connect
- Avaya Cloud
- Cisco WebEX
- Five9
- Genesys Cloud
- MS Teams
- NICE Cxone
- Zoom
- Google Meet
Accepted Domain Configuration
All email domains that are used by your WebRTC users have to be added to Nectar. These must be domains that are accepted by your SSO provider and are owned by your organization (ie. gmail.com is not an acceptable domain). To add to your list of accepted domains, follow these instructions:
- Click on the ADMIN tab on the top-right.
- Click Domain Names in the left panel to open the Domain Names page.
- Click Add Domain Name.
- Enter the name of the new domain and click Add.
SSO Configuration
This section assumes you already have SSO configured for your environment.
The Nectar WebRTC extension uses your existing SSO configuration for authentication. When a user signs into the WebRTC extension, the SSO provider sends a list of groups the user is a member of. This list is parsed by Nectar DXP to determine the role to assign to the user. Select one or more groups that include all your WebRTC users and assign them to a Nectar DXP User role. Any role is acceptable, but for most customers, the Self-View role is sufficient. This gives just enough permissions to successfully authenticate to Nectar DXP without granting too many privileges. A user assigned to the Self-View role will be able to sign in with the WebRTC extension as well as the Nectar DXP web application to view their own call activity.
Assign one or more groups to WebRTC users by following the below instructions:
- Click on the ADMIN tab on the top-right.
- Click SSO Configuration in the left panel to open the SSO Configuration page.
- Under User Role Mapping, pick the desired Tenant User Role (ie 'Self-View') and assign a group to the External User Role using the format required for your SSO provider.
- Click UPDATE to save the configuration
WebRTC Extension Recommendations
By default, the Nectar WebRTC extension re-authenticates every 24 hours. For the most seamless user experience, it is recommended that users sign into their browser using the same email address that will be used for the WebRTC extension. In most cases, this will make the re-authentication experience seamless. Otherwise, users will likely be prompted to re-authenticate via a pop-up browser tab that may confuse users.
WebRTC Store URLs