Skip to main content
The Microsoft Teams integration captures messages from the Teams channels you choose and feeds them into Modem for analysis. Messages are grouped into topics, classified by type (bug, feature request, praise, complaint), and linked to the people and companies who sent them.
Microsoft Teams is in beta and enabled per organization. If you don’t see it under Settings → Integrations, email support@modem.dev to request access.
Teams is capture-only. Modem ingests channel messages, including replies, edits, deletions, reactions, and @mentions. It does not capture 1:1 or group chats (DMs), and there is no way to talk to the Modem Agent from inside Teams. You query captured Teams data from the Modem Agent on the web.

​
How it works

Modem connects to your Microsoft 365 tenant with an app-only Microsoft Graph app that a tenant administrator approves once. After you subscribe specific channels, Modem uses Graph change notifications to receive a signal whenever someone posts, then fetches the message and ingests it in real time. Graph channel subscriptions expire after about an hour, so Modem runs a background loop that renews them continuously and recreates any that lapse. This means capture is self-healing after a brief outage, but a prolonged outage has a gap: Microsoft does not replay missed notifications, so messages posted during a long interruption are not captured automatically. You can recover them with a manual history import within the 30-day window.

​
Prerequisites

  • A Microsoft 365 work or school tenant (personal Microsoft accounts are not supported)
  • A Microsoft tenant administrator to grant admin consent during setup
  • Owner or admin role in your Modem organization
  • Beta access enabled for your Modem organization (see the note above)

​
Setup

1

Start the connection

Go to Settings → Integrations → Microsoft Teams in your Modem dashboard and click Connect Microsoft Teams. Only organization owners and admins can connect.
2

Grant admin consent

You’ll be redirected to Microsoft to sign in and approve the permissions Modem needs. This step requires a tenant administrator. See Permissions below for the exact scopes. If your tenant blocks consent for unverified publishers, an admin may see a warning during approval.
3

Wait for channel sync

Back in Modem, your teams and their channels sync automatically. This populates the channel list so you can choose what to monitor. You can re-run it anytime with Sync teams.
4

Subscribe to channels

Channels start unmonitored. Toggle on the channels you want Modem to capture. See Subscribing to Channels below.
5

Import history (optional)

Click Import history to backfill the last 30 days of messages from your subscribed channels. See Importing History below.

​
Permissions

During admin consent, a tenant administrator approves the following application (app-only) Microsoft Graph permissions. Modem reads message content and basic directory information; it does not send messages or modify anything in your tenant. Modem authenticates as the approved app and does not store any per-user sign-in tokens. Consent is tenant-wide and can be revoked at any time from the Microsoft Entra admin center, or by disconnecting in Modem.
Each Microsoft tenant can be connected to one Modem organization, and each organization can have one active Teams connection. To connect a different tenant, disconnect the current one first.

​
Subscribing to Channels

Channels are not captured by default. After connecting, open Settings → Integrations → Microsoft Teams and subscribe the channels you want Modem to monitor. Each channel has its own toggle, and the page shows how many of your channels are currently subscribed. Subscribing a channel starts real-time capture for that channel. Replies and threads within a subscribed channel are captured along with root messages.
  • Support or help channels where customers and users raise issues
  • Feedback or ideas channels for feature requests
  • Bug-report channels for user-reported problems

​
Channels to Avoid

  • Internal team-only or admin channels (unless relevant)
  • Bot or automation channels
  • Off-topic or social channels (high noise, low signal)
Start with a few high-signal channels and expand based on what’s useful. You can change your channel selection anytime.

​
Importing History

To capture conversations from before you connected, click Import history on the integration settings page. Modem backfills recent messages from every subscribed channel, so subscribe the channels you care about first. Import limits:
  • Up to the last 30 days of messages
  • Up to 500 messages per channel
One import runs at a time, and progress (channels processed and messages imported) is shown live on the settings page. Imported messages that overlap with live capture are automatically deduplicated, so running an import after messages have already streamed in won’t create duplicates.

​
Analyzing Teams Conversations

Once messages are flowing, ask the Modem Agent about them from the web dashboard like any other source.

​
Troubleshooting

The integration is in beta and enabled per organization. Email support@modem.dev to request access. Once enabled, the Microsoft Teams card appears under Settings → Integrations.
Modem discovers channels using app-only access. Depending on your tenant’s policies, some private or shared channels may not be visible and are skipped. Standard channels sync normally. Try Sync teams to refresh the list.
Teams subscriptions expire roughly hourly and Modem renews them continuously, so brief interruptions recover on their own. Microsoft does not replay notifications missed during a longer outage, so use Import history to recover messages from the affected window (within the last 30 days).
Message text, mentions, reactions, and threads are captured. File attachments point to SharePoint and require Microsoft authentication, so their contents may not be fully accessible in Modem yet.
A Microsoft tenant can only be linked to one Modem organization. If the tenant was previously connected to another organization, contact support@modem.dev.

​
Disconnecting

To disconnect Microsoft Teams:
  1. Go to Settings → Integrations → Microsoft Teams
  2. Click Disconnect and confirm
Disconnecting removes the stored connection and stops channel-message capture for your organization. Live subscriptions stop being renewed and lapse within about an hour. To fully revoke Modem’s access on the Microsoft side, remove the app’s consent from the Microsoft Entra admin center. Historical data remains in Modem after disconnecting.

The Modem Agent

Query and act on your captured Teams conversations from the web.

Topics

See how messages are grouped into themes and classified.

Companies & People

Understand how Modem links message authors into unified profiles.

All Integrations

Browse every data source and agent tool.