Integrate Soda with Microsoft Teams
Last modified on 20-Nov-24
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 channel
- start conversations to track and resolve data quality incidents with MS Teams
Configure an MS Teams integration
- As a user with permission to do so, 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, follow the instructions to navigate to your MS Teams account to create a Workflow; see Microsoft’s documentation for Creating a workflow from a channel in Teams. Use the Workflow template to Post to a channel when a webhook request is received.
- In the last step of the guided Workflow creation, copy the URL created after successfully adding the workflow.
- Returning to Soda Cloud with the URL for Workflow, 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 | Provide a unique name for your integration in Soda Cloud. |
| URL | Input the Workflow URL you obtained from MS Teams. |
| 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 to track and resolve incidents in Soda Cloud. | Check to automatically send incident information to an MS Teams channel. |
| Channel URL | Provide a channel identifier to which Soda Cloud sends all incident events. |
| Use Microsoft Teams to track discussions in Soda Cloud. | Check to automatically send notifications to an MS Teams channel when a user creates or modifies a discussion in Soda Cloud. |
| Channel URL | Provide a channel identifier to which Soda Cloud sends all discussion events. |
About integration scopes
Use the Alert Notification scope 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.
Use the Incident scope to notify your team when a new incident has been created in Soda Cloud. With such a scope, 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 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.
Use the Discussions scope to post to a channel when a user creates or modifies a Soda Cloud discussion. Soda Cloud sends all incident events to only one channel in MS Teams. As such, you must provide a separate 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 Begin a discussion and propose checks for more details about using incidents in Soda Cloud.
Troubleshoot
Problem: You encounter an error that reads, “Error encountered while rendering this message.”
Solution: A fix is documented, the short version of which is as follows.
- Restart MS Teams.
- Clear your cache and cookies.
- If you have not already done so, update to the latest version of MS Teams.
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 20-Nov-24