From e86f190a6a7851b8ca942da39a9bd48822120a14 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Wed, 25 Mar 2026 04:20:35 +0000 Subject: [PATCH] docs(TSP-1098): update Teams integration docs for marketplace-approved Bot App - Add Check callout highlighting Microsoft marketplace approval status - Update intro to emphasize two-way real-time conversations and DM support - Strengthen Step 2 with explicit Bot App framing and add DM setup tab - Update trigger section to describe bidirectional conversation flow - Add three new FAQ entries: what is the Bot App, where can I use it, how to DM - Update existing DM FAQ to be more specific about setup steps - Update use cases to reflect real-time conversation capabilities Co-Authored-By: Claude Sonnet 4.6 --- .../popular-integrations/microsoft-teams.mdx | 71 ++++++++++++++----- 1 file changed, 54 insertions(+), 17 deletions(-) diff --git a/integrations/popular-integrations/microsoft-teams.mdx b/integrations/popular-integrations/microsoft-teams.mdx index e61d4ec8..83ab0715 100644 --- a/integrations/popular-integrations/microsoft-teams.mdx +++ b/integrations/popular-integrations/microsoft-teams.mdx @@ -4,10 +4,12 @@ description: "Microsoft Teams is a collaboration platform that combines workplac sidebarTitle: "Microsoft Teams" --- -With Relevance AI's Microsoft Teams integration, you can connect your Teams workspace to your AI agents, enabling them to monitor channels, respond to messages, and automate communication workflows directly within Teams. +With Relevance AI's Microsoft Teams integration, you can connect your Teams workspace to your AI agents, enabling two-way conversations in real-time. Users can interact with AI agents directly in Teams — through channels, group chats, or direct messages — without leaving the platform. Agents monitor messages, respond in real-time, and automate communication workflows across your organization. Relevance AI uses a unified Microsoft authentication that works across **Teams**, **Outlook**, **SharePoint**, and **OneDrive** — connecting one account gives you access to all services. +The Relevance AI Bot App is officially approved on the Microsoft marketplace and available to install directly from within Teams. + ## Prerequisites Before setting up the Microsoft Teams integration, ensure you have: @@ -22,8 +24,8 @@ Before setting up the Microsoft Teams integration, ensure you have: Enterprise organizations may require admin consent (see [Admin consent & permissions](#admin-consent-permissions)) - - At least one channel or chat where you want your agent to operate + + At least one channel, group chat, or direct message where you want your agent to operate @@ -44,7 +46,7 @@ Before setting up the Microsoft Teams integration, ensure you have: ## Step 2: Install the Relevance AI app in Microsoft Teams -After connecting your Microsoft account, you need to install the Relevance AI app in Teams so your agents can interact with channels and chats. +After connecting your Microsoft account, install the Relevance AI Bot App from the Microsoft marketplace so your agents can interact with channels, group chats, and direct messages. @@ -52,13 +54,13 @@ After connecting your Microsoft account, you need to install the Relevance AI ap - Search for **Relevance AI**, then click **Add** or **Install** to add it to your workspace. + Search for **Relevance AI**, then click **Add** or **Install** to add the Bot App to your workspace. If you don't see an install button, your organization may require admin approval. See [Admin consent & permissions](#admin-consent-permissions). - - After installing, add the app to each channel or chat where you want your agent to operate. + + After installing, add the app to each location where you want your agent to operate. The Bot App supports three contexts: @@ -73,19 +75,30 @@ After connecting your Microsoft account, you need to install the Relevance AI ap 3. Search for and select **Relevance AI** 4. Add the app to the chat + + To use the bot in a 1:1 direct message conversation: + + 1. In the Teams search bar at the top, search for **Relevance AI** + 2. Under **People**, select the **Relevance AI** bot + 3. Send the bot any message to open the conversation — this establishes the DM connection and makes it appear as a trigger option in Relevance AI + + Once you've sent a message, the DM will appear in the channel/chat selection dropdown when setting up triggers. + - **Important:** The app must be added to every channel and chat where you want your agent to respond. Triggers will not work for channels without the app. + The app must be added to every channel or chat where you want your agent to respond. Triggers will not work for locations where the app has not been added. - Confirm the Relevance AI app appears in the channel's app list and that the channel shows up in the trigger setup dropdown in Relevance AI. + Confirm the Relevance AI app appears in the channel's app list and that the channel or chat shows up in the trigger setup dropdown in Relevance AI. ## Set up Microsoft Teams as a trigger -You can configure your agents to automatically respond to Teams messages by setting up a trigger. Your agent will process messages in real-time as they are posted. +You can configure your agents to automatically respond to Teams messages by setting up a trigger. When a message is received, your agent processes it and replies in real-time — creating a two-way conversation between the user and your AI agent directly within Teams. + +Triggers work across channels, group chats, and direct messages with the bot. **Important:** Teams triggers activate only on new messages. They do not trigger on new chat creation, group creation, or webhooks. @@ -95,7 +108,7 @@ You can configure your agents to automatically respond to Teams messages by sett 1. Navigate to your agent in Relevance AI and go to the **Triggers** section. 2. Click **Add Trigger** and select **Microsoft Teams** from the list. -3. Choose the Microsoft account you connected, then select the **Team** and specific **channel** or **chat** you want to monitor. +3. Choose the Microsoft account you connected, then select the **Team** and specific **channel**, **group chat**, or **direct message** you want to monitor. 4. Optionally, set up **keyword matching** to filter which messages activate your agent. Leave the keyword field empty to trigger on all messages, or enter specific keywords separated by commas. 5. In the **Core Instructions** section, write a prompt that guides how your agent should respond — including its role, tone, and when to respond. @@ -179,16 +192,16 @@ The Microsoft Teams integration provides actions your agents can use as tool ste - Monitor your IT support channel and automatically respond to common technical questions, provide troubleshooting steps, and escalate urgent problems. + Monitor your IT support channel and respond in real-time to common technical questions, provide troubleshooting steps, and escalate urgent problems — all through natural two-way conversation. - Welcome new team members, answer questions about company policies, share relevant documentation, and guide new hires through their first week. + Welcome new team members via DM, answer questions about company policies, share relevant documentation, and guide new hires through their first week directly in Teams. - Monitor customer inquiries, provide initial responses, search for relevant case history, and route complex issues to the appropriate team member. + Monitor customer inquiries across channels and chats, engage in real-time conversation to gather context, and route complex issues to the appropriate team member. - Log deal updates to your CRM, remind team members of follow-up tasks, and post daily pipeline summaries. + Log deal updates to your CRM, remind team members of follow-up tasks, and post daily pipeline summaries to your sales channels. @@ -222,6 +235,30 @@ If you see "Need admin approval" or "This app requires admin approval", follow t ## Frequently asked questions (FAQs) + + The Relevance AI Teams Bot App is an officially approved application available on the Microsoft marketplace. It enables two-way conversations between Teams users and your AI agents — users can message the bot directly in channels, group chats, or direct messages, and your agent responds in real-time within Teams. + + + + The bot works in three contexts within Microsoft Teams: + + - **Channels** — add the app to a channel and your agent can monitor and respond to messages there + - **Group chats** — add the app to a group chat for your agent to participate in group conversations + - **Direct messages (DMs)** — users can open a 1:1 conversation with the Relevance AI bot and interact with your agent privately + + Each location requires the app to be added separately before triggers will work there. + + + + To start a DM with the Relevance AI bot: + + 1. In the Teams search bar, type **Relevance AI** + 2. Under **People**, select the **Relevance AI** bot + 3. Send any message to open the conversation + + Once you've sent a message, the DM will appear in the channel/chat selection dropdown when setting up triggers in Relevance AI. + + The Microsoft Teams integration was built by Relevance AI and is supported by our team, not Microsoft. If you have a question or issue, please [reach out to our support team](/get-started/support). For Microsoft Teams-specific issues, contact [Microsoft support](https://support.microsoft.com/). @@ -258,8 +295,8 @@ If you see "Need admin approval" or "This app requires admin approval", follow t The integration requires permissions to read messages, send messages, and access team/channel information. The exact permissions are shown during the OAuth flow. You may need admin consent depending on your organization's policies. - - Yes, Teams triggers can monitor both channel messages and private chats, depending on your configuration. + + Yes, Teams triggers can monitor channels, group chats, and 1:1 direct messages with the bot. To enable DM triggers, first send a message to the Relevance AI bot in Teams to establish the connection, then select that DM when configuring your trigger in Relevance AI.