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.
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 Microsoft Teams
Step 2: Install the Workflows app
If you haven't already, install the Workflows app.
- Click on Apps in the sidebar.
- Search for Workflows.
- Click Add to install the app.
Step 3: Open Workflows and start a new flow
Open the Workflows app and click on the Create button.
Step 4: Choose the "Post to a channel when a webhook is received" template
- Search for the template Post to a channel when a webhook is received.
- Select the template by clicking on it.
Step 5: Name your workflow
- Enter a name for your new Workflow.
- Click Next.
We used Canary Alerts Webhook as our flow name.
Step 6: Select the team and channel
- Select the team where the channel is that you would like webhook alerts posted to (the dropdown menus could take around 10s to appear).
- Select the channel.
- Click on Create flow.
Step 7: Copy the generated webhook URL
- Copy the webhook URL that's generated.
- 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 Canary Console
Step 9: Open the relevant Flock
Click on the Flock that would like to create a Webhook for.
Step 10: Access Flock settings
Then click on the gear that's in the top right corner of Flock modal.
Step 11: Open the Notifications section
- Scroll down and click on Notifications.
- And then click on the + button in the menu that slides down.
Step 12: Add a Microsoft Teams integration
Click on Add MS Teams in the modal that appears.
Step 13: Paste your webhook URL and save
- Paste the URL that was copied earlier from the MS Teams Workflow setup into the Webhook URL text input.
- Click Save.
Step 14: Confirm the integration in Teams
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.
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 created workflow
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: Edit the workflow
Click on the Edit button.
Step 3: Open the "Send each adaptive card" step
Open the Send each adaptive card step by clicking on it.
Step 4: Open the "Post card in a chat or channel" action
Open the Post card in a chat or channel action by clicking on it.
Step 5: Change "Post as" from Flow bot to User
Open the dropdown menu for the *Post as parameter and change it from Flow bot to User.
Step 6: Save your changes
Save the Workflow.
Now follow the rest of steps here.