Sources
Microsoft Teams app source
Send private messages to the Doorbell app and direct @mentions in standard Teams channels into your mailboxes.
When to use it
Choose Teams when you want to notify an agent about a message you address to Doorbell without building a Power Automate flow or a separate Teams app for each agent.
Example
You @mention the Doorbell app in a standard project channel. Two of your mailboxes route from that installation and match the message. Another team member's mention does not enter your mailboxes.
Set it up
- In Doorbell, open Sources, choose New source, then Microsoft Teams app. If it says Not configured, ask the service operator to enable the Teams integration first.
- Verify your Microsoft identity from that page. This checks your tenant and user identity; it does not authorize mail access or discover every app in your tenant.
- Choose Install in Microsoft Teams when the app is available in the Teams catalog. Otherwise, download the app package from this page and upload the ZIP in Microsoft Teams under Apps → Manage your apps → Upload an app → Upload a custom app. Your organization may first need to allow custom apps. Add the app to your personal chat or to a team; one team installation covers its standard channels.
- In personal chat, send Connect to the app. In a standard channel, choose the app from the @mention suggestions and add Connect. Select Connect on the app's card and approve the Teams identity check, then refresh connected installations in Doorbell.
- In Mailboxes, select a mailbox and open Configure > Routes. Add a route from the linked installation, with optional conditions. Several mailboxes can route from the same installation.
- Grant the mailbox to your agent and add an Inbox trigger if push is needed. Send a fresh private message or structured channel @mention. Check the Teams receipt, Mail, and destination history separately.
Important limits
- Only newly created personal messages to the app and direct app @mentions in standard channels are supported. Ordinary channel text, group chats, private channels, and shared channels are outside this first version. Do not add the app to a private or shared channel for routing.
- Messages route only into mailboxes owned by the linked sender. Installation alone does not authorize every member to route; each customer links their own Teams identity. The app acknowledges capture and does not post the receiving agent's eventual response into Teams.
- Forwarding to the personal bot is a planned path, but live delivery has not been verified. Do not rely on Forward for this pilot.
- Permitted captured content can include message text, verified sender, an exact message link when available, and observed attachment descriptors. Attachment metadata can omit items visible in Teams; file contents and download links are not implemented. The receiving agent can read its granted mailbox or use explicitly selected, bounded notification context.
- A later edit or deletion does not add, retract, or change a captured event. A five-minute Connect challenge works once; start again if it expires.
- A source receipt confirms capture, not notification delivery or completed agent work. Teams follows the same immediate or fixed-batch timing and quiet hours as other sources. Each destination's handoff is independent.
Troubleshooting
- If the Teams card says Not configured, the service operator must supply the Teams app configuration. If Teams says the app cannot be found from an installation link, use the package download and custom upload path or ask your Teams administrator whether the catalog app is available under its app policy.
- If a channel message gets no receipt, verify the app is installed in that team and choose it from the @mention suggestions. Typing its name as plain text does not address the app.
- If Connect does not link the installation, verify the same Microsoft tenant and user in Doorbell and Teams, then request a new Connect card. An expired, replayed, or different user’s challenge cannot link it.
- If Teams acknowledged a message but no notification arrived, inspect the sender's linked installation, the routes from it, their conditions, the mailbox's triggers, notification timing, and destination evidence. One customer's setup cannot route another sender's message.
- If the app was removed, the installation becomes unavailable until it is added again. Other selected sources can continue; pending Teams detail can become unavailable after removal.