---
title: "Connecting MS Teams to the SysAid AI Agent Builder"
slug: "connecting-ms-teams-to-the-sysaid-ai-agent-builder"
updated: 2026-01-30T05:28:49Z
published: 2026-01-30T05:28:49Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.sysaid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting MS Teams to the SysAid AI Agent Builder

Integrating the AI Agent Builder with MS Teams transforms how teams communicate and collaborate.

Whether it’s handling employee requests, managing customer inquiries, or surfacing critical insights, an MS Teams-integrated AI agent enhances productivity and responsiveness.

In this article, we’ll walk you through the process of connecting the AI Agent Builder with your MS Teams account.

## Connecting MS Teams with the Builder

The connection process consists of these main steps:

1. Creating a bot app for MS Teams.
2. Editing the bot app in Azure.
3. Adding the bot app to the MS Teams account.
4. Adding the app details in SysAid.
5. Testing the Connection.

Follow these steps to set up and connect your SysAid AI Agent Builder with the **Microsoft Teams API Connection**.

### Step 1: Creating a bot app for MS Teams

1. Go to the [MS Teams Developer Portal](https://dev.teams.microsoft.com/).
2. Navigate to **Tools**> **Bot Management.**
3. Click**+New bot.**
4. Give your bot a name. For example, “SysAid Bot”.
5. Click **Create bot**.
6. Go to Client secret and click **+ Create your first client secret.**
7. Click **Create client secret**.
8. Copy the secret and save it. You will need this later on.
9. Click **Done.**
10. Click **Import app**.
11. Download this zip file and upload it to the portal.

[](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/SysAid MS Teams AI Agent.zip)SysAid MS Teams AI Agent20.63 KB[**](https://cdn.document360.io/52d3cb6c-cc81-43c2-b6f7-cbabcb449271/Images/Documentation/SysAid MS Teams AI Agent.zip)
12. Give your app a name. For example, “SysAid App”
13. Click **Create**.
14. Under **Configure**, go to **Basic information**.
15. Fill in the required fields: descriptions, developer information, and app URLs.
16. Click **Save**.
17. Go to **App features** and select **Bot**.
18. Select an existing bot and choose the SysAid bot you created from the drop-down menu.
19. Under **Select the scopes where people can use your bot**, select Personal, Team, and group chat.
20. Click **Save**.
21. Go to **Domains**and add your Microsoft Entra ID domain.

> [!TIP]
> Tip!
> 
> You can find your Microsoft Entra ID domain by going to **Azure** > **Microsoft Entra ID**> **Overview**and copy the **Primary domain** value
22. Click **Confirm**.
23. Click **Save**.
24. Click on **Distribute** in the top right corner and select **Download app package**. You’ll need the downloaded file later on.

### Step 2: Editing the bot app in Azure

1. Go to **Azure** > **Microsoft Entra ID**> **App registration**.
2. Find the SysAid bot you created and select it.
3. Go to **API permissions** and click **+ Add permission**.
4. Select **Microsoft Graph**.
5. Under **Application permissions**, select the following permissions:
  1. `User &gt; User.Read.All`
  2. `Chat &gt; Chat.Create`
  3. `Chat &gt; Chat.Read.All`
6. Click **Add Permission**.
7. Select **Grant admin consent**to finalize permissions.

### Step #3: Adding the bot app to the MS Teams account

1. Go to the [Microsoft Teams admin center](https://admin.teams.microsoft.com/service-unavailable).
2. Navigate to **Teams apps**>**Manage apps**.
3. Click on **Actions**in the top right corner and select **+ Upload new app**.
4. Upload the SysAd app package you downloaded earlier.

> [!TIP]
> Tip!
> 
> If you want the app to be part of the user setup: 1. Go to **Teams apps** > **Setup policies**. 2. Select **Global (org-wide default) 3.**Under**Installed apps,**click**+ Add apps. 4.**Search for the SysAid app and add it.

### Step #4: Adding the app details in SysAid

1. In your SysAid account, go to **Settings** > **SysAid AI Agents**> **AI Agents Builder**.
2. Select the **Microsoft Teams API Connection** from the list to the left.
3. Open a new tab and go to the [Azure Portal](https://portal.azure.com/).
4. Navigate to **Microsoft Entra ID** and select the SysAid app you created.
5. Go to the **Overview**and copy the **Application (client) ID**.
6. Back in SysAid, paste this in the **Microsoft Bot Framework Application (Client) ID** field.
7. Paste the Secret Key you’ve saved earlier in the **Microsoft Bot Framework Application Client Secret (Password)** field.

> [!TIP]
> Tip!
> 
> You can also find it in the **Certificated & secrets** section of the app in Azure.
8. In Azure, in the **Overview** section, go to **Manage** > **Custom domain names**.
9. Copy the name with an “Available” status and paste it into the **Azure Active Directory tenant ID**field in SysAid.
10. Open a new tab and go to the [Microsoft Teams admin center](https://admin.teams.microsoft.com/service-unavailable).
11. Navigate to **Teams apps**>**Manage apps**.
12. Select the app you just created.
13. Go to the **About**tab and copy the **App ID**.
14. Back in SysAid, paste this in the **Teams Store/Teams Catalog App ID** field.

### Step #5: Testing the Connection

Once all the details are in place:

1. Click on **Test**in the AI Agent Builder.
2. Wait for confirmation that the test was successful.
3. Click **Publish**.

You are now ready to leverage the SysAid AI Builder’s capabilities to automate workflows and enhance productivity.

> [!WARNING]
> Please note:
> 
> If the test fails, please recheck the details and try again. If the issue persists, [contact support](https://helpdesk.sysaid.com/servicePortal/submitIncident).

## Next steps

You can now use the prebuilt AI Agents. To view all available prebuilt AI Agents, see [Prebuilt AI Agents Overview](https://documentation.sysaid.com/docs/prebuilt-ai-agents-overview#ms-teams). You can also create your own AI Agent from scratch using the[AI Agent Builder](https://documentation.sysaid.com/docs/ai-agent-builder-guide).

To learn which API capabilities are available for MS Teams, go to [Microsoft Learn](https://learn.microsoft.com/en-us/graph/permissions-reference).
