Microsoft Teams

​

Capabilities

​

Examples

​

Inbound chat

​

Tool approval

​

Setup

​

Distribute to other tenants

1. Download the app package. In the Novu dashboard, open the Teams integration on your agent and download the multi-tenant app package. The same package works in every tenant.
2. Upload it in each tenant. A Teams admin opens Teams admin center → Teams apps → Manage apps, chooses Actions → Upload new app, and confirms its status is Allowed.
3. Allow it in the permission policy. In Teams apps → Permission policies, the admin allows custom apps, or allowlists this app, in the policy assigned to users. If this step is skipped, users see “This app is not available”.
4. Grant admin consent. A Global Admin of each tenant opens the admin consent link shown in the dashboard once.
5. Users connect from your app. Users in that tenant connect with MsTeamsConnectButton, and the bot installs for them.

​

Connect component

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

// userId: the signed-in user's id from your app's auth session
export function TeamsConnect({ userId }: { userId: string }) {
  const subscriberId = userId;
  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>
  );
}

​

Related