Microsoft Teams

Metaplane supports sending data quality alerts to Microsoft Teams via the Workflows app. The Workflows app allows you to provision a webhook URL that Metaplane will hit when your team needs to be notified.

Setup

Ensure that the Workflows app has been installed for your Microsoft Teams account.

1. Expand the context menu next to the channel name that you'd like to target.

2. Search for "webhook" and select the template named "Post to a channel when a webhook request is received."

3. Click "Next" on the following screen.

4. Wait a few seconds for the next screen to fully load, verify the team and channel details, then click "Add workflow."

5. Copy the resulting webhook URL into your clipboard and click "Done."

6. In Metaplane, navigate to the Alert settings .Towards the bottom of the page find to option to add a new MS Teams alert destination.

7. Provide a name for the webhook and the webhook URL that you generated earlier. The name is only used within the Metaplane app so that you can disambiguate webhooks in the case that you create multiple.
8. Click "Add destination"

To verify that the webhook is working, click the "Verify" button associated with the newly created alert destination. Within seconds a message should be sent to the webhook's associated channel.

That's it. You can setup as many webhooks as you'd like by clicking the "Add webhook" button associated with the Microsoft Teams webhook section.

F.A.Q

The sent message author reads "Username via Workflows", is it possible to control that?

Unfortunately, no. The user name referenced in the message author slot will always be the name of the user that configured the workflow. One potential way of getting around this is by provisioning a dedicated Metaplane user within the team and then configuring the workflow using that user.

Alert configuration

Head over to the Alert routing docs to learn about how you can route different types of alerts to different channels.