Skip to main content

Connect Microsoft Teams

Use this guide when you want Alerta to deliver alerts into Microsoft Teams.

What This Guide Covers​

  • connecting Microsoft Teams in Alerta
  • sending a Teams message with the public V2 API
  • replying to a Teams message with the public V2 API

Before You Begin​

You will need:

  • an active Alerta session
  • the correct organization selected
  • permission to manage integrations
  • access to the Microsoft Teams environment you want to connect

Where To Start In Alerta​

Open the Integrations page and choose MS Teams.

Setup Flow​

Teams follows a Microsoft connection flow inside Alerta:

  1. Click MS Teams in the Integrations page.
  2. Choose the Microsoft Teams environment you want to connect.
  3. Your browser redirects through the Teams authorization flow.
  4. Return to Alerta after the provider flow completes.
  5. Alerta redirects you back to a success state in the app.
  6. The connected Teams destination appears on the Channels page.

Public V2 Endpoints​

Microsoft Teams public endpoints are:

  • POST /v2/teams/send
  • POST /v2/teams/reply

Read the current API guidance in Alerta API, or review the older provider-specific reference in Legacy APIs.

Teams-Specific Notes​

  • Teams send and reply use channelRef.
  • Teams replies also require teamId, channelId, and messageId.
  • channelRef is an internal Alerta Teams binding reference, not the Teams channel name.

API Reference​