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 Announcement | Audit 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. | 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 internal, inbound 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.