Skip to main content
Microsoft Teams is the collaboration hub within Microsoft 365, used by organizations for messaging, meetings, and file sharing. Connecting it to Duvo enables two things: your Agents can read and send Teams messages, manage channels, and schedule meetings — and you can trigger Agents directly from Teams by mentioning @Duvo in any channel or chat.

​
Setup

Microsoft Teams has a four-step setup: installing the Duvo app in your organization’s Teams catalog, approving it in the Teams Admin Center, linking your personal Teams account, then adding the Duvo app to your own Teams so Duvo can message you directly.

Install the Duvo app for your organization

This step adds the Duvo bot to your organization’s Teams app catalog. A Duvo team admin starts the process.
  1. Go to the Connections page and open Microsoft Teams.
  2. Click Add to Teams under the Organization section.
  3. Sign in with your Microsoft work account when prompted.
  4. If your Microsoft organization allows it, the Duvo app is submitted to your Teams catalog automatically.
If your organization requires admin approval: Some organizations restrict which apps can be added. If you see a “Need admin approval” screen from Microsoft:
  • Click Request access on the Microsoft screen.
  • Your Microsoft admin will receive the request and can approve it in the Azure portal.
  • Once approved, come back and click Add to Teams again.

Approve the app in the Teams Admin Center

After Step 1, the Duvo app may need approval from a Teams administrator before it becomes available.
  • The Duvo connection page shows Pending admin approval while waiting.
  • A Teams administrator approves the app in the Teams Admin Center under Manage apps.
  • Once approved, the status updates to Connected automatically the next time anyone visits the connection page.

Link your personal Teams account

After the organization app is approved, each user links their own Teams account to enable Duvo to act on their behalf.
  1. On the Teams connection detail page, click Enable under the Your Account section.
  2. Sign in with your Microsoft work account and grant the requested permissions.
  3. Your account status changes to Connected with your email shown.

Add the Duvo app to your own Teams

Linking your account in Step 3 tells Duvo who you are in Teams. It does not give Duvo anywhere to reach you. Messages from Duvo arrive in a one-to-one chat with the Duvo app, and that chat only exists once you add the app for yourself.
  1. Open Microsoft Teams and click Apps in the left sidebar.
  2. Search for Duvo and open the app.
  3. Click Add to add it for yourself. Teams opens a chat with Duvo.
  4. Send the chat any message — “hello” is enough — to confirm it is open.
Duvo now appears in your Teams chat list, and Duvo can message you there.
This is the step people miss. A linked account with no Duvo chat looks connected from the Duvo side, but there is no conversation to deliver into, so nothing arrives.
The Duvo app only appears in your Teams app list after a Teams administrator has approved it (Steps 1 and 2). If you cannot find it, ask your administrator to check Manage apps in the Teams Admin Center.

​
Enabling the Teams trigger for an Agent

Once the organization app is approved and your account is linked, you can enable the Teams trigger on individual Agents:
  1. Open the Agent you want to trigger from Teams.
  2. Go to the Schedule tab and open the Microsoft Teams trigger settings.
  3. Toggle Enable Teams trigger on and save.
Now you can mention @Duvo in any Teams channel or chat to start that Agent.

​
Managing channel and group-chat triggers

Each Teams channel trigger and group-chat trigger row in the agent’s Microsoft Teams trigger settings modal has an on/off switch. The switch takes effect as soon as you flip it. The channel or chat, keyword rule, and Connection stay in place either way.
  • Pause a trigger without deleting it: Turn the switch off. Duvo stops starting Runs from that channel or chat. Turn it back on later to resume without reconfiguring anything.
  • Auto-paused triggers: When a trigger keeps failing because a Connection the agent needs is missing or its access was revoked, Duvo pauses it automatically. Duvo pauses the trigger after 20 consecutive failures, or after 5 consecutive failures spread over at least 5 days. The row then shows an Auto-paused badge and the switch is off. Hover the badge to see why.
To resume an auto-paused trigger:

Restore the Connection

Open the Connections page and reconnect the accounts the agent needs.

Turn the switch back on

In the agent’s Microsoft Teams trigger settings modal, turn the trigger’s switch on. The Auto-paused badge clears, and Duvo starts the agent again on the next matching message.
Turning the switch on clears the auto-pause even if the Connection is still missing. If you resume before reconnecting, the trigger keeps failing and Duvo pauses it again.

​
Capabilities

  • Channel messaging — Send messages, replies, and notifications to specific Teams channels as Duvo. Read message history from channels.
  • Chat conversations — Read and send messages in individual and group chats as Duvo. Create new chats and manage chat membership.
  • Message management — Edit, delete, pin, and react to messages. Mark messages as important. Search messages across chats and channels.
  • Channel management — Create and delete channels, view channel details, and manage channel membership.
  • Meetings — Schedule, update, cancel, and list online meetings with attendees.
  • File operations — Upload, list, and delete files in Teams channel file folders.
  • Team discovery — Browse joined teams and channels, search users by name or email, and look up team rosters.
  • @Duvo trigger — Start any enabled Agent by mentioning @Duvo in a Teams channel or chat. Duvo responds in the conversation with results.

​
How Messages Appear

When an Agent sends a message in Teams, the message comes from Duvo (the bot account), not from the personal account you used to connect. This keeps automated messages visually distinct from messages sent by individual team members. Read operations (browsing message history, searching, looking up team members) continue to use your connected account.

​
Key Benefits

  • Start work from where your team already works — Mention @Duvo in Teams to trigger Agents without switching to the Duvo app.
  • Automated team updates — Agents post results, alerts, and status reports directly to the channels where your team collaborates.
  • Two-way communication — Read incoming messages and respond in context, enabling interactive workflows.
  • Meeting coordination — Schedule and manage online meetings as part of automated processes.
  • Enterprise-grade access — Works with business Microsoft 365 accounts and respects your organization’s permissions.

​
Troubleshooting

The Duvo app was submitted to your Teams catalog but hasn’t been approved yet. Ask a Teams administrator to approve it in the Teams Admin Center under Manage apps. The status updates automatically once approved.
Your Microsoft organization restricts app consent. Click Request access on the Microsoft screen, then ask your Microsoft admin to approve the request in the Azure portal under admin consent requests.
Work through these in order:
  1. Confirm the Teams connection shows Connected (not pending) on the Connections page.
  2. Confirm your personal account is linked (Step 3 above).
  3. Open Teams and check that Duvo is in your chat list. If it is not, add the app for yourself (Step 4) — this is the most common cause, and it is easy to miss because everything else already reads as connected.
  4. Make sure the Duvo chat is not muted in Teams.
Check that:
  1. The Teams connection shows Connected (not pending) on the Connections page.
  2. Your personal account is linked (Step 3 above).
  3. The Teams trigger is enabled on the specific Agent you’re trying to use.
Duvo paused the channel or group-chat trigger because too many recent runs failed for missing Connections.
  1. Reconnect the missing accounts on the Connections page.
  2. Open the agent’s Microsoft Teams trigger settings modal and turn the trigger’s switch back on. The badge clears once the switch is on.
See Managing channel and group-chat triggers.

​
Works Well With

Outlook

Monitor emails for action items, then post summaries or follow-ups to a Teams channel for team visibility.

SharePoint

Pull documents from SharePoint and share them in Teams conversations with relevant context.

Excel

Generate reports in Excel and distribute highlights or key metrics to Teams channels automatically.