Overview

AtBot gives you the ability to connect a Microsoft Speech service to your bots in Teams. This feature allows users to call your bots and interact with them via voice as well as text. There are a few steps to take in order to get this to work; settings in Azure, AD as well as the AtBot Admin portal. You must have configured your Bot Framework registration prior to configuring call settings.


Teams Bot Channel Settings

The first step is to enable the Teams Calling feature in AtBot and then update some settings in Azure.

  1. Starting in the AtBot Admin Portal, on the edit screen for your Enterprise bot, click on the Teams Call Settings tab.
  2. Check the box to enable this bot to take Teams calls.
  3. Copy the value for Webhook Endpoint.
  4. Navigate to your Bot Channel Registration and click on Channels > Edit the Teams channel.
  5. Under the Calling tab, check the box to enable calling and paste in the webhook url you copied from AtBot.

Additional Permissions and Admin Consent to Your Bot Registration

The next step is to add some additional API permissions to your bot registration as well as provide admin consent to those permissions for your organization. These steps are required for any bot framework bot that allows calling.

  1. On the Settings page of your Bot Channel Registration in Azure, click on the Manage link next to Microsoft App ID.
  2. Navigate to API Permissions and add the following Microsoft Graph Permissions as Application permissions:
    • Calls.AccessMedia.All
    • Calls.Initiate.All
    • Calls.InitiateGroupCall.All
    • Calls.JoinGroupCall.All
    • Calls.JoinGroupCallAsGuest.All
  3. Navigate to Azure Active Directory > Enterprise Applications
  4. Find your bot registration and navigate to the permissions panel. There will be a large button that will allow you to Grant admin consent for your bot to your organization.

Connecting the Speech service

The final step in giving your Teams bot a voice is to create and connect to a Speech Service in your Azure tenant. Once created, grab a Key that is generated and note the region you created the service. Navigate back to the Teams Call Settings tab in AtBot.

Fields

Subscription Key
The key that you copied from your Speech Service in Azure.
Service Region
The region that your speech service is deployed to
Default Voice
Enter or select the voice from the list of voices by clicking the
Speech to Text Language
Select the language this bot with understand
Wake Word
Create a wake word file by logging in to the Custom Speech Portal. We recommend a name and a greeting before it like "Hey Linda" or "Ok Justin". Once you have downloaded your wake word file, click the Update Wake Word button to upload your file and specify your wake word.
Animations
Animations for your bot must be pregenerated. Ensure that you have a bot icon and that you have saved the bot before generating animations.