# Microsoft (MS) Teams (Azure Bot) MS Teams Azure bot Service provides an integrated development environment for bot building. Its integration with Power Virtual Agents, a fully hosted low-code platform, enables developers of all technical abilities to build conversational AI bots—no code needed. At the end of this document you will learn how to setup a new Microsoft Teams bot. In order to setup MS Teams Azure bot, you need to follow the steps below: ## Create an Azure App (Azure Bot) **NOTE:** The Azure Bot can be created on either Aisera's OR on the customer's Azure portal. * **Aisera Azure Portal:** Aisera has always access to change settings, i.e. messaging endpoint, make branding changes, create new secrets, check for errors, etc. * **Customer's Azure Portal:** Any change needs to be done on the customer's end.

1. Login on [https://portal.azure.com](https://portal.azure.com/) 2. Click on **All Resources**. 3. Choose **Create Resources**. 4. Select **Azure Bot** from the drop down menu.

5\. Set values for the following deployment parameters: * **Bot Handle:** `` * **Subscription:** (select one) * **Resource group:** (create one with the same name as Bot handle) * **New Resource group Location:** West US * **Type of App:** Single Tenant (Multi Tenant is no longer supported by Microsoft. Now you can only choose Single Tenant or User-Assigned Managed Identity.) * Create a new Microsoft App ID **NOTE:** Make sure you create a **new Microsoft App ID**, instead of using an existing app registration. 6. Click the **Create** button. **NOTE:** Please wait for 2-5 minutes until the deployment is complete. Your deployment is complete when you see the following window:

Continue on to set up resources for the bot. 7. Click on **Go to Resource**. 8. Select **Channels**. 9. Choose **Microsoft Teams**.

10\. Select the **MS Teams Workspace** where you want to deploy the application/bot. \ The **Commercial** Workspace is commonly chosen. **NOTE:** For Government organizations, select **Microsoft Team Government**. The configuration is the same for both of these workspaces.

11\. Navigate to the **Bot Profile** wndow to set the required values:

* **Icon:** upload the color icon (png, square, max 30K, 192x192px). * **Display Name:** Set Bot-Name. * **Description:** optional. 12\. Navigate to the **Configuration** window and set the values for: * **Messaging endpoint:** Use your Aisera tenant url as the MS Teams Messaging endpoint. \ \ Example with tenant url as Messaging endpoint: `https:///teams/receive`.\ \ **Vanity URL**\ \ You can use a vanity url such as `https:///teams/receive`. \ In this example, the 'vanity' or custom url is created by adding your bot name as a sub-domain at the beginning of the url.\ \ Example vanity endpoint with bot name as sub-domain: `https://chatbot.acme.aisera.cloud/teams/receive`
* **Microsoft App ID:** Copy this ID, we will use it later.

13\. Navigate to the **Manage** window and get a new Client Secret. 14\. Delete an existing secret. 15 Create a new Client Secret and copy it (we will use it later). 16\. Set the **Expiration** to `24 months`.

### **Create the Manifest** In order to use an app/bot in MS Teams, you need to upload a manifest.zip bundle in a Team workspace.\ Create a .zip archive of the following file: ``` { "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.16/MicrosoftTeams.schema.json", "manifestVersion": "1.16", "version": "1.0.0", "id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", "packageName": "com.package.name", "name": { "short": "Name of your app (<=30 chars)", "full": "Full name of app, if longer than 30 characters (<=100 chars)" }, "developer": { "name": "Aisera Inc", "mpnId": "6234286", "websiteUrl": "https://www.aisera.com", "privacyUrl": "https://www.aisera.com/privacy", "termsOfUseUrl": "https://www.aisera.com/termsofuse" }, "description": { "short": "Aisera automates complex and standard IT requests and HR tasks.", "full": "Aisera automates complex and standard IT requests and HR tasks, directly in Microsoft Teams, so you can work more efficiently using chat. With Aisera GPT you can resolve automatically routine actions via chat, and find answers for frequently asked questions." }, "icons": { "outline": "outline.png", "color": "color.png" }, "accentColor": "#FFFFFF", "staticTabs": [ { "entityId": "conversations", "scopes": [ "personal" ] }, { "entityId": "about", "scopes": [ "personal" ] } ], "bots": [ { "botId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", "scopes": [ "personal", "team", "groupchat" ], "isNotificationOnly": false, "supportsCalling": false, "supportsVideo": false, "supportsFiles": true } ], "validDomains": [] } ``` Ask your Aisera Team for 2 Aisera logos to add to the manifest.zip: * Color.png → Logo 192x192px, full-color icon. * Outline.png → Logo 32x32px, transparent. A useful guide for how to design the icon can be found here: #### **Edit/Create the manifest.json** The manifest contains basic configuration of an app. **Important:** Modify the following fields: * **id:** Use the "Microsoft App Id". * **bots > botId:** Use the "Microsoft App Id". * **name > short:** Display name (by convention: Aisera App (\) * **name > full:** Display name (by convention: Aisera App (\). * **description > short:** You may add a description. \* In case we don't want to display the \ in 'Display Name', please add the cluster it is running on here. * **description > full:** You may add a description. \* in case we don't want to display the \ in 'Display Name', please add the cluster running on here. It's a best practice to use an existing manifest file for a faster approach. Example manifest.json file: ``` { "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.14/MicrosoftTeams.schema.json", "version": "1.0.0", "manifestVersion": "1.22", "id": "8c928e46-6cec-4254-ae2a-19724450eb14", "packageName": "com.package.name", "name": { "short": "New Virtual Agent", "full": "My New Virtual Agent" }, "developer": { "name": "Aisera Inc", "mpnId": "", "websiteUrl": "https://www.aisera.com", "privacyUrl": "https://www.aisera.com/privacy", "termsOfUseUrl": "https://www.aisera.com/termsofuse" }, "description": { "short": "My New Virtual Agent automates complex and standard IT requests and HR tasks.", "full": "This Virtual Agent automates complex and standard IT requests and HR tasks, directly in Microsoft Teams, so you can work more efficiently using chat." }, "icons": { "outline": "outline.png", "color": "color.png" }, "accentColor": "#FFFFFF", "staticTabs": [ { "entityId": "conversations", "scopes": [ "personal" ] }, { "entityId": "about", "scopes": [ "personal" ] } ], "bots": [ { "botId": "8c928e46-6cec-4254-ae2a-19724450eb14", "scopes": [ "personal", "team", "groupchat" ], "isNotificationOnly": false, "supportsCalling": false, "supportsVideo": false, "supportsFiles": true } ], "validDomains": [] } ``` ### **Create a channel in Admin UI and add it to the Aisera app** Use the following steps to create an MS Teams channel for your bot. 1. Create a new MS Teams channel.

2. Set values for the required parameters:

* **Name** * **Microsoft App ID** (from Creating Azure App section) * **Microsoft App Client Secret** (from Creating Azure App section)\ **Important:** makes sure you use the **Secret Value** , NOT the **Secret ID.**

* **Team Tenant ID** (get the Tenant ID from the Teams workspace as shown below) * Navigate to **Teams** in the main navigation menu.

* Select **Get link to team**

* Copy the link after `tenantId=`

3. IMPORTANT: Select the **Is Single Tenant Bot?** checkbox. MS Teams no longer supports Multi-Tenant Bots. 4. Click **OK** and add the channel to the appropriate app in the Aisera Admin UI. #### **Upload the Manifest file on MS Teams** Please use one of the following two options: * Upload through Teams Admin Center OR * Upload through Microsoft Teams client **Upload through Teams Admin Center** 1. Log in to[ https://admin.teams.microsoft.com/](https://admin.teams.microsoft.com/) . You will need an account with the required permission to add the app to a workspace. 2. Navigate to **Teams apps > Manage Apps** and click on **+ Upload new app** and upload the manifest.zip file.

**Upload through Microsoft Teams client** 1. Log in to your company Microsoft teams app. You will need to have permissions to add a custom app. 2. Select **Apps** on the left vertical menu and then select **Manage your apps.**

3. Click on the “Upload an app”, choose “Upload an app to your org’s app catalog” and upload the manifest.zip

4. Find the **Virtual Agent** app in the Microsoft Teams client.

5. Click **Add to a team**.

6. Select a channel and click on **Set up a bot**.