---
title: Microsoft Teams
sidebar_label: Microsoft Teams
---

Microsoft Teams (MS Teams) is a collaboration platform that provides a digital workspace for various teams within the organisation to communicate and work together. The team members can have conversations, share files, images, video, audio, and schedule meetings. It includes chat, video meetings, file storage, and application integration to provide a secure, collaborative environment for teams to work together.

In this article, you will learn:
1. [How to set up MS Teams using Developer portal](#portal)
2. [How to connect Teams app with your bot](#connet)
3. [How to set permissions on Azure portal](#azure)

## 1. Set up MS teams using Developer portal

To set up MS teams using Developer portal, follow these steps:

1. Open MS Teams.


2. Navigate to **Apps** and search for **Developer Portal**.


3. Open **Developer Portal**.


4. Navigate to **Tools > Bot Management**.


5. Click **+ New Bot** to set up a bot.


6. To set up the bot, follow these steps:

6.1. Enter the bot's name and click **Add**.


6.2 To define a messaging endpoint, use the below URL and click **Save**.
`https://app.yellowmessenger.com/integrations/botframework/{<botID>}`


6.3 Go to **Client secrets** and click **Add a client secret for your bot**.


6.4 Copy the **Client secret** and save it for future reference.


6.5 Go back to **Bot management** and copy the Bot ID.

:::note
The bot Id is required for configuration.
:::


7. Navigate to **Apps** to create a **New app**. Click **+ New app**.


8. Enter the name of your app.


9. Enter the following details that are required for your app:
* **Short Name**: Enter a name for your bot app.
* **Full Name**: Enter a full name for your bot app (it can be the same name as short name).
* **Short Description**: Enter a short description for your bot app.
* **Long Description**: Enter a long description for your bot app.
* **Version**: Enter the version number. For example, 1.0.0.
* **Developer or Company Name, Website, Privacy Policy & TnC**: Ask Enterprises to use their details
* **Application ID**: Paste the application ID, which you have copied from the Step 6.5, and click **Save**.

<img src="https://i.imgur.com/CytFL5J.jpg)" alt="drawing" width="80%"/>

10. Navigate to **Branding** under **Configure** to change the available branding options.


11. Navigate to **App Features** under **Configure** and select **Bot**.


I. Select your bot name from the drop-down.
II. If you want to enable file sharing, enable the **Upload and download files** check box.
III. Select **Personal** under the scope.
IV. Click **Save** at the bottom.


12. To install and distribute app, navigate to **Publish > App package**.


13. Click **Publish** and select an option based on your enterprise policy.


I. If it does not work, then download the Manifest zip file.
II. Go to `https://admin.teams.microsoft.com`.
III. Navigate to **Teams Apps > Manage Apps** and Upload app.


## 2. Connect your Teams app with a bot

To configure the Channel on the Yellow.ai platform, follow below sreps:

1. On the switcher click **Channels** > **Microsoft Teams**.

2. Add below details:
* Profile Id (for your reference)
* Client ID from Step# 6.4
* Client Secret from Step# 6.5


3. Now you are ready to use MS team with Yellow.ai bot. Test by sending a message using "app.sendTextMessage()".
4. Go back to MS Teams.
5. Search the **App** under **Apps**.
6. Click **Add** to start a conversation with the bot.


## 3. Set permission on Azure portal

After connecting the Teams app with your bot, you need to set permissions on the Azure portal to execute certain use cases based on the business requirements. Follow these steps:

1. Login to `https://portal.azure.com`.
2. Navigate to **App Registration**.
3. Click on the app created with the same name as your MS Teams bot.


4. Navigate to the **Overview** screen. Make a note of the client and tenant IDs and click on **Redirect URLs**.


5. Click **Add a Platform > Web**.


6. Add `https://app.yellowmessenger.com/integrations/azureauth`URL under **Redirect URIs**, enable the **Access Token** check box, and click **Configure**.


7. Navigate to **API Permissions > Add Permission > Microsoft Graph**.


8. To add the permissions for your app as per business requirements, select the permission type you want to provide: <br/>* **Application Permissions**: This enables the app to use the services without any user’s authorization. The app work with its credentials.<br/>* **Delegated Permissions:** This requires users to authorize the app to work on their behalf. Once approved, the app contains the privileges of authorising users for the defined scope.


9. Click **Add Permissions**.


:::note
You need to grant the admin's consent as per the defined permissions.
:::

10. The permission has been successfully added to your app.