Help / Alerts
Microsoft Teams
A Microsoft Teams channel posts alerts into a channel in Teams. It uses a workflow in Teams that accepts messages at a web address and posts them to the channel you choose.
What you need first
- Microsoft Teams, with permission to add workflows to the team. Some organisations limit this to admins.
- The team and channel the alerts should go to.
Older Office 365 connector URLs no longer work. If you set up Teams alerts that way before, make a workflow instead, as below.
Make the workflow in Teams
Microsoft changes these screens from time to time. If the steps do not match what you see, follow Microsoft's own guide, Create incoming webhooks with Workflows for Microsoft Teams.
- In Teams, open Workflows.
- Choose the template Send webhook alerts to a channel.
- Give the workflow a name, then pick the team and the channel.
- Finish creating the workflow.
- Copy the workflow webhook URL that Teams shows at the end. It starts with
https://.
Treat the URL like a password. Anyone who has it can post into that channel.
Add it in HonkWatch
- Open Alerts and go to Add a channel.
- Under Where should alerts go?, choose Teams.
- Paste the workflow webhook URL into Send to.
- If you like, type the team and channel name in Label (optional).
- Tick the events to post: Down, Back up, Certificate expiring and Slow.
- Press Add channel.
Send a test
- In the channel list on Alerts, press Send test on the Teams row.
- A message about "Test monitor" should appear in the Teams channel. Workflows can take a little longer than a chat message, so give it a minute.
What an alert looks like
Each alert is a short text message. The first line is the service name in square brackets, then the monitor and what happened, for example "Shop is DOWN". Below it are the monitor's address, the reason and a link to the monitor's page.
If it does not work
- You see "That needs an https:// address". Paste the whole workflow URL, starting with
https://. - Recently sent shows failed. Teams refused the message. The workflow may have been turned off or deleted, or the URL was copied incompletely. Check the workflow in Teams, or make a new one and add its URL as a new channel here.
- Recently sent shows sent, but nothing appears in Teams. Open the workflow in Teams and look at its run history. A failed run there shows why the post did not reach the channel.
- The URL starts with an old Office 365 address. That is a connector URL, which no longer works. Make a workflow as described above.
See also Setting up alerts for which events go where.
Still stuck? Email [email protected] and say which guide you were following.