Connect Microsoft Teams

Admin4 min read

Last verified 2026-11-18

Connect Microsoft Teams across your workspace to analyse customer signals in shared channels with automated domain matching and privacy safeguards.

Before you start

  • ValueRamp Admin role
  • A Microsoft 365 administrator who can approve access for your organisation (needed once)

Connecting Microsoft Teams lets ValueRamp pick up risks, expansion signals and feature requests directly from the channels you share with customers.

The Microsoft Teams integration is configured at the workspace level. Open Settings → Workspace Integrations (/integrations) and choose the Microsoft Teams tile; its page is at /integrations/teams. Connecting or disconnecting Teams requires the Admin role in ValueRamp.

The Microsoft Teams page has two tabs: Overview and Channels. Until Teams is connected only Overview opens, and Channels is locked. The page header shows Disconnect only while the status is Connected, and Reconnect only while it is Errored. While the status is Needs admin approval, the header has no buttons; use Get admin approval and Reconnect in the strip on the Overview tab.

Connecting Microsoft Teams

Reading channel messages and members needs a Microsoft 365 admin to approve access once for your organisation. The Microsoft Teams page walks you through it:

  1. Sign in with Microsoft: Click Sign in with Microsoft. You're taken to Microsoft to sign in and approve read access to channel messages and members. Nothing is written to Teams. If you're a Microsoft 365 admin, you can approve for your whole organisation here.
  2. Get admin approval: If you're not a Microsoft 365 admin, do this step together with your admin first: they click Get admin approval and approve access for the organisation. The page then reads "Admin approval received. Now sign in with Microsoft to finish connecting." — sign in as in step 1.
  3. Once you're signed in, ValueRamp returns you to the Microsoft Teams page (/integrations/teams) and the status badge shows Connected.

The status badge can also read:

  • Needs admin approval: Microsoft granted the sign-in but not channel access yet. Click Get admin approval, then Reconnect.
  • Errored: ValueRamp cannot reach Microsoft with the stored sign-in, or the last sync failed. Nothing is analysed until an Admin reconnects.
  • Disconnected: Teams was disconnected. No new messages are analysed, and what was already analysed stays on its accounts.

Connected, the page shows your Microsoft tenant ID, who connected it, the time of the last sync, how many customer channels it reads and how many messages it has analysed, and explains how a channel is picked up.

The Channels tab is a read-only record of what the last sync read: the names of the first five customer channels, a count of any more, and a count of internal channels, which are not read and whose names are never kept. You cannot map channels by hand. If there is no customer channel yet, the tab says so.

How matching works

ValueRamp reads messages exclusively from customer-facing channels, applying automated domain validation:

  • Channel Membership: ValueRamp reads the teams that the Microsoft account used to connect belongs to. Make sure that account is a member of the team that holds the channel you share with your customer; a teammate being in it is not enough.
  • Customer Domain Matching: When the background sync checks a channel, ValueRamp looks at the email domains of the channel's members. If at least one member's domain matches the domain of one of your accounts, the channel is a Customer channel and new messages are analysed.
  • Internal Channels Skipped: Any channel containing only members from your own internal organization is completely skipped. The page counts these as internal channels that are not read.
  • Sync Cadence: New messages posted in monitored customer channels are fetched and analyzed approximately every five minutes.
  • Analysis switches: The Analysis switch box on the Overview tab says On or Off. It is read-only and links to Communication settings (Engines → Conversation intelligence), where the Chat (Slack, Teams) switch lives. It reads Off when that switch is off, when Communication Intelligence is off, or when the workspace is set to Regulated industry. An individual account can also be set to Do not analyse.

Privacy and Data Security

ValueRamp enforces strict data minimization at the API level:

  • Channels only: ValueRamp never reads direct messages (1:1 DMs) or private multi-party group chats.
  • No historical backfill: Messages sent before your connection was established are never read. Ingestion starts only from the timestamp of connection.
  • Unmatched message disposal: Messages that don't match a customer domain are dropped, and their text is discarded.

Disconnecting Teams

An Admin can disconnect Microsoft Teams at any time:

  1. Open the Microsoft Teams page (/integrations/teams).
  2. Click Disconnect. It is shown while the status is Connected.
  3. A dialog titled Stop reading Teams channels? says that nothing already analysed is deleted and that raw message text still expires on your retention schedule. It also says you can remove ValueRamp under your Microsoft 365 admin centre's Enterprise applications.
  4. Confirm with Disconnect, or choose Cancel to keep the connection active.
The Microsoft Teams integration page header showing the Not connected status and the Sign in with Microsoft setup button

1 / 4Open the Microsoft Teams tile and check its status and the Sign in with Microsoft button

Steps

  1. Open the Microsoft Teams tile and check its status and the Sign in with Microsoft button

    The Microsoft Teams integration page header showing the Not connected status and the Sign in with Microsoft setup button
  2. Sign in with Microsoft to grant channel read permissions

    The Overview tab highlighting Step 1 Sign in with Microsoft with the Sign in with Microsoft button and channel read access explanation
  3. Request tenant-wide administrator approval

    The Overview tab highlighting Step 2 Get admin approval with the Get admin approval button and tenant admin consent instructions
  4. Make sure the connecting account is in the team with the customer channel, and check the privacy safeguards

    The Overview tab highlighting Step 3 Add yourself to any channel that has a customer in it and the privacy safeguards stating direct messages, private group chats, and internal-only channels are never read

Common questions

Who can connect Microsoft Teams to ValueRamp?

Connecting Microsoft Teams requires the ValueRamp Admin role. A Microsoft 365 administrator must also approve tenant-wide permissions once during initial setup.

What is the difference between 'Sign in with Microsoft' and 'Get admin approval'?

'Sign in with Microsoft' connects Teams and asks for read access to channel messages and members. Microsoft 365 requires an admin to approve that access once for your organisation: a Microsoft 365 admin can approve it while signing in, and anyone else uses 'Get admin approval' with their admin first, then signs in.

Which Teams channels are monitored?

ValueRamp only reads channels you belong to that include at least one member whose email domain matches the domain of one of your accounts. Internal channels with only company staff are never read.

How quickly do new Teams messages appear in ValueRamp?

Channel messages are synchronized in the background approximately every five minutes and matched to customer account timelines.

Does ValueRamp record Teams meetings or allow replying into Teams?

No. ValueRamp does not capture Teams meeting recordings or post replies into Teams channels. Channel monitoring is strictly read-only for message sentiment and signal analysis.

What happens when an Admin disconnects Microsoft Teams?

Disconnecting Teams stops background synchronization immediately. Existing messages, signals, and timeline notes remain safely preserved on your customer accounts, and raw message text expires according to your configured data retention policy.

Was this helpful? Tell us what was missing