Skip to main content
Connect your Gumloop agents to Microsoft Teams so anyone in a channel can interact with them using a simple @mention.

​
Why Use Agents in Microsoft Teams?

Bringing agents to Teams transforms how your team learns and adopts AI automation:

Shared Learning

Visibility by default: Every interaction in a channel becomes a learning opportunity for the team. No more siloed knowledge, everyone sees how to use agents effectively.

Natural Integration

Where work happens: Teams already use Microsoft Teams for communication. Agents integrate seamlessly into existing workflows without requiring new tools.

Collaborative Usage

Team-wide access: Instead of one person running automations, entire teams can leverage the same agent with consistent results.

Instant Adoption

Zero learning curve: If your team knows how to @mention someone in Teams, they know how to use an agent. No training required.
The Learning Effect: When someone asks an agent a question in a channel, everyone sees the interaction. This passive learning accelerates team-wide adoption faster than any training session could.

​
Prerequisites

Before connecting an agent to Microsoft Teams, make sure you have:
  • A Gumloop account with an agent you want to deploy
  • A Microsoft 365 work or school account (personal Microsoft accounts are not supported)
  • Permission to install apps in your Microsoft Teams workspace
Microsoft Teams integration requires a Microsoft 365 work or school account. Personal Microsoft accounts (e.g. outlook.com, hotmail.com) cannot be used because the Microsoft Graph API permissions are only available for enterprise tenants.

​
Adding an Agent to Microsoft Teams

1

Connect Your Microsoft Account (First-Time Only)

Navigate to your agent in Gumloop, then click Microsoft Teams under External Channels in the sidebar.
External Channels sidebar showing Email, Slack, Microsoft Teams, and Hosted Page options
If you haven’t connected a Microsoft Teams credential yet, you’ll see a setup screen prompting you to connect. Click Connect to Microsoft Teams and follow the OAuth flow to authorize Gumloop with your Microsoft 365 account.This links your Microsoft identity to your Gumloop account so the agent can attribute messages to the correct user when someone @mentions it.
You only need to connect your Microsoft account once. After that, you can add any of your agents to Teams channels.
2

Install the Gumloop App

Once connected, you’ll see the setup instructions. Click the Install button to add the Gumloop app to your Microsoft Teams workspace.
Microsoft Teams channel setup page showing three steps: Install the Gumloop app, Use the Add Agent Command, and Start Chatting
After clicking Install, Teams opens a dialog confirming the app was added. Choose the channel where you want the agent to respond and click Go.
Gumloop app successfully added to Microsoft Teams with channel selection dialog
Agents can only be added to public (standard) channels. Private channels are not supported.
3

Add Your Agent Using the Compose Command

From the Teams compose menu in the channel where you installed the app, choose Gumloop, then select Add Agent. Paste the agent ID shown on the setup page and submit.
Click the copy button next to the agent ID on the setup page to copy it to your clipboard.

​
Using Your Agent in Teams

To interact with your agent, @mention Gumloop in any message: 
@Gumloop [your question or task]
You can @Gumloop in a top-level message to start a new thread, or inside an existing thread to continue the conversation.
You must @mention @Gumloop in every message, including thread replies. Unlike Slack, there is no “respond to all messages in thread” mode. The agent only responds when explicitly mentioned.
One agent per channel. Only one Gumloop agent can be active in a channel at a time. To switch agents, remove the current one first, then add the new agent using the compose command.

​
Teams Commands

​
Compose Extension Commands

Teams uses compose extension commands (accessed from the compose menu) instead of Slack-style slash commands.
CommandWhat It Does
Add AgentAdd an agent to the current channel by pasting its agent ID
RemoveRemove the active agent from the current channel
ActiveShow which agent is currently active in this channel
HelpShow available commands and usage instructions

​
Thread Commands

CommandWhat It Does
!stopStop the agent’s current response and prevent further replies in this thread
!linkGet a link to view the full conversation in Gumloop, including tool calls and credit usage

​
Credentials & Authentication

​
How Authentication Works

When you interact with an agent in Teams, the agent uses your personal default credentials, not the agent creator’s credentials. This ensures proper access control and data privacy.
If your Microsoft 365 email matches your Gumloop account:
  1. The agent automatically uses your personal default credentials
  2. You have immediate access to all tools and workflows you’re authorized to use
  3. No additional setup required
Example: If the agent uses Gmail and Google Calendar, it will access your personal Gmail and Calendar using your authenticated credentials.
If you’re not yet a Gumloop user, you’ll see a signup prompt the first time you try to use an agent.What happens:
  1. Agent responds with a message asking you to sign up
  2. Click the link to create your Gumloop account using your Microsoft 365 email
  3. After signing up, authenticate with the services the agent needs
  4. Return to Teams and @Gumloop the agent again
You must use the same email address for Microsoft 365 and Gumloop for the integration to work properly.
If the agent needs a credential you haven’t set up yet:
  1. The agent will notify you about the missing authentication
  2. Visit your Gumloop credentials page
  3. Authenticate with the required service
  4. Return to Teams and retry your request
Recommendation: Always create agents in your personal space unless you need shared team apps or team collaboration features.
Personal Agents (created in personal space):
  • Anyone in the Teams channel can use the agent
  • Each user’s request runs on their own personal credentials
  • Non-Gumloop users will be prompted to sign up
  • Best for most use cases
Team Agents (created in a team):
  • Access control: Only members of that specific Gumloop team can use the agent
  • App behavior: If an MCP integration or app is set to use “team default,” the team apps are used instead of personal apps
  • Non-team members will receive an access denied message
Learn more about the differences between personal and team spaces in the Organizations and Teams documentation.
FeaturePersonal AgentTeam Agent
Who can use it?Anyone in Teams channelOnly team members
Apps usedAlways personal defaultPersonal default OR team default (if configured)
Best forGeneral use, maximum accessibilityTeam collaboration with shared apps
For a full walkthrough on configuring team apps with agents, see Using Team Apps with Agents.

​
Data Privacy & Security

Your Data Stays Private

When you use an agent with personal credentials, only your authenticated credentials are used. Other team members cannot access your personal data through the agent.

Controlled Access

Admin security controls and user roles in Gumloop apply to agents just like they do to workflows. You can only access what you’re authorized to access.

​
Current Limitations

The Microsoft Teams integration has a few differences compared to the Slack integration. These are mostly due to technical limitations in the Teams platform.

No Private Channels

Agents can only be added to public (standard) channels. Private channels in Teams are not supported.

No File Uploads

Agents cannot receive or process file attachments sent in Teams messages. Text-only interactions are supported.

No Custom App Branding

Unlike Slack, there is no custom app option. All agents respond as @Gumloop, so you cannot customize the bot name or avatar.

@Mention Always Required

You must @mention Gumloop in every message, including thread replies. There is no “respond to all messages in thread” mode like in Slack.

​
Best Practices & Troubleshooting

Deploy agents strategically to appropriate channels:Supported channel types:
  • Public (standard) channels
  • Not supported: Private channels, direct messages, or group chats
Example deployments:
  • Support: Customer service agents with ticket triage capabilities
  • Sales: Lead research and enrichment agents
  • Marketing: Campaign planning and content strategy agents
  • Data: Data analysis and reporting agents
When adding an agent to a channel, post a message explaining what the agent can do, how to use it (@Gumloop [your question]), and a quick example. This reduces friction and encourages proper usage.
Give agents clear names so your team knows what each one does:
  • “Support Ticket Assistant”, “Sales Lead Researcher”
  • Not: “Agent 1”, “My Bot”
Unlike Slack, Teams requires an @mention for every interaction, including thread replies. Remind your team that @Gumloop is needed each time they want the agent to respond.
Before deploying to a team channel: test with your own credentials, document which services team members need to authenticate with, and share the credentials page link.
For maximum automation, combine agents in Teams with event-based triggers. The agent handles ad-hoc questions in the channel while triggers automatically process events like new emails, tickets, or database changes.

​
Example Use Cases

Agent: Support Ticket AssistantChannel: Customer Support (public channel)Common interactions:
Team member: "@Gumloop Is ticket #12345 eligible for a refund?"
Agent: [Checks ticket, reads policy, evaluates eligibility]

Team member (in thread): "@Gumloop What about ticket #12346?"
Agent: [Checks ticket #12346]

Team member: "@Gumloop Pull the last 5 interactions with customer@email.com"
Agent: [Searches CRM and email, returns history]
Why it works: Support team gets instant access to information without leaving Teams. Every interaction teaches the team how to use the agent for similar queries.

​
FAQ

Yes. Microsoft Teams integration only works with Microsoft 365 work or school accounts. Personal Microsoft accounts (outlook.com, hotmail.com, live.com) are not supported because the Microsoft Graph API permissions required are only available for enterprise tenants.
Currently, one agent can be active per channel. To switch to a different agent, remove the current one and add the new agent using the Add Agent command.
Yes. The agent matches your Microsoft 365 email to your Gumloop account. If they don’t match, you’ll be prompted to connect your account.
Yes. An agent can be deployed to Slack, Microsoft Teams, and other external channels simultaneously. Each channel operates independently.
No. File uploads are not currently supported in the Teams integration. The agent can only process text messages. If you need file processing, use the Slack integration or the Agent Email Inbox, both of which support attachments.
No. Unlike Slack (which supports Custom Slack Apps), all agents in Teams respond as @Gumloop. Custom branding is not available for the Teams integration.
No. You must @mention Gumloop in every message, including thread replies. The “respond to all messages in thread” mode available in Slack is not supported in Teams.
Yes. This feature lets your team chat with a Gumloop agent inside Microsoft Teams channels. The Microsoft Teams MCP server is the opposite: it lets an agent use Teams as a tool (send messages, create channels, manage meetings) from within Gumloop.
It depends on your organization’s Teams policies. Some organizations require admin approval for new apps. If you can’t install the app, contact your Microsoft 365 admin.
Yes. If your agent stops responding, go to the Microsoft Teams channel page in Gumloop and click Refresh to re-authenticate your connection.
Open the compose menu in the channel, choose Gumloop, then select Remove. This clears the active agent from that channel. You can also check which agent is active by using the Active command from the same menu.

​
Next Steps

Build Your First Agent

Learn how to create and configure agents in Gumloop

Using Agents in Slack

Deploy the same agents to Slack channels

Agent Email Inbox

Give your agent a dedicated email address