Skip to main content

Microsoft Teams Integration

← Back to Documentation

A11y Pulse posts accessibility alerts to a Microsoft Teams channel using a webhook URL that you generate from inside Teams.

This page covers:

Setting up a Microsoft Teams integration

The setup happens partly in Teams and partly in A11y Pulse. The Teams half generates a webhook URL. The A11y Pulse half stores it and pairs it with the sites whose alerts you want to receive.

1. Generate the webhook URL in Teams

  1. In Microsoft Teams, open the channel where you want to receive alerts.
  2. Click the ⋯ More channel options button, then select Workflows.
  3. Search for the template called “Send webhook alerts to a channel” and select it.
  4. Confirm the team and channel, then click Save.
  5. Click Copy webhook link to copy the webhook URL.

For more detail, see Microsoft’s official guide: Create a webhook workflow from scratch.

Screenshots showing each step of creating a Workflow webhook inside Teams

2. Connect it in A11y Pulse

  1. In A11y Pulse, navigate to Settings, Integrations, Microsoft Teams.
  2. Paste the webhook URL into the Webhook URL field.
  3. Give the connection a label that will help you recognise it later (for example, “Engineering” or “#alerts”).
  4. Click Connect.
Screenshot of the Microsoft Teams connect form in A11y Pulse

The connection appears in the integrations list. Click Test Integration to send a sample Adaptive Card to your channel. The first message can take up to thirty seconds because Microsoft’s workflow service may need to spin up.

Screenshot of an A11y Pulse alert appearing as an Adaptive Card in a Microsoft Teams channel

Adding the integration as an alert recipient

A connection only sends alerts for sites that have it added as a recipient. On any site’s settings page, find the Alert Settings section, add the Microsoft Teams integration under Alert Recipients, and save. See Alerting for details about thresholds and frequency.

Removing an integration

In A11y Pulse, go to Settings, Integrations, Microsoft Teams and click Delete Integration on the connection you want to remove. A11y Pulse stops sending alerts to that webhook immediately.

To fully remove the connection on the Microsoft side, also delete the workflow from inside Teams. Until you do, the workflow URL keeps existing and could be used by any service that has it.