Microsoft Teams

Integrate Watson Assistant with Microsoft Teams

Pre-Requisites to integrate Microsoft Teams

• Microsoft admin account

High level Steps

1. Create Microsoft Teams custom extension
   1. App registration
   2. Create your bot
   3. Create your Teams app
2. Export MS Teams App and import to MS Teams Platform

Create Microsoft Teams custom extension

1. Navigate to "Integrations" tab. Within Channels section, find "Microsoft Teams" and click "Add", and "Add".
2. Click "Next" and stay on the "App registration" step

• App registration
  1. Open a new tab, and go to Microsoft Azure App Registration and log in with your credentials.
  2. On the App registrations page, click "New registration". In the "Register an application" page, type a name, select the Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant) , then click "Register".
  3. Copy the Application (client) ID and paste it back to Watson Assistant's "App registration" step 3
  4. Navigate back to Azure App Registration tab, navigate to Overview. In the Essentials section, next to Client credentials, click "Add a certificate or secret".
  5. Click "New client secret"
  6. Complete the form with the recommended 180-day expiration date, or whichever selection best fits your use case, then click "Add".
  7. Copy the string under the value section of the table and paste it back to Watson Assistant's "App registration" step 5.
• Create your bot
  1. In Watson Assistant, Click "Next" to "Create your bot" step.
  2. Go to Microsoft's Bot Framework developer portal and log in with your credentials.
  3. In the "Tell us about your bot" form, fill out your bot profile.
  4. Under the Configuration section, in the Messaging endpoint field, navigate to watson assistant page and copy the Generated endpoint and paste into Messaging endpoint in the "Tell us about your bot" form.
  5. Under the Configuration section, make sure your app type is Multi-Tenant.
  6. In the Microsoft App ID field, paste your Application (client) ID. Agree the terms and Click "Register" to finish.
  7. Click "Ok" and it will show the "Connect to channels" page.
  8. Under Add a featured channel, click "Configure Microsoft Teams Channel". Make the necessary selections under Messaging and Publish sections that best fit your bot needs. Click "Save" to finish. Agree the terms and click "Agree".
• Create your Teams app
  1. In Watson Assistant, Click "Next" to "Create your Teams app" step.
  2. Open a new tab and go to the Developer Portal and log in with your credentials.
  3. Click on the "Apps" tab, and click "New App".
  4. Enter your app name and click Add.
  5. Under Configure -> Basic information, complete the required information
     • App names
     • Descriptions
     • Developer or company name: IBM Client Engineering
     • Website (must be a valid HTTPS URL): https://www.ibm.com/client-engineering
     • Privacy policy: https://www.ibm.com/us-en/privacy
     • Terms of use: https://www.ibm.com/legal
     • Application (client) ID
  6. Click "Save".
  7. Under Configure -> App Features, click "Bot"
  8. In the Select an existing bot dropdown, select the new bot you created in the previous step.
  9. Select the following scopes of use: Personal, Team, and Group Chat. Click Save.
  10. Click Publish in the upper-right corner to publish your bot. Select "Download the app package" or the option that best fits your use case. A zip file will be downloaded.
  11. Navigate back to Watson Assistant page and click "Finish".

Import Bot into Microsoft Teams

1. Open a new tab and go to Microsoft Teams.
2. On the left hand side list, click "Apps".
3. Click "Manage your apps"
4. Click "upload an app"
5. Click "upload a custom app", and select the zip file downloaded from the previous step. Click "Add".
6. Start chatting with the Watson Assistant Bot in Microsoft Teams!