Skip to main content

Microsoft Teams

Slug: teams
Provider: Microsoft Teams Incoming Webhooks (Adaptive Cards)
Inbound ACK: No — users must ACK via the web dashboard


How it works

PSAPLink sends an Adaptive Card message to a Teams channel via an Incoming Webhook connector. The card displays priority, incident type, location, and a link to the web dashboard.


Configuration schema

FieldTypeRequiredDescription
webhook_urlstringYesTeams Incoming Webhook URL from the Teams channel connector configuration.
usernamestringNoDisplay name shown on the card (default: "PSAPLink").

Create a Teams Incoming Webhook

  1. In Teams, open the channel to receive alerts.
  2. Click ... (More options) → Connectors → search Incoming WebhookConfigure.
  3. Enter a name and optional icon, then click Create.
  4. Copy the generated Webhook URL.

Create a channel

POST /api/v1/transport-channels
Authorization: Bearer <token>
Content-Type: application/json

{
"transport_type_slug": "teams",
"name": "Operations Teams",
"config": {
"webhook_url": "https://yourorg.webhook.office.com/webhookb2/..."
}
}

Test the channel

POST /api/v1/transport-channels/{id}/test
Authorization: Bearer <token>

Limitations

  • No inbound ACK. Users acknowledge via the PSAPLink web dashboard only.
  • Microsoft retired legacy "Office 365 Connector" webhooks in August 2024. Use the new Workflows app connector if available in your tenant.