Registering the Microsoft Teams Bot in Azure

Creating a bot channel registration

Step 1 - Log in to the Azure portal.

Step 2 - Search for Azure Bot in the search box on the top, then click on the link under the Marketplace section.

Step 3 - In the left panel, provide a unique name at the Bot handle, then select the Subscription, the Resource group. Set the Type of App to either Single Tenant or Multi Tenant. If the Bot will be used by multiple tenants, then select Multi Tenant.

Step 4 - Click on the Review + Create button and if the configuration is correct the Create button again. Creating the Azure Bot may take some seconds. Azure will actually create an App Registration and a Bot Service assigned to it.

Adding a Teams Channel to the Bot Service

Step 5 - Once the Bot Channels Registration is completed, search for Bot Services in the search box on the top, then click on the Bot Services link under the Services section.

(Alternatively, the Bot Services can be also found by opening the hamburger menu in the upper right corner, then selecting All services, then the AI + machine learning category.)

Step 6 - Select the Bot Service from the list that was created previously using the name provided at Step 3 (Bot handle).

Step 7 - In the second left panel, under the Settings section, click on the Channels menu.

Step 8 - Under the Available channels section select Microsoft Teams option.

Step 9 - Accept the terms of service, select the Microsoft Teams Commercial option, then click Apply.

Step 10 - Select the Calling tab, then tick the Enable calling checkbox.

Step 11 - At the Webhook (for calling) setting, provide the following URL: https://verba_bot_vm.domain.com:9440/api/calling

Replace the verba_bot_vm part with the hostname of the Azure virtual machine which will host the Verba Bot service. At the domain part, use the domain of the Teams tenant (also specified in the SSL certificate).

Step 12 - Click on the Apply button.

Configuring authentication for the bot

Step 13 - Search for App registrations in the search box on the top, then click on the App registrations link under the Services section.

(Alternatively, the App registrations can be also found by opening the hamburger menu in the upper right corner, then selecting the Azure Active Directory, then selecting App registrations in the left panel.)

Step 14 - Select the App Registration from the list that was created previously using the name provided at Step 3 (Bot handle).

Step 15 - Take a note of the Application (client) ID and the Directory (tenant) ID. They will be needed later.

Step 16 - Select the Certificates & secrets menu in the left panel.

Step 17 - Under the Client secrets section, click on the New Client Secret button.

Step 18 - Provide a Description, set when the secret Expires, then click on the Add button.

Step 19 - Take a note of the new Client secret. It will be needed later.

Step 20 - In the left panel, under the Manage section, click on the Authentication menu.

Step 21 - Under the Platform configuration sections, click on the Add a platform button.

Step 22 - In the right panel, select Web.

Step 23 - Provide a Redirect URI. It can be any website. Take a note of the URI provided, it will be needed later.

Step 24 - Click on the Configure button in the bottom.

Configuring permissions to the bot

Step 25 - In the left panel, under the Manage section, click on the API permissions menu.

Step 26 - Click on the Add a permission button.

Step 27 - Select Microsoft Graph, then select Application permissions.

Step 28 - Select the following permissions:

• • Calendars.Read
  • Calls.AccessMedia.All
  • Calls.JoinGroupCall.All
  • Calls.JoinGroupCallAsGuest.All
  • OnlineMeetings.Read.All
  • User.Read.All

Step 29 - Click on the Add permissions button.

Granting admin consent to the permissions

Step 30 - Build the consent URL. The format is the following:

https://login.microsoftonline.com/{tenant_id}/adminconsent?client_id={microsoft_app_id}&state=12345&redirect_uri={redirect_uri}

Replace the {tenant_id} part with the Directory (tenant) ID and the {microsoft_app_id} part with the Application (client) ID from Step 14. Replace {redirect_uri} part with the URI from Step 22.

Step 31 - Copy the previously created consent URL into the browser, then hit enter. Log in with a Teams Service Admin or Global Admin user of the Azure tenant where the Teams environment to record resides. Click on the Accept button. The page will redirect to the webpage provided in the Redirect URI setting.

2N Recording

Step 32 (Optional) - In the case of 2N recording, all the steps above have to be done twice. Take a note of the second Application (client) ID also at Step 14. It will be needed in the next part of the configuration guide.

Protected API Access for Chat Recording

Step 33 (Optional) - If the same App Registration will be used for Chat recording also, then the following form has to be sent:

https://aka.ms/teamsgraph/requestaccess

At the Data Retention setting select “It is obvious to any admin installing this app that it will make a copy of Microsoft Teams messages”. On the second page, leave the URLs empty.