Connect your Gumloop agents to Microsoft Teams channels so your team can chat with AI-powered assistants where they already work.
Connect your Gumloop agents to Microsoft Teams so anyone in a channel can interact with them using a simple @mention.
To add a new secret or save a browser login, finish the request in Gumloop in your browser. Use Add a new secret in Gumloop or Open browser in Gumloop on the Teams card. You can still select existing saved secrets in Teams.
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 (for example, 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
Routines post results in Teams as the agent, not as the person who set them up.Where available, Use in Teams without a Gumloop account lets admins enable Allow users in Teams to use this agent for Registered Microsoft 365 tenants. This setup requires organization sharing, a registered tenant, and a service account with agent-owned connections. These controls appear only when the feature is enabled.
1
Open Channels → Microsoft Teams
Open Channels in the agent sidebar, then select Microsoft Teams.
2
Connect your Microsoft account
If Microsoft account is not connected, connect it. 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 do this once.
3
Install the Gumloop app
Click Install next to Gumloop app for Teams. Install Gumloop in the team where the agent should respond, then open the channel.
Agents can only be added to public (standard) channels. Private channels are not supported.
4
Add the agent from compose
In the channel, click + in the compose box and search for Gumloop. Select the Gumloop app.
Choose Add Agent.
Paste the Agent ID from this page into the Gummie ID field, then click Submit.
If Teams shows Gumloop isn’t in this team yet, click Add to team. When Teams confirms Gumloop is now in this team, select Add again and choose your agent.If Teams says Gumloop can’t post in this channel, ask a Teams admin to check that the Gumloop app is allowed there.
Click the copy button next to the agent ID to copy it.
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.
If you @mention the agent again while it’s responding in that thread, the current response stops and Gumloop processes the new message in the same conversation.
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.
Command
What It Does
Add Agent
Add an agent to the current channel by pasting its agent ID
Remove Agent
Remove the active agent from the current channel
See Active Agent
Show which agent is currently active in this channel
Get Help Using Gumloop Agents
Show available commands and usage instructions
Thread commands
Command
What It Does
!stop
Stop the agent’s current response and prevent further replies in this thread
!link
Get a link to view the full conversation in Gumloop, including tool calls and credit usage
Connectors and accounts
Which account the agent uses
Your Microsoft 365 directory email must match your Gumloop account email, and its domain must be verified by the Microsoft tenant you are sending from. If Gumloop cannot verify the domain, it cannot match your Teams identity to your Gumloop account.The agent uses the account selected for each connector, just as it does in Gumloop chat. Use Personal Default uses the running user’s account; Use Team Default uses a shared team account. An explicitly agent-owned account is used by everyone with access to the agent. See Connectors for all account-selection options.
For existing Gumloop users
If your Microsoft 365 email matches your Gumloop account and its domain is verified by your Microsoft tenant:The agent uses each connector’s selected account setting. You can use the tools you are authorized to access.Example: With Use Personal Default, Gmail and Google Calendar use your personal connected accounts.
For non-Gumloop users
If you’re not yet a Gumloop user, you’ll see a signup prompt the first time you try to use an agent.Turns from people without a linked Gumloop account can’t create or manage triggers or schedules. Gumball’s auto-approval ignores thread messages from people without a linked account.What happens:
Agent responds with a message asking you to sign up
Click the link to create your Gumloop account using your Microsoft 365 email
After signing up, authenticate with the services the agent needs
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.
Connect a missing account
If the agent needs a service you haven’t connected yet:
The agent notifies you about the missing authentication
When you use an agent with personal credentials, only your connected accounts 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. 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
Best practices
Troubleshooting
Choose the Right Channels
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
Set channel expectations
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.
Use descriptive agent names
Give agents clear names so your team knows what each one does:
“Support Ticket Assistant”, “Sales Lead Researcher”
Not: “Agent 1”, “My Bot”
Always @mention the agent
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.
Check required connectors
Before deploying to a team channel: test with your own connected accounts, document which services team members need to authenticate with, and share the Connectors page link.
Combine with event triggers
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.
Agent doesn't respond
Did you @Gumloop the agent in your message? (Required for every message, including thread replies)
Is the Gumloop app installed in the channel?
Has an agent been added using the Add Agent compose command?
Is this a public (standard) channel? (Private channels are not supported)
Have you authenticated with the required services?
Couldn't verify your Microsoft account
Follow the guidance on the card. If it says Try again in a few minutes., wait and retry. If it says your connected account needs to be reconnected, select Reconnect Microsoft Teams in Gumloop, or ask your Gumloop team admin to reconnect it, then retry.
Connect Microsoft Teams to Gumloop
To chat with Gumball in Teams, select Connect Microsoft Teams in Gumloop, sign in, connect your Microsoft Teams account, and retry your message.
Only members of this Microsoft 365 organization can use Gumloop agents here
Ask a member of that Microsoft 365 organization to run the agent for you.
Too many tasks or messages
If Gumloop says You have too many tasks running right now. Try again shortly., wait for an active task to finish before retrying. If it says You’re sending messages too quickly. Please wait a moment and try again., pause before sending another message.
Signup prompt for existing users
Confirm that your Microsoft 365 directory email matches your Gumloop account email. Ask your Microsoft 365 administrator to confirm that the email domain is verified in the tenant you are sending from. If both are correct and the signup prompt persists, contact Gumloop support.
Authentication errors
Visit your Connectors page, authenticate with the required service, and retry. For team agents, contact your team admin.
Couldn't reach Microsoft Teams
If Gumloop says Couldn’t reach Microsoft Teams. Try again in a few minutes., wait a few minutes and retry your message.
Can't install the Gumloop app
Some organizations require admin approval for new Teams apps. Contact your Microsoft 365 admin to approve the Gumloop app, or ask them to add it to the organization’s app catalog.
Agent responses too slow
Limit tools to only what’s necessary, use faster models, or break complex tasks into smaller interactions.
Can't find agent ID
Open Channels → Microsoft Teams and copy the agent ID from the setup page. Make sure you’ve connected your Microsoft account first.
Example use cases
Support channel
Sales channel
Data channel
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.
Agent: Lead Research AssistantChannel: Sales Team (public channel)Common interactions:
Team member: "@Gumloop Research this company: [LinkedIn URL]"Agent: [Enriches lead, checks CRM for activity, drafts outreach]Team member (in thread): "@Gumloop What's the best time to reach out?"Agent: [Analyzes contact data, suggests optimal timing]Team member: "@Gumloop What's the status of opportunities over $50k?"Agent: [Queries Salesforce, summarizes pipeline]
Why it works: Sales reps get instant research without switching tools. Newer reps learn by watching experienced reps use the agent.
Agent: Data Analysis AssistantChannel: Data Team (public channel)Common interactions:
Team member: "@Gumloop Compare Q4 revenue vs Q3 by product line"Agent: [Runs query, generates comparison]Team member (in thread): "@Gumloop Now break it down by region"Agent: [Continues analysis with regional breakdown]Team member: "@Gumloop Flag any anomalies in yesterday's user signups"Agent: [Analyzes data, identifies outliers, reports findings]
Why it works: Analysts get quick answers to data questions. Non-technical team members learn what data is available and how to access it.
FAQ
Do I need a Microsoft 365 work or school account?
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.
Can I add multiple agents to the same channel?
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.
Does my Teams email need to match my Gumloop email?
Yes. Your Microsoft 365 directory email must match your Gumloop email, and the domain must be verified by the Microsoft tenant you are sending from. See Connectors and accounts.
Can I use the same agent in both Slack and Teams?
Yes. An agent can be deployed to Slack, Microsoft Teams, and other external channels simultaneously. Each channel operates independently.
Can I send files to the agent in Teams?
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.
Can I use a custom bot name or avatar in Teams?
No. Unlike Slack (which supports Custom Slack Apps), all agents in Teams respond as @Gumloop. Custom branding is not available for the Teams integration.
Does the agent respond to all messages in a thread?
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.
Is this different from the Microsoft Teams MCP integration?
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.
Do I need admin permissions to install the Gumloop app?
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.
Can I refresh my Microsoft Teams connection?
Yes. If your agent stops responding, go to the Microsoft Teams channel page in Gumloop and click Refresh to re-authenticate your connection.
How do I remove an agent from a Teams channel?
Open the compose menu in the channel, choose Gumloop, then select Remove Agent. This clears the active agent from that channel. You can also check which agent is active by using the See Active Agent 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
Was this page helpful?
Assistant
Responses are generated using AI and may contain mistakes.