Deploy an SAP Conversational AI Chatbot to Microsoft Teams

0 %

Deploy an SAP Conversational AI Chatbot to Microsoft Teams

Details

Deploy an SAP Conversational AI Chatbot to Microsoft Teams

Daniel Wroblewski

September 5, 2021

Created by

September 9, 2020

Beginner

20 min.

Enable an SAP Conversational AI chatbot to be run within Microsoft Teams.

You will learn

How to enable your chatbot within Microsoft Teams

Prerequisites

You have created a chatbot to deploy. This tutorial uses the bot created in the tutorial Consume API Services and Call Webhooks from Your Chatbot.

This tutorial shows you how to enable and test your chatbot in Microsoft teams, but does not include information on adding the chatbot to teams and channels within Microsoft Teams. For more information on this, see Manage your apps in the Microsoft Teams admin center.

Step 1: Create Microsoft Azure account

Create a trial account at Microsoft Azure.
After creating a trial account, make sure your subscription is set up properly.
- Go to the Microsoft Azure portal.
- Click Subscriptions.
- Click your subscription (mine was called Azure subscription 1).
- Click Resource Providers (menu on bottom left).
Make sure the microsoft.insights is registered.

Done

Log on to answer question

Step 2: Create Azure bot channel

Go to the Microsoft Azure portal.
Click Create a Resource.
Search for Azure Bot, then at the bottom of the tile click Create > Azure Bot.

Fill in the fields in the wizard.

The instructions were valid at the time of this writing, but you should check the Microsoft documentation for exact instructions.

Field Name	Input Value
Bot Handle	A unique display name for the bot (which will appear in channels and directories – this can be changed later)
Subscription	Your Azure subscription (in my trial, I had only one)
Resource Group	Select a resource group. If you don’t have one – which you probably won’t have – then create a new one.
Pricing	Make sure you select the F0 free Pricing tier – I had to change the selection – unless you want to use it in production.
Microsoft App ID	Keep Create new Microsoft App ID

Click Review + Create.

It will take a few minutes for the resource settings to be validated.

Once complete, click Create.

It may take a few minutes for the resource to be created.

When complete, you can go to the bot resource by clicking Go to resource.

There will be 2 links: one to the resource, and one to the key vault, where you get the secret.

Done

Log on to answer question

Step 3: Get your app ID and secret

Open your bot resource, and go to Settings > Configuration.

The app ID is shown under Microsoft App ID. Copy this number down.
Open the key vault.
In my Azure account, I had to give myself permission to enable me to use the key vaults and to get my app’s secret. I did the following:
- In the key vault, go to Settings > Access Policies.
- Click Add Access Policy.
- In the Configure from template field, select the Key, Secret & Certificate Management.
- Under Select principal, search for your account and select it.
- Click Add, and then Save.
Select the secret already created when you created your bot resource.
Click on the version, and then copy the secret at the bottom of the page.

Done

Log on to answer question

Step 4: Connect bot to Azure

Go back to SAP Conversational AI.
Open your bot, and go to the Connect tab.
Click on the row for Skype and Teams, and in the popup, enter the app ID and secret from Azure.

An endpoint will be created. Copy it.
Go back to your resource in Azure, and under Settings > Configuration, paste the endpoint into the Messaging Endpoint field.

Click Apply (at top).

Done

Log on to answer question

Step 5: Test bot in Azure

Still in your resource in Azure, go to Test in Web Client.

At the bottom of the screen, there is a box for talking with your bot.
Test your bot.

Done

Log on to answer question

Step 6: Test bot in Teams

Still in your resource in Azure, select Channels.
Click the Microsoft Teams icon.
Click Publish, then Save.
Navigate back to the Channels main page (you may have to navigate away or refresh the page).
Click on Microsoft Teams to open the Teams application.
Test your bot in the Teams application.