Description: Canary supports outgoing Webhooks from your Console to an endpoint of your choice. This event-driven approach means you get your alerts in real-time!
Private channels: If you need to set up a Webhook notification for a Private channel, there are a few extra steps at the end of the article that need to be followed after Step 7. Private channels have a lock icon next to the channel name in Microsoft Teams.
Note: This guide is for configuring MS Teams Webhooks for a particular flock. If you would like to set up MS Teams Webhooks globally, have a look at the set up guide here.
Follow the steps below to set up Webhooks for MS Teams for a flock on your Canary Console:
Step 1:
Log in to your MS Teams account.
Step 2:
If you haven’t already, install the Workflows app.
1. Click on Apps in the sidebar.
2. Search for Workflows.
3. Click Add to install the app.
Step 3:
Open the Workflows app and click on the “Create” button.
Step 4:
1. Search for the template Post to a channel when a webhook is received.
2. Select the template by clicking on it.
Step 5:
1. Enter a name for your new Workflow.
2. Click Next.
Note: We used Canary Alerts Webhook as our flow name.
Step 6:
1. Select the team where the channel is that you would like webhook alerts posted to (the dropdown menus could take around 10s to appear).
2. Select the channel.
3. Click on Create flow.
Step 7:
1. Copy the webhook URL that's generated.
2. Click Done.
If you're adding a webhook to a Private channel, follow the steps at the bottom of the page before proceeding. If not, you can proceed with step 8.
Step 8:
Log in to your Console.
Step 9:
Click on the Flock that would like to create a Webhook for.
Step 10:
Then click on the gear that's in the top right corner of Flock modal.
Step 11:
1. Scroll down and click on Notifications.
2. And then click on the + button in the menu that slides down.
Step 12:
Click on Add MS Teams in the modal that appears.
Step 13:
1. Paste the URL that was copied earlier from the MS Teams Workflow setup into the Webhook URL text input.
2. Click Save.
Step 14:
A message from us will then be posted to the channel that was selected when the Workflow was set up to confirm that the integration has been set up successfully.
You're done! ;)
Private channels
Because of the way that Microsoft Teams handles Workflows, a few addition steps are required to configure the Webhook to work in Private Channels.
Step 1:
Open the Workflows app like we've explained above, and then click on the Workflow that you've just created for a Private channel.
Step 2:
Click on the "Edit" button.
Step 3:
Open the "Send each adaptive card" step by clicking on it.
Step 4:
Open the "Post card in a chat or channel" action by clicking on it.
Step 5:
Open the dropdown menu for the "*Post as" parameter and change it from "Flow bot" to "User".
Step 6:
Save the Workflow.