--- parser: v2 auto_validation: true time: 20 tags: [ tutorial>beginner, products>sap-conversational-ai, products>sap-business-technology-platform] primary_tag: products>sap-conversational-ai author_name: Daniel Wroblewski author_profile: https://github.com/thecodester slug: conversational-ai-deploy-teams canonical_url: https://developers.sap.com/tutorials/conversational-ai-deploy-teams --- # Deploy an SAP Conversational AI Chatbot to Microsoft Teams Enable an SAP Conversational AI chatbot to be run 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](conversational-ai-webhook-api-call). ## You will learn - How to enable your chatbot within Microsoft Teams ## Intro 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](https://docs.microsoft.com/en-us/MicrosoftTeams/manage-apps). --- ### Create Microsoft Azure account 1. Create a trial account at [Microsoft Azure](https://azure.microsoft.com/en-in/free/). 2. After creating a trial account, make sure your subscription is set up properly. - Go to the Microsoft Azure [portal](https://portal.azure.com/). - 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. ### Create Azure bot channel 1. Go to the Microsoft Azure [portal](https://portal.azure.com/). 2. Click **Create a Resource**. ![Create a Resource](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-teams/1-create-resource.png) 3. Search for **Azure Bot**, then at the bottom of the tile click **Create > Azure Bot**. ![Bot Registration](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-teams/1-bot-registration.png) 4. 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**. ![Create bot resource](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-teams/bot-create.png) 5. 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**. ![Bot created](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-teams/bot-created-list.png) There will be 2 links: one to the resource, and one to the key vault, where you get the secret. ### Get your app ID and secret 1. Open your bot resource, and go to **Settings > Configuration**. The app ID is shown under **Microsoft App ID**. Copy this number down. ![App ID](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-teams/app-id.png) 2. 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**. > ![Access policy](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-teams/accesspolicy.png) >- Under **Select principal**, search for your account and select it. >- Click **Add**, and then **Save**. 3. Select the secret already created when you created your bot resource. ![Secret](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-teams/key-vault-secret.png) 4. Click on the version, and then copy the secret at the bottom of the page. ![Copy secret](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-teams/key-vault-secret2.png) ### Connect bot to Azure 1. Go back to [SAP Conversational AI](https://cai.tools.sap/). 2. Open your bot, and go to the **Connect** tab. ![Connect tab](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-teams/4-connect.png) 3. Click on the row for Skype and Teams, and in the popup, enter the app ID and secret from Azure. ![Copy endpoint](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-teams/4-appID-secret.png) An endpoint will be created. Copy it. ![Link text e.g., Destination screen](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-teams/4-endpoint.png) 4. Go back to your resource in Azure, and under **Settings > Configuration**, paste the endpoint into the **Messaging Endpoint** field. ![Paste endpoint](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-teams/4-endpoint-Azure.png) Click **Apply** (at top). ### Test bot in Azure 1. Still in your resource in Azure, go to **Test in Web Client**. ![Open test](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-teams/5-test-open.png) At the bottom of the screen, there is a box for talking with your bot. 2. Test your bot. ![Test](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-teams/5-test.png) ### Test bot in Teams 1. Still in your resource in Azure, select **Channels**. 2. Click the Microsoft Teams icon. ![Channels](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-teams/6-channels.png) 3. Click **Publish**, then **Save**. ![Publish](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-teams/6-channels-teams.png) 4. Navigate back to the **Channels** main page (you may have to navigate away or refresh the page). 5. Click on **Microsoft Teams** to open the Teams application. ![Open Teams](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-teams/6-teams-test.png) 6. Test your bot in the Teams application. ![Test in Teams](https://raw.githubusercontent.com/sap-tutorials/sap-conversational-ai/main/tutorials/conversational-ai-deploy-teams/6-test-in-teams.png) ### Test yourself --- ### Take It Further - [Adding the bot as a Microsoft Teams app](https://docs.microsoft.com/en-us/microsoftteams/platform/bots/how-to/create-a-bot-for-teams) - [Distributing a Microsoft Teams app](https://docs.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/overview)