Microsoft Teams

Prerequisites

• A Microsoft 365 Business account (opens in a new tab)
• A Botpress Cloud account (opens in a new tab) and a Botpress bot (opens in a new tab)

Setting up the Microsoft Teams integration in Botpress

1. Go to the Integration Hub (opens in a new tab) in Botpress Cloud (if you don't have the integration installed yet).
2. Find and open the Microsoft Teams integration then click on the "Install to Bot" button, now go back to your bot settings.

The Microsoft Teams integration has the following settings:

• Enabled: Whether Botpress will communicate with Microsoft Teams
• Webhook URL: The URL for receiving data in Botpress.
• App Id: The App Id of your bot in Azure
• App Password: The App Secret of your bot in Azure

Setting up Microsoft Teams

Register App

1. In the Azure portal, open the App registrations (opens in a new tab) page
2. Click New registration, then choose a name for your application
3. In the section Supported account types, choose the type that's most appropriate for your use case. We support Single and Multi Tenant accounts. Check out this article (opens in a new tab) to learn more (in short, Single Tenant means the app will be available for your org only, and Multi Tenant will make it public). After selecting, click Register
4. Copy paste the value of Application (client) ID to the App Id channel configuration in Botpress

App Password

5. Find the Certificates & secrets page in the sidebar, click New client secret, then fill in the required fields
6. Copy the value from the Value column and paste it in the App Secret channel configuration in Botpress
7. Save the settings by clicking the "Save configuration" button

Create Your Microsoft Bot

1. Navigate to the Bot Framework Creation page (opens in a new tab)
2. Fill the Display name and Bot handle fields with whatever value
3. Copy paste you App Id to the app id field
4. Copy the Webhook URL provided in Botpress to the Messaging endpoint field
5. Choose a tenant for the App type. Follow the same type you chose in the Register App section
6. Paste the App ID from the Azure bot in the Microsoft App ID field
7. Read and agree to the terms then click Register
8. On the next page (Connect to channels), under the section, Add a featured channel, click Configure Microsoft Teams Channel, then click Save

Accessing the Bot in MS Teams

1. Navigate to the My Bots page (opens in a new tab)
2. Click on your bot's name
3. Under the Connect to channels section, click on Microsoft Teams
4. The bot should open in your MS Teams

That's it, you may now start chatting with your bot on Microsoft Teams!

Making the bot available in your Organization

1. Add the Developer Portal App to your Teams (or do it via the website)
2. Click the Developer Portal App tab in the sidebar, then Apps. Now click the New app button
3. In the left-side menu of the App, go to the App Features page under the Configure section then click "Bot"
4. Select your existing bot from BotFramework in the dropdown. Check the desired scopes (at least Personal for 1:1 conversations)
5. Fill out all the required fields in the Basic Information page of the Configure section
6. Click Publish, then Publish to your Org
7. Go to your Team App store, search for your app, then add it
8. The bot is now available in the App section to all members of your organization!