Connect Microsoft Teams
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:
- 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.
- 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.
- 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:
- Open the Microsoft Teams page (
/integrations/teams). - Click Disconnect. It is shown while the status is Connected.
- 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.
- Confirm with Disconnect, or choose Cancel to keep the connection active.

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

Sign in with Microsoft to grant channel read permissions

Request tenant-wide administrator approval

Make sure the connecting account is in the team with the customer channel, and check the privacy safeguards

Common questions
Who can connect Microsoft Teams to ValueRamp?
What is the difference between 'Sign in with Microsoft' and 'Get admin approval'?
Which Teams channels are monitored?
How quickly do new Teams messages appear in ValueRamp?
Does ValueRamp record Teams meetings or allow replying into Teams?
What happens when an Admin disconnects Microsoft Teams?
Was this helpful? Tell us what was missing