For the complete documentation index, see llms.txt. This page is also available as Markdown.

Microsoft Teams

How Spara integrates with Microsoft Teams.

Spara can send notifications to Microsoft Teams channels.

You must be a Manager- or Integrator-level user to manage third party integrations.

Navigate to the Integrations page by clicking on the Settings link in the left hand navigation bar.

Click the "Authorize" button. This will lead you through an OAuth authentication flow. There are no further steps necessary upon completing this flow. You should see that the integration is "Enabled" within Spara's Integrations page.

Step 2: Configure notifications

Once Microsoft Teams is connected, choose which events notify Teams and which channel to send them to from Settings > Notifications. See Notifications.

Permissions and data use

When you connect Spara to Microsoft Teams, the admin consent screen lists the permissions Spara requests. Microsoft's consent dialog shows the maximum scope a permission could theoretically allow (the same broad language shown for many Teams integrations), not what Spara actually does. Spara's Teams integration exists for one purpose: to post automated notifications into the team channels you choose.

Permission
What it grants
Why Spara needs it

offline_access

Stay signed in between sessions (OAuth refresh token)

Deliver notifications without requiring manual re-authentication. Grants no additional data access.

User.Read

Sign in and read the connecting user's basic profile (name, email)

Confirm the identity of the admin setting up the integration.

Team.ReadBasic.All

Read team names and descriptions (metadata only)

Show your teams so you can choose where notifications go.

Channel.ReadBasic.All

Read channel names and descriptions (metadata only)

Show channels in the selected team so you can choose one.

ChannelMessage.Send

Send messages to team channels

Spara's core function: post notifications to the channel you configure.

Chat.Read

Read 1:1 or group chats (delegated)

Required by the Teams bot framework to establish a connection context. Spara does not read, store, or transmit chat content.

ChannelMessage.Read.All

Read a channel's messages (delegated)

Required by the bot framework for message-delivery confirmation. Spara does not read, index, store, or export channel messages.

What Spara will and will not do

Spara will:

  • Post automated notifications into the team channels you explicitly configure.

  • Read team and channel names so you can select a target channel during setup.

  • Maintain an authenticated connection to deliver those notifications.

Spara will not:

  • Send messages to individual users or private 1:1 chats.

  • Read, store, analyze, or export the content of any channel messages or chats.

  • Access channels or teams outside of what you explicitly configure.

  • Monitor, surveil, or index any Teams conversations.

Delegated, not application, permissions

Every permission Spara requests is a delegated permission: Spara acts only on behalf of the signed-in user, within what that user is already allowed to do. Spara does not request application permissions, which would let an app act independently of any user and potentially reach all data across the organization. In practice, Spara cannot access Teams data for users who haven't authenticated with it, nor any channel or team outside what your admins configure.

Last updated