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.”

Ensure the byline matches the name of your Power Apps connector.

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.

It could take up to a couple of hours for the app to populate in the list once it has been created.

---

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!