# MS Teams ChatBot Installation
This document provides a complete, user-friendly guide for creating a webhook-triggered Autom in Autom Mate and connecting it to a ChatBot inside Microsoft Teams.
***
## **1. Preparing the Webhook in Autom Mate**
1. Create a new **Autom** in Autom Mate.
2. Set the Autom's **Trigger Method** to **Webhook**.
3. Copy and save the generated **Webhook URL** — it will be required in later steps.
{% hint style="warning" %}
You can find a sample webhook URL below. This example illustrates the format, and note that each webhook is uniquely generated for each Autom:
```
https://qa.betaautommate.com/api/v1/automs/run/9cec7314-6a41-4220-bff5-c41001261d20?apiKey=TQWDK9H-MZMM5X2-G1PRWJ6-B7Y4G69
```
As you may have observed, the webhook URL includes an API Key at the end. If your webhook does not contain an API Key, it will not function. To properly configure your webhook, navigate to the help section (indicated with a “?” at the bottom of the left panel) and select the **Create API Key** tab. If you do not already have an API Key, please generate one before proceeding.
{% endhint %}
***
## **2. Creating the Azure Bot Service**
### **2.1 Login to Azure Portal**
4. Go to and sign in.
5. Click **Create a Resource**.
6. Search for **Azure Bot Service**, select it, and click **Create**.
### **2.2 Bot Basic Setup**
7. Fill in the required fields:
* **Bot Name**
* **Subscription**
* **Resource Group**
8. In **Pricing Tier**, you can select one of them. We continued with Free Plan.
9. In **Type of App**, choose **Single Tenant**.
### **2.3 Create Microsoft App ID**
10. Select **Create new Microsoft App ID**.
11. Proceed with **Review + Create → Create** to complete the bot setup.
***
## **3. Configuring Bot Channels**
12. Once the bot is created, click **Go to Resource**.
13. From the left menu, navigate to **Channels**.
14. Under *Available Channels*, find **Microsoft Teams** and open it.
15. Save without making any changes. After saving it should be appeared like below.
***
## **4. Messaging Endpoint & Identity Information**
### **4.1 Connecting Webhook as Messaging Endpoint**
16. Go to the **Configuration** section.
17. In the **Messaging Endpoint** field, paste the webhook URL you created in Autom Mate. And then click to "Apply" button. Please be careful to apply, sometimes you need to click double to make sure it saved.
### **4.2 Saving Identity Information**
18. On the same page, copy the following for Autom Mate Vault:
* **Microsoft App ID**
* **Tenant ID**
### **4.3 Creating a Client Secret**
19. Click **Manage Password** on the Configuration page.
20. In **Certificates & Secrets**, create a **New Client Secret**.
21. Save the **Secret Value** for later use in the Autom Mate Vault.
***
## **5. Adjusting App Registration Settings**
22. In Azure Portal, open **App Registrations**.
23. Find your bot application under **All Applications** and open it.
24. Go to the **Authentication** menu. Select **Supported Accounts.**
25. Change the supported account type **Multiple Entra ID tenants** and choose **Allow all tenants.** Save the page.
***
## **6. Defining the Application in Teams Developer Portal**
26. Go to (Developer Portal).
27. Click **Create a New App** to create a Teams app container.
### **6.1 Filling in Basic Information**
28. From the left menu, open **Configure → Basic Information**.
29. The following **mandatory fields** must be completed:
| **Category** | **Field** | **Requirement** | **Mandatory** |
| ------------------------- | ------------------------ | ------------------------------------------------------- | ------------------------ |
| **App Names** | Short Name | Must be 30 characters or fewer | **Yes** |
| **Descriptions** | Short Description | Max 80 characters; must differ from long description | **Yes (for submission)** |
| **Descriptions** | Long Description | Max 4000 characters; must differ from short description | **Yes (for submission)** |
| **Developer Information** | Developer / Company Name | Full developer or organization name | **Yes** |
| **Website** | Website URL | Must be a valid HTTPS URL | **Yes** |
| **App URLs** | Privacy Policy URL | Valid link to the privacy policy | **Yes** |
| **App URLs** | Terms of Use URL | Valid link to the terms of use | **Yes** |
After completing these mandatory items, you may fill in optional metadata fields if needed.
***
## **7. Setting Required Permissions**
30. Go to the **Permissions** menu.
31. Expand **Teams Permissions → Application**.
32. Enable the following permissions:
1. **Teams / Application Permissions:**
1. `ChannelMessage.Read.Group`
2. `ChannelMessage.Send.Group`
2. **Chat / Application Permissions:**
1. `ChatMessage.Read.Chat`
2. `ChatMessage.Send.Chat`
33. Save your changes.
***
## **8. Linking the Bot to the Application**
34. Open **App Features** from the left menu.
35. Select **Bot**.
36. Enter your **Microsoft App ID** into the Bot ID field.
37. Under "Scopes," enable all three options:
1. Personal
2. Team
3. Group Chat
38. Save.
***
## **9. Packaging and Validation**
39. Click the **Distribute** button.
40. Select **Download App Package** to download the Teams app package. We will use this package after.
### **9.1 Validation Process**
41. Open the **App Validation** section in the Developer Portal.
42. The interface will automatically display validation results for your bot.
43. You may see **4 validation warnings** — these are non-critical and **can be safely ignored**, as they do not affect deployment.
> Note: The new interface does **not** require uploading the package for validation.
***
## **10. Publishing via Microsoft Teams Admin Center**
44. Go to
45. Navigate to **Teams Apps → Manage Apps**.
46. Click **Upload New App**.
47. Upload the Teams app package downloaded from the Developer Portal.
{% hint style="info" %}
⏳ It may take up to **5 minutes** for the bot to appear inside MS Teams. You can also test instantly using the **Preview in Teams** button inside Developer Portal.
{% endhint %}
***
## **11. Creating Credentials in Autom Mate**
You should now have:
* **Tenant ID**
* **App ID**
* **Client Secret**
48. Create a **Credential Profile** in Autom Mate Vault using these values.
49. After that, turn back to the Autom that we created and saved the webhook. Add a Send Message action inside an Autom from MS Teams Library.
50. Select the Teams credential that you created.
51. Type **"Hello"** into the message field and execute the Autom. Your Teams bot will now respond with **"Hello World!". You can find the example Autom at below; you can download it and then configure credentials. After that you can use this, Autom. Do not forget the set trigger type as webhook.**
**Here is the example Autom that you can download to test.**
{% file src="" %}
