Microsoft Teams

Use Microsoft Teams as a messaging channel for your agent. Novu keeps conversation context, shows typing during the turn, can update a plan card in place, can attach files on replies, and posts Adaptive Card approvals for gated tools.

Capabilities

Full matrix: Channels overview.

Examples

Inbound chat

A user messages the agent in Teams. Novu adds an eyes reaction, shows typing, updates a plan card while tools run, then replies with action buttons.

Tool approval

Gated tools surface as an Adaptive Card (Deny, Approve once, Always allow this tool). The turn resumes after the user selects an option.

Setup

Teams provider credentials and app packaging are configured in the Novu dashboard when you add the Microsoft Teams provider.

Connect component

Use MsTeamsConnectButton from @novu/react so end users can admin-consent and link Teams to your agent from your product UI. In subscriber mode, autoLinkUser defaults to true so the per-user Teams identity is linked after consent.

import { NovuProvider, MsTeamsConnectButton } from '@novu/react';

export function TeamsConnect() {
  const subscriberId = 'subscriber-id';
  const integrationIdentifier = 'msteams-integration-identifier';

  return (
    <NovuProvider
      applicationIdentifier={process.env.NEXT_PUBLIC_NOVU_APPLICATION_IDENTIFIER!}
      subscriberId={subscriberId}
    >
      <MsTeamsConnectButton
        integrationIdentifier={integrationIdentifier}
        connectionMode="subscriber"
        connectLabel="Install agent ↗"
        connectedLabel="Connected to MS Teams"
        onConnectSuccess={() => {
          // Workspace linked
        }}
        onConnectError={(error: unknown) => {
          console.error(error);
        }}
      />
    </NovuProvider>
  );
}

If auto-link fails after consent, use MsTeamsLinkUser as a follow-up step. Full prop reference: Connect components.

Related