Channels
Microsoft Teams
Connect your AI agent to Microsoft Teams so people in your organization can chat with it
Team & CommunityConnecting your agent to Microsoft Teams is like adding a new teammate to your workspace — your coworkers chat with it the same way they message anyone else in Teams. To add it, you download a small app package from Nirvai and install it into Teams.
Before you start
- A saved agent (at least the Profile section saved in the Agent Builder)
- A Microsoft Teams workspace
- Permission to add custom apps in Teams. If you don't have it, your Teams administrator can turn it on for you (Microsoft calls this "sideloading")
tip
Not sure whether you can add custom apps? Try the steps below — if the upload option is missing, that's your sign to ask your Teams administrator to enable it.
Setting up Teams
- Open your agent in the builder (Edit in the Agents center) and choose Channels in the left menu
- Select Microsoft Teams from the Team or community group
- Click Download App Package — a
.zipfile downloads to your computer - Open Microsoft Teams
- Go to Apps → Manage your apps → Upload an app
- Select Upload a custom app and choose the
.zipfile you just downloaded - The agent appears as an app in your Teams workspace, ready to chat
info
If you don't see the Upload a custom app option, your Teams administrator needs to turn on custom apps in the Teams admin center. This is a one-time change.
What your agent can send
| Capability | Supported |
|---|---|
| Respond to messages | ✓ |
| Send text messages | ✓ |
| Send images | ✓ |
| Send files | ✓ |
Managing your connection
- Re-download — Get a fresh app package if you ever need to reinstall the agent in Teams
- Remove — Disconnect Teams from your agent and uninstall the app from Teams
Troubleshooting
| Problem | Fix |
|---|---|
| "Custom apps disabled" | Ask your Teams administrator to allow custom apps (sideloading) in the Teams admin center |
| The app doesn't respond after installing | Remove it, download a fresh package from Nirvai, and install it again |
| I can't find the app after uploading | Look under Built for your org or Personal apps in the Teams app list |
What's next
- API Access — connect your own app to the agent in code.
- Choose a channel — want to reach people outside your organization? Compare the other channels.