Skip to content

W-23599998-teams-integration-fa #522

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
failup wants to merge 3 commits into
base: latest
Choose a base branch
from
Open

W-23599998-teams-integration-fa #522

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
0f9fcb3
Create exp-teams-integrate.adoc
failup Jul 29, 2026
00e021b
W-23599998-teams-integration-fa
failup Aug 4, 2026
ca2b923
Update nav.adoc
failup Aug 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
104 changes: 104 additions & 0 deletions modules/ROOT/pages/exp-teams-integrate.adoc
View file
Open in desktop
Comment thread
failup marked this conversation as resolved.
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
= Integrate the Enhanced Experience with Microsoft Teams
:keywords: microsoft teams integration, mulesoft agent, teams bot, mcp server, anypoint platform, enhanced experience

Install the MuleSoft Agent for Teams app in your Microsoft Teams tenant to interact with Anypoint Platform directly from Teams using natural language. The Teams app enables you to:

* <<connect-teams-tenant>>: Bind your Microsoft Teams tenant to your Anypoint organization so the bot can route messages.

@rcyriac-spec rcyriac-spec Jul 29, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we remove the use of the word "bot" to describe the app?

"so the app can send alerts and notifications directly to channels and DMs."

* <<begin-using-agent>>: Manage your MuleSoft environment with the MuleSoft Agent integrated with Teams. Use MuleSoft Agent to list APIs, view MCP servers, check governance, and perform other management tasks.
Comment thread
failup marked this conversation as resolved.
* Configure alerts to deliver notifications to Teams channels. For instructions, see xref:exp-alerts-configure-notifications.adoc[].
Comment thread
failup marked this conversation as resolved.

NOTE: This tool uses generative AI, which can produce inaccurate or harmful responses. Review for accuracy and safety before using.

[[connect-teams-tenant]]
== Connect Your Microsoft Teams Tenant to the MuleSoft Organization

You must be a MuleSoft organization administrator and a Microsoft Teams administrator to connect the Teams integration.

@rcyriac-spec rcyriac-spec Jul 29, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If they are not a Teams administrator, they can send a request to their teams admin to approve the app


Each MuleSoft organization can connect to only one Microsoft Teams tenant, and each tenant can connect to only one MuleSoft organization.

. Log in and go to *Notifications* > *Settings*.
. In *Microsoft Teams Setup*, choose one of the following installation methods:
+
* *Install Microsoft Teams app*: Publishes the Teams app to your AAD tenant's app catalog through Microsoft Graph. If the tenant hasn't yet consented to this app, you're redirected to Microsoft to grant admin consent. Use this method for most organizations.
* *Bind a side-loaded Teams app*: Use only when a Teams administrator has already side-loaded `teams-app.zip` in Teams Admin Center because tenant policies block automated publish. This records the tenant-to-organization binding so the bot can resolve identity.

@rcyriac-spec rcyriac-spec Jul 29, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"app"

@happykumarmittal happykumarmittal Aug 4, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

do we want to mention it in docs ? i am not sure if it will work.

. Select your Microsoft Teams admin account.

@rcyriac-spec rcyriac-spec Jul 29, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Did this information come from engineering?

@failup failup Aug 4, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I got it from the demo video. If this changed i'd love to see the new path!

. Review the permissions requested and click *Accept*.
+
The app requests the following permissions:
+
* Read and write to all app catalogs
* Maintain access to data you have given it access to
* View your basic profile
+
. After the installation completes, the confirmation page displays *Microsoft Teams integration installed*. Click *Back to Settings*.
+
In *Notifications* > *Settings*, the *Microsoft Teams Setup* section now shows *Installed* and displays the bound tenant ID.

After installation, the MuleSoft Agent app appears in Microsoft Teams Admin Center under *Manage apps* as available to everyone and unblocked.

To disconnect the integration, click *Disconnect* in the *Microsoft Teams Setup* section.

[[begin-using-agent]]
== Begin Using the MuleSoft Agent

[IMPORTANT]
====
MuleSoft Agent is available on request. To get access, contact your account executive.
====

Before getting started, make sure you have:

* An Anypoint Platform account with access to the enhanced experience.
* Agentforce enabled in your Anypoint Platform and Salesforce organizations by your administrator.
* The *MuleSoft Omni Agent for Anypoint* permission assigned to your user.
+
For more information, see xref:exp-home-start.adoc#permissions[Enhanced Experience Permissions].

To assign the *MuleSoft Omni Agent for Anypoint* permission across business groups:

@rcyriac-spec rcyriac-spec Jul 29, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is now named MuleSoft Agent AI User


. Log in to Anypoint Platform and open *Access Management*.
. Select the business group where you want to assign the permission.
. Find the user and assign the *MuleSoft Omni Agent for Anypoint* permission.
. Repeat for each business group that requires access.

To start using the agent in Teams:

. Open Microsoft Teams and go to *Apps*.
. Under *Built for your organisation*, find *MuleSoft Agent* and click *Add*.
. Click *Open* or select a channel where you want to use the app.
. The agent sends a welcome message. Select a prompt suggestion or type a message to start.
. If it is your first time using the agent, the bot prompts you to connect your Anypoint account. Click *Connect to Anypoint* and sign in with your Anypoint Platform credentials. This is a one-time setup.

@rcyriac-spec rcyriac-spec Jul 29, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This isn't one time step, it'll occasionally ask them to reconnect

@happykumarmittal happykumarmittal Aug 4, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It should not ask occasionally for connected apps ( same as slack)


After you authenticate, you can use the agent to list APIs, agents, MCP servers, view governance reports, and more.

NOTE: After the first 24 hours, you must @mention the MuleSoft Agent in channels to send it a message. In direct messages, you can send messages to the agent at any time without @mentioning it.

[[available-prompts]]
== Available Prompt Suggestions

When you open the MuleSoft Agent, the following prompt suggestions are available:

* *Help*: Shows available commands.

@rcyriac-spec rcyriac-spec Jul 29, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We've update these, but do we need to share this in the documentation?

@happykumarmittal happykumarmittal Aug 4, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1

anyways current commands in code

"commands": [
{"title": "signin", "description": "Connect your MuleSoft account"},
{"title": "signout", "description": "Disconnect your MuleSoft account"},
{"title": "What business group am I in?", "description": "What business group am I in?"},
{"title": "List APIs in my business group", "description": "List APIs in my current business group"},
{"title": "Risks across my portfolio?", "description": "What risks exist across my portfolio?"},
{"title": "Top MCP token spend this week", "description": "Which MCP servers had the highest token spend this week?"},
{"title": "Which agents have instances?", "description": "Which agents have instances?"},
{"title": "Top API error rates (7 days)", "description": "What APIs have the highest error rates over the past 7 days?"},
{"title": "feedback", "description": "Send feedback to the MuleSoft Agent team"},
{"title": "help", "description": "Show available commands"}
]

* *Agents*: Lists AI agents in your organization.
* *Apis*: Lists APIs in your organization.
* *Mcps*: Lists MCP servers in your organization.
* *Governance*: Views a governance report.
* *Signin*: Connects your Anypoint account.

[[common-use-cases]]
== Common Use Cases for the MuleSoft Agent

You can use the MuleSoft Agent to perform these platform tasks in Teams:

* *Receive alerts*: Receive alerts to channels or direct messages (DMs). For more information, see xref:exp-alerts-configure-notifications.adoc[].

@happykumarmittal happykumarmittal Aug 4, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we supports only channels

* *Find services by capability*: Use natural-language search to discover APIs, agents, LLMs, and MCP servers.
* *Run governance, monitoring, and cost drill-ins*: Generate governance, monitoring, and cost reports on request.
* *Take governance actions*: Apply policies and apply cost management recommendations.

[[see-also]]
== See Also

* xref:exp-home-start.adoc[]
* xref:exp-overview.adoc[]
* xref:exp-slack-integrate.adoc[]
* xref:exp-claude-desktop-connect.adoc[]