Integrating Microsoft Teams

You can integrate Microsoft Teams with the platform to interact with agents directly from Teams. This allows you to use agent capabilities without switching tools.

You can chat with agents you have access to, including shared, organizational, or custom agents. Both direct messages and channel conversations are supported, giving you flexibility in how and where you work with agents.

Set up with ease

The integration requires minimal setup (see the section below). A tenant admin connects Devs.ai once, and the Teams app is then published to your organization for everyone to use.

Switch between chat and agent modes

Use simple devsai text commands to pick a chat model or an agent for a conversation, right from Teams. Each direct message and channel can have its own target.

Improve collaboration

Bring agents into your channels. @mention Devs.ai in a conversation to summarize discussions, answer questions in context, and surface insights, without leaving Teams.

How do I set up the Teams integration?

Setting up the Teams integration takes a few steps. Ensure the following are in place first:

• You must have Company Admin access in Devs.ai.
• You must be a Microsoft Teams / Global administrator in the Microsoft tenant you want to connect. The connect flow requires admin consent to publish the app to your organization's app catalog.

Step 1: connect and consent

1. On the left sidebar, click Organization > Integrations to open the Integrations page. Or, go to https://devs.ai/org-integrations.
2. Click Connect for Microsoft Teams. You'll be redirected to the Microsoft sign-in and admin-consent page.

3. Sign in as a tenant administrator and review the requested permissions. These permissions let Devs.ai publish the Teams app to your organization.
4. Click Accept to grant admin consent. You'll be redirected back to the Integrations page, which now shows Teams as connected.

Step 2: verify the app in the Teams admin center

After consent, Devs.ai publishes the app to your organization's Teams app catalog. To confirm:

1. Go to the Teams admin center → Manage apps.
2. Search for DevsAI.
3. Confirm the app appears and its status is Allowed (not Blocked). Make sure your app permission and setup policies allow custom apps for the users who need it.

Step 3: add the app in Teams

After consent, Devs.ai publishes the app to your organization's Teams app catalog. Microsoft then propagates it to Teams clients on its own schedule, so it may not appear instantly. There are two ways to get to it:

1. Built for your organization — go to Teams → Apps → Built for your organization and add DevsAI from there.
2. Search for it — open the Teams Apps panel and search for DevsAI, then add it. The app is usually findable through search before the "Built for your organization" section repopulates, so this is typically the quickest way to start.

⚠️ Allow time for provisioning: A newly published app is not always available immediately. Microsoft can take from a few minutes up to 24 hours to propagate catalog changes to all clients. If the app doesn't appear yet, wait and try again — searching the Apps panel and using the Teams web client (teams.microsoft.com) in a fresh session usually surfaces it sooner than the cached desktop app. If it's still missing after ~24 hours, it is usually a policy issue (the app is blocked, or a permission/setup policy isn't allowing custom apps for your user) rather than propagation lag.

How do I use the app in a direct message?

Open a direct message with DevsAI in Teams and send a message. New conversations use the provisioned default agent or model until you change it.

To change the target for the current DM, use the devsai commands:

• devsai help — open a picker to choose Chat mode (a model) or Agent mode (an agent).
• devsai status — show the model or agent currently serving this DM.
• devsai models [search] — list available chat models (optionally filtered) and pick one.
• devsai agents [search] — list available agents (optionally filtered) and pick one.
• devsai chat <modelId> — switch this DM to chat mode with a specific model.
• devsai agent <agentId> — switch this DM to agent mode with a specific agent.

Your selection sticks to that DM, so follow-up messages continue with the same model or agent until you change it again.

How do I use the app in a channel?

Add DevsAI to a team, then @mention it in a channel to start a conversation. Agents can provide context-sensitive answers and conversation summaries. Replies in the same thread continue the conversation without re-mentioning.

You can set a per-channel default so new mentions use a specific model or agent. Channel commands are the same as in a DM, but you must @mention the app:

• @DevsAI devsai help — choose the channel's default Chat mode or Agent mode.
• @DevsAI devsai status — show the channel's current default.
• @DevsAI devsai models [search] / @DevsAI devsai agents [search] — list and pick a model or agent.
• @DevsAI devsai chat <modelId> / @DevsAI devsai agent <agentId> — set the channel's default.
• @DevsAI devsai remove-default — clear the channel default and fall back to the provisioned default.

📝 Note: In channels the app responds mention-only — it replies when you @mention it or in an ongoing thread it has joined, so it won't respond to every message.

How do I log in to use personal agents and authorize connectors?

⚠️ Temporarily unavailable: The personal login flow for Teams is not ready yet and is temporarily disabled. The login / connect / auth commands may not complete successfully. Until it ships, you can use public and organization agents and chat models; private/personal agents and connector authorization that require linking your account are not yet available in Teams. This page will be updated when the flow is enabled.

By default, the app only lists public and organization agents. To use your private/personal agents — and to let agents act on your behalf — connect your Devs.ai account:

1. In a direct message with DevsAI, send login (you can also use connect or auth).
2. The app replies with a personal authorization link. Open it and sign in to Devs.ai.
3. Approve the request, then return to Teams and message the app again.

Once connected:

• devsai agents now includes your private agents in addition to public and organizational ones.
• Agents run as you, so any MCP server connectors your agents use are authorized with your identity. The first time an agent uses a connector that needs your authorization, you'll be prompted to grant access (for example, the Slack or Microsoft services connectors).

📝 Note: Your login is scoped to your user in this Teams workspace. If your session expires or access is revoked, the app will ask you to run login again.

Command reference

Command	Where	What it does
login (or connect, auth)	DM	Connect your Devs.ai account to unlock personal agents and connector authorization. (Temporarily unavailable — see note above.)
devsai help	DM / channel	Open the Chat mode / Agent mode picker.
devsai status	DM / channel	Show the active model or agent.
devsai models [search]	DM / channel	List and pick a chat model.
devsai agents [search]	DM / channel	List and pick an agent.
devsai chat <modelId>	DM / channel	Switch to chat mode with a model.
devsai agent <agentId>	DM / channel	Switch to agent mode with an agent.
devsai remove-default	channel	Clear the channel default.

📝 Note: In channels, prefix every command with an @mention, for example @DevsAI devsai help.