Setting up audio and video with Microsoft Azure Communication Services (ACS)
This article provides information on how to set up Unblu to use ACS to establish audio and video calls.
To use ACS, you must have an Azure account with an active subscription. How ACS works in general is outlined in the ACS documentation.
This is a preview feature. It may be subject to change or removal with no further notice.
To enable preview features, set com.unblu.platform.enablePreview to true
.
For more information on preview features, refer to the Unblu release policy.
Creating an Azure Communication Services resource on Azure
For Unblu to use ACS for audio and video calls, you must first create an ACS resource on Azure.
To learn how to create and manage ACS resources, refer to the ACS Quickstart Guide.
While ACS and Microsoft Teams use the same backend, Unblu’s ACS integration currently doesn’t allow interoperability between Unblu calls and Teams. Both visitors and agents use the Unblu-provided frontends for their calls. Using Unblu with ACS leverages any existing Microsoft infrastructure your organization has but you must create a new dedicated resource. |
Configuring Unblu to use Azure Communication Services
Once you’ve created an ACS resource, set the following configuration properties at the ACCOUNT
level:
-
com.unblu.messenger.callEnabled: Set to
true
to enable audio and video calls in Unblu. -
com.unblu.conversation.call.callServiceProvider: The call service provider to use for audio and video calls. Set this property to
ACS
. -
com.unblu.conversation.call.acs.resourceEndpointUrl: The ACS resource endpoint URL used for API calls from the Unblu server to ACS. The resource endpoint URL usually has the format
https://<resource-name>.communication.azure.com
. -
com.unblu.conversation.call.acs.accessKey: Your ACS access key. This must be a valid access key belonging to the Azure Communication Service resource you created.
-
Select other options as required. See the Conversation call section of the configuration properties reference for an overview of the available options.
Once these properties are set, Unblu is integrated with ACS. Further configuration of your corporate network, such as to open ports, configure proxies, and authorize domains, may still be required.
Video chat limitations
-
If a visitor navigates to a new page inside the Unblu-instrumented web page, the video connection is disrupted briefly while the page loads and automatically re-established as soon as possible. To work around this, visitors can use the pop-out feature.
-
The video chat can only be displayed in one browser window or tab. If the visitor has several tabs or windows open and they belong to the same Unblu conversation, the video chat stays in one window. If the user wants to transfer the video chat to a different window, they can do so in the chat user interface.
-
Currently, Unblu only supports up to six concurrent video chat participants.
-
Snapshots aren’t supported.
-
Audio level indicators aren’t supported. A workaround is in place to indicate if a participant is speaking.
-
Video background blur isn’t available for implementations based on ACS at this time.
-
The Unblu mobile SDK currently doesn’t support ACS integrations.
See also
-
Visit the Azure network diagnostics page to verify your browser’s network conditions are compatible with Azure Communication Services.
-
For more information about data encryption, refer to Call service providers.
-
If you want to record and archive audio and video calls, refer to Conversation recording.