Skip to content
HonkWatch
PricingLocationsHonk RadarHelpAPI Log inGet started
All help topics

Getting started

  • Getting started
  • How checks work

Monitors

  • Which monitor to use
  • Website monitor
  • API monitor
  • Keyword monitor
  • Ping monitor
  • Port monitors (TCP and UDP)
  • DNS monitor
  • SSL certificate monitor
  • Domain expiry monitor
  • Third-party services
  • Page load monitor
  • Heartbeat monitor (cron jobs)
  • Maintenance windows
  • Incidents

Alerts

  • Setting up alerts
  • Email alerts
  • Slack
  • Microsoft Teams
  • Discord
  • Telegram
  • PagerDuty
  • ntfy
  • Webhooks
  • Zapier

Phone and desktop app

  • The phone and desktop app
  • App alerts not arriving

Status pages

  • Status pages
  • Status page on your own domain

Team and account

  • Team members
  • Plans and limits
  • API keys and the API
  • Your account

Troubleshooting

  • A monitor says down but my site works
  • I did not get an alert
  • Allowing our checks through a firewall
  • Questions and answers

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.

  1. In Teams, open Workflows.
  2. Choose the template Send webhook alerts to a channel.
  3. Give the workflow a name, then pick the team and the channel.
  4. Finish creating the workflow.
  5. 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

  1. Open Alerts and go to Add a channel.
  2. Under Where should alerts go?, choose Teams.
  3. Paste the workflow webhook URL into Send to.
  4. If you like, type the team and channel name in Label (optional).
  5. Tick the events to post: Down, Back up, Certificate expiring and Slow.
  6. Press Add channel.

Send a test

  1. In the channel list on Alerts, press Send test on the Teams row.
  2. 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.

← Slack Discord →

Still stuck? Email [email protected] and say which guide you were following.