> For the complete documentation index, see [llms.txt](https://guides.mangoapps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.mangoapps.com/ai-guide/bring-your-own-assistant/integration-with-microsoft-teams.md).
# Integration with Microsoft Teams
Connecting AI Assistants with Microsoft Teams via OpenAPI Schema
### Overview
This guide walks you through the process of integrating an AI Assistant (with OpenAPI access enabled) into Microsoft Teams via Microsoft Copilot Studio. The integration is achieved by creating a Power Apps custom connector, configuring it with the Assistant’s OpenAPI details, and then wiring it into a Copilot Studio Agent.
***
### High-Level Steps
1. Enable OpenAPI Access for your AI Assistant.
2. Create a Power Apps custom connector using the Assistant’s OpenAPI schema.
3. Create an Agent in Copilot Studio.
4. Add your custom connector as a tool in the Agent.
5. Enable and publish the Agent as an application.
6. Add the Agent application to Microsoft Teams.
***
### Detailed Walkthrough
#### 1. Enable OpenAPI Access
Locate the AI Assistant you want to connect.
Toggle on **Enable OpenAPI Access.**
Copy the OpenAPI JSON URL (you will need this for Power Apps).
***
#### 2. Create a Power Apps Custom Connector
Log in to your **Microsoft Power Apps dashboard** and navigate to **Custom Connectors**.
Click **+ New Custom Connector > Import an OpenAPI from URL**.
Paste your AI Assistant’s **OpenAPI JSON URL** and provide a **name** for your connector.
Configure the connector’s security settings:
* Client ID
* Client Secret
* Authorization URL
* Token URL
* Refresh URL
Copy the connector’s Redirect URL (from the **Security tab**).
Return to your MangoApps AI Assistant’s OpenAPI Access settings and paste this Redirect URL into the Callback URL field.
***
#### 3. Create an Agent in Copilot Studio
Open Copilot Studio and create a new Agent.
In the Agent’s settings, go to the **Tools** tab.
Add a new tool by searching for “Fetch assistant answer for user query.”
{% hint style="danger" %}
Ensure the byline matches the name of your Power Apps connector.
{% endhint %}
Add this tool to the Agent.
***
#### 4. Configure Topics in Copilot Studio
Navigate to the Topics tab and create a new **Topic from Blank**.
Configure the Topic steps as follows:
1. Trigger: “A message is received.”
2. Step 1: Add a tool → Connector → select “Fetch assistant answer for user query.”
3. Step 2: Add a message → set it to output queryAnswer.message.
4. Step 3: Add an action → End all topics.
**Save** and **Publish** the Agent.
***
#### 5. Enable Teams Channel
Navigate to the Agent’s **Channels** tab.
Select **Teams and Microsoft 365 Copilot** and add the channel.
Under **Availability options**, select **Show to everyone in my org**.
Submit for admin approval.
***
#### 6. Approve & Deploy in Microsoft Teams Admin Center
To approve and deploy the assistant, an Admin must go to the **Teams Admin Center**.
Navigate to **Teams apps > Manage apps**.
Under **All apps**, search for the **name** of your Copilot Agent.
Approve and publish the app.
{% hint style="warning" %}
It could take up to a couple of hours for the app to populate in the list once it has been created.
{% endhint %}
***
#### 7. Add the App in Microsoft Teams
Open Microsoft Teams and navigate to **Apps > Built** for your org.
Find your newly created Agent app and add it.
Your AI Assistant is now available to employees directly within Microsoft Teams!
.png?alt=media&token=0aa264b0-781c-4813-8658-f846a1922d93)
.png?alt=media&token=e0237c03-1d6a-447a-8654-f65d865fb23f)
a.png?alt=media&token=fa104c5c-d1e1-42a1-8c39-da5213978204)
