Microsoft Teams Integration

Install the Assemble Teams app in your Microsoft 365 tenant, then bind agents to Teams channels and use DMs for one-on-one conversations.

How setup works

Assemble owns the Azure Bot registration. Your Microsoft admin does not create an Azure Bot or paste bot credentials into Assemble.

An Assemble operator packages the Teams app from packages/backend/teams-manifest.
A Microsoft 365 admin uploads that app package in Teams Admin Center.
The admin approves the app for the tenant.
A user adds the bot to a team, channel, group chat, or DM.
The bot posts a Finish setup in Assemble card.
An Assemble workspace owner opens that link and chooses the workspace to connect.

Prerequisites

A Microsoft 365 tenant where you can upload custom Teams apps
Permission to approve apps in Teams Admin Center
An Assemble workspace where you are an owner

Install

Open Assemble → Settings → Integrations
Click Microsoft Teams
Download the Assemble Teams app package provided by Assemble
In Teams Admin Center, open Teams apps → Manage apps → Upload new app
Upload the zip and approve it for your tenant
Add the Assemble bot to a team, channel, group chat, or personal chat
Click Finish setup in Assemble in the card the bot posts
Choose the Assemble workspace to connect

The v1 bot uses Bot Framework messaging permissions for Teams conversations. If email auto-link is enabled, the Microsoft admin must also review and grant the app permission needed to read a user's email for account matching. If that permission is not granted, Assemble falls back to the magic-link flow.

Bind an agent to a channel

After the tenant is connected:

Open the agent detail page in Assemble
Open Chat channels
Pick a Teams channel the bot has been added to
Mention the bot in that channel

Messages in that channel route to the bound agent. Teams always shows the bot identity as Assemble; the agent name and avatar appear in the Adaptive Card body.

Direct messages

DM the bot for a one-on-one conversation.

The first DM links your Teams user to your Assemble account by email when possible.
If email matching is unavailable, the bot sends a magic link.
If you have access to multiple agents, the bot asks you to choose one.

Troubleshooting

The bot did not post a setup card

Confirm the app was approved in Teams Admin Center.
Confirm the bot was actually added to a team, channel, group chat, or DM.
Ask an Assemble operator to verify the Teams webhook endpoint and Microsoft bot environment variables.

The setup link expired

Add the bot to a Teams conversation again to generate a fresh setup link.

I cannot claim the tenant

Only Assemble workspace owners can complete the claim step. Ask a workspace owner to open the setup link.

Microsoft Teams