> ## Documentation Index > Fetch the complete documentation index at: https://docs.rootly.com/llms.txt > Use this file to discover all available pages before exploring further. # Rootly AI in Microsoft Teams > Turn on Rootly AI in Microsoft Teams with one toggle, then mention @Rootly in incident channels, team channels, and chats to run incidents from Teams. Rootly AI in Microsoft Teams is the same [Rootly AI agent](https://docs.rootly.com/ai/communication-channels/overview.md) that runs in Slack, with the same tools, permissions, and confirmation cards. This page covers Teams setup and where to find Rootly AI in Teams. For how the agent works on every platform, see [Using Rootly AI](https://docs.rootly.com/ai/communication-channels/using-rootly-ai.md). ## Prerequisites * The [Microsoft Teams integration](https://docs.rootly.com/integrations/microsoft-teams.md) is connected via OAuth, and the Rootly bot is installed in each team where you want to use Rootly AI. * You are an Incident Response Owner or Admin with an Incident Response seat. Once Rootly AI in Microsoft Teams is on, anyone with an [Incident Response role](https://docs.rootly.com/ai/communication-channels/overview.md#who-can-use-rootly-ai) who has [linked their Microsoft Teams account](#link-your-microsoft-teams-account) can use it. *** ## Turn On Rootly AI in Microsoft Teams Setup is one toggle in Rootly. There's no need to reconnect the Microsoft Teams integration or re-approve permissions. **1. Turn on Rootly Agent in Microsoft Teams** In Rootly, open **AI & Agents**. Confirm **Opt in to Rootly AI capabilities** is on under **Global**, then toggle **Rootly Agent in Microsoft Teams** on under **Features**. > [!NOTE] > > The Microsoft Teams toggle is separate from **Rootly Agent in Slack**, so admins can turn Rootly AI on or off in each chat tool independently. ### Link Your Microsoft Teams Account Each user links their own Microsoft Teams account to Rootly before using Rootly AI in Teams. This is how Rootly AI knows who's asking and applies that person's Rootly permissions. **1. Open Linked Accounts** In the Rootly web app, open your profile and go to the [**Linked Accounts**](https://rootly.com/account/users/edit?tab=linked_accounts) tab. **2. Connect Microsoft Teams** Under **Microsoft Teams**, sign in with your Microsoft 365 work account. Once linked, the section confirms your account is connected. > [!TIP] > > Ask responders to link their accounts when you turn Rootly AI on, so nobody has to do it mid-incident. Linking also lets them receive pages and shift reminders as direct messages from the Rootly bot. *** ## Where to Use Rootly AI in Microsoft Teams Mention `@Rootly` and ask in plain language. Rootly AI replies in the same conversation. | Where | Can it act? | Best for | | :- | :- | :- | | **Incident channel** | Yes, the full action set | Running the incident: updates, paging, roles, and comms where the whole team sees them | | **Team channel** | Questions, declaring new incidents, paging, and schedule overrides | Declaring an incident, paging a team, or asking about on-call from your team's usual channel | | **Chat with Rootly** | Questions, declaring new incidents, paging, and schedule overrides | On-call lookups and overrides, incidents you're not actively in, personal questions like "What action items are assigned to me?" | Changes to an existing incident, such as its severity, status, roles, and action items, happen in that incident's own channel. Private incidents can only be discussed inside their own channel and stay hidden everywhere else. Every surface requires an [Incident Response role](https://docs.rootly.com/ai/communication-channels/overview.md#who-can-use-rootly-ai). Your Rootly permissions govern which incidents and Rootly records you can see. ### Choosing a Rootly Organization If your Microsoft 365 tenant is connected to more than one Rootly organization, Rootly AI asks which organization you mean when it can't tell from context, rather than guessing. Pick the organization from the card and Rootly AI continues with your request. ### Manual Paging You can still page without the agent. Use the **Page** command from the Rootly app's **+** / **Actions** menu in any Teams channel where the Rootly app is installed. See [Page from Microsoft Teams](https://docs.rootly.com/integrations/microsoft-teams.md#page-from-microsoft-teams). ### Long Forms When a request needs more than six required fields, such as resolving an incident with many required custom fields, Rootly AI sends you to the Rootly tab in Teams to finish the form there. *** ## Your First Interaction Mention `@Rootly` in a team channel and ask it to declare an incident. Rootly AI replies in the thread with a link to the new incident's channel. Keep asking in the same thread, or move to the incident channel to run the incident. ![Rootly AI in a Microsoft Teams channel: a user asks "@Rootly Open a new SEV3 incident: checkout latency spiking in prod", Rootly replies in the thread that the incident was declared with a link to its channel, and the user types a follow-up question in the thread](https://mintcdn.com/rootly/_krR3MvhhDIsS2iA/images/ai/teams_ai_declare_incident.webp?fit=max\&auto=format\&n=_krR3MvhhDIsS2iA\&q=85\&s=faab394dcc768d783fd41fb342340c2b) ### Try These First * "Catch me up" * "Who's on call?" * "Escalate to SEV1" * "What are the open action items?" *** ## Teams-Specific Troubleshooting | What you're seeing | The fix | | :- | :- | | `"AI agent is not enabled for this team."` | An admin opens **AI & Agents**, turns on **Opt in to Rootly AI capabilities** and **Rootly Agent in Microsoft Teams**. | | Rootly AI doesn't recognize you or won't act on your behalf | Your Microsoft Teams account isn't linked to Rootly. Link it from the [**Linked Accounts**](https://rootly.com/account/users/edit?tab=linked_accounts) tab of your Rootly profile. | | `@Rootly` doesn't appear or doesn't respond in a channel | The Rootly bot isn't installed in that team. [Install the Rootly bot](https://docs.rootly.com/integrations/microsoft-teams.md#part-2-install-the-rootly-bot) in the team, then try again. | | Rootly AI asks which organization to use | Your tenant is connected to more than one Rootly organization. Pick the right one from the card. To switch later, mention `@Rootly change organization`. | | Changing an action item fails with "not found" | You're in a different incident's channel. Make the change from the channel of the incident the action item belongs to. | For issues that apply on every platform, see [Troubleshooting](https://docs.rootly.com/ai/communication-channels/troubleshooting.md). *** ## Related Pages > [card] [AI Agent in Communication Channels](https://docs.rootly.com/ai/communication-channels/overview.md) > > What Rootly AI is and everything it can do. > [card] [Using Rootly AI](https://docs.rootly.com/ai/communication-channels/using-rootly-ai.md) > > How clarification cards work and how actions run. > [card] [What to Use Rootly AI For](https://docs.rootly.com/ai/communication-channels/what-to-use-rootly-for.md) > > The full catalog of prompts, grouped by use case. > [card] [Microsoft Teams Integration](https://docs.rootly.com/integrations/microsoft-teams.md) > > Connect Teams, install the Rootly bot, and set up On-Call in Teams. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.