Integrate Soda with Microsoft Teams
Last modified on 30-Nov-23
Configure Soda Cloud to connect your account to MS Teams so that you can:
- send alert notifications for failed or warning check results to MS Teams
- start conversations to track and resolve data quality incidents with MS Teams
Configure an MS Teams integration
- As an Admin user, log in to your Soda Cloud account, navigate to your avatar > Organization Settings, then select the Integrations tab.
- Click the + at the upper right of the table of integrations to add a new integration.
- In the Add Integration dialog box, select Microsoft Teams.
- In the first step of the guided integration workflow, download the Soda logo that you need to set up an incoming webhook with MS Teams.
- Navigate to your MS Teams account to set up an incoming webhook; see detailed instructions below.
- Returning to Soda Cloud with the URL for the incoming webhook, continue to follow the guided steps to complete the integration. Reference the following tables for guidance on the values to input in the guided steps.
| Field or Label | Guidance |
|---|---|
| Name | Required Provide a unique name for your integration in Soda Cloud. |
| URL | Required Input the incoming webhook URL you obtained from MS Teams. See section below for details. |
| Enable to send notifications to Microsoft Teams when a check result triggers an alert. | Check to allow users to select MS Teams as a destination for alert notifications when check results warn or fail. |
| Use Microsoft Teams as the default notification channel for all check result alerts. | Check to automatically configure check results alert notifications to MS Teams by default. Users can deselect MS Teams as the notification destination in an individual check, but it is the prepopulated destination by default. |
| Enable to use use Microsoft Teams to track and resolve incidents in Soda Cloud. | Check to allow users to send incident information to an MS Teams channel. |
| Channel URL | Required for incident integration Provide a channel identifier to which Soda Cloud sends all incident events. See Integration for Soda Cloud incidents below. |
Set up incoming webhook in MS Teams
Refer to the Microsoft documentation for creating Incoming Webhooks. What follows are instructions for quick reference.
- Go to Microsoft Teams and navigate to the team and channel you wish to integrate with Soda Cloud.
- Open the channel’s context menu (three dots) and navigate to Connectors.
- Search for, then select, Incoming Webhook.
- Once added, open the Context menu for your channel and navigate to Connectors. Select your new incoming webhook, then click Configure.
- Provide a name for your webhook, then upload the Soda logo.
- Click Create, then wait for the fields to display
readonly. Copy the incoming webhook URL to input into the guided Soda Cloud integration workflow.
Integration for Soda Cloud alert notifications
You can use this integration to enable Soda Cloud to send alert notifications to an MS Teams channel to notify your team of warn and fail check results.
With such an integration, Soda Cloud enables users to select MS Teams as the destination for an alert notification of an individual check or checks that form a part of an agreement, or multiple checks.
To send notifications that apply to multiple checks, see Set notification rules.
Integration for Soda Cloud incidents
You can use this integration to notify your team when a new incident has been created in Soda Cloud. With such an integration, Soda Cloud displays an external link to the MS Teams channel in the Incident Details.
Soda Cloud sends all incident events to only one channel in MS Teams. As such, you must provide a separate integration link in the Channel URL field in the Define Scope tab. For example, https://teams.microsoft.com/mychannel. To obtain the channel link in MS Teams, right-click on the channel name in the overview sidebar.
Refer to Incidents for more details about using incidents in Soda Cloud.
Go further
- Learn more about general webhooks to integrate Soda Cloud with other third-party service providers.
- Set notification rules that apply to multiple checks in your account.
- Need help? Join the Soda community on Slack.
- Access a list of all integrations that Soda Cloud supports.
Was this documentation helpful?
What could we do to improve this page?
- Suggest a docs change in GitHub.
- Share feedback in the Soda community on Slack.
Documentation always applies to the latest version of Soda products
Last modified on 30-Nov-23