Installing and configuring Microsoft Teams custom announcement

For a general overview of the function refer to the Announcement article.

Installation

The custom announcement capability is built into the Verba Microsoft Teams Bot Service, there is no additional installation step required.

Prerequisites

Disable the built-in audio notification for P2P PSTN Calls

Disabling the built-in audio notification is required because, in the case of the custom audio announcements, both the bot service and the Teams notification service play a prompt for P2P PSTN calls.

Step 1 - Open PowerShell as administrator.

Step 2 - Execute the following command:

Connect-MicrosoftTeams

Step 3 - A login prompt will show up. Provide the user credentials.

Step 4 - Execute the following command. Replace the <PolicyName> part with the name of the compliance policy

Set-CsTeamsComplianceRecordingPolicy -Identity '<PolicyName>' -DisableComplianceRecordingAudioNotificationForCalls $true

Audio file

The Verba Microsoft Teams Bot service is using the Graph Communications Bot Media SDK which supports 16 kHz Mono PCM Wave audio files as input.

Configuring custom announcements for the Verba Microsoft Teams Bot Service

Follow the steps below to configure custom announcement-related settings for the Verba Microsoft Teams Bot Service:

Step 1 - Open the Verba web interface, click on the System / Servers and select the Recording Server where the bot service is deployed, or select the appropriate Configuration Profile at System / Configuration Profiles

Step 2 - Go to the Change Configuration Settings tab, then expand the Microsoft Teams Bot / General / Recording Notification node.

Step 3 - Configure the following settings:

Configuration Parameter Name

Description

Default Value
Apply User's Recording
Announcement Configuration
Global notification setting, if turned off, the user settings won't be taken into account.Yes
Audit Log for Customisable AnnouncementAudit log for the customizable audio announcement, If turned on the bot service inserts audit log entries through the Web Application's HTTP API to the database.Yes

Enable Custom Audio Announcement for P2P

Enable custom recording announcements.

Limitation
In 2N recording configurations, where 2 separate bots join a call, both bots will play the announcement. As a workaround, the custom announcement feature can be disabled on one of the 2N lanes by setting Enable Custom Audio Announcement for P2P to No.

Yes

Recording Reminder Length (milliseconds)

Duration of the recording reminder beep in milliseconds.

500

Recording Reminder Frequency (hertz)

Pitch of the recording reminder beep in hertz.

1400

Recording Reminder Interval (seconds)

Repetition interval of the recording reminder in seconds.

15

Step 4 - Click the  icon to save your settings.

Step 5 - The system will notify you that the changes need to be applied to the server by restarting the involved services. Execute the required tasks.

Step 6 - Repeat the steps on each server.

Configuring custom prompts for users

It is possible to configure custom notification sounds on a per-user basis. To achieve this follow these steps:

Step 1 - Login to the Recording Server which runs the bot service, and go to the C:\Program Files\Verba\resources\announcement folder.

Step 2 - Copy the .wav files to the internalinbound and outbound folders.

Step 3 - Open the Verba web interface, click on the System / Servers and select the Media Repository server, or select the appropriate Configuration Profile at System / Configuration Profiles

Step 4 - Click on the Change Configuration Settings tab. Expand the Web Application section.

Step 5 - Expand the Recording Announcement node, and add the names of the .wav files to the Teams Internal Calls Prompt Files, Teams PSTN/Federated Inbound Prompt Files, and Teams PSTN/Federated Outbound Files settings, one in a line.

Step 6 - Click the  icon to save your settings.

Step 7 - The system will notify you that the changes need to be applied to the server by restarting the involved services. Execute the required tasks.

Step 8 - Repeat the steps on each Media Repository server.

To configure the custom prompt for the users please see the User Configuration configuration.