Skip to content

Microsoft Teams

Receive incident notifications in Microsoft Teams using adaptive cards. Setup is done via an incoming webhook URL -- no OAuth or app installation required.

Setup

  1. In Microsoft Teams, open the channel where you want incident notifications.
  2. Click the + icon to add a connector and search for Incoming Webhook.
  3. Give it a name (e.g., "Batida Incidents") and click Create.
  4. Copy the generated webhook URL.
  5. In Batida, go to Settings > Integrations > Microsoft Teams.
  6. Paste the webhook URL and click Save & Test.
https://your-tenant.webhook.office.com/webhookb2/...

Multiple channels

You can add multiple webhook URLs to route notifications to different Teams channels. For example, send high-severity incidents to an #incident-critical channel and low-severity alerts to #incident-triage.

Adaptive card notifications

Batida sends notifications as Microsoft Adaptive Cards, which render rich interactive content directly in the Teams message.

Each notification includes:

  • Incident title with severity badge (color-coded)
  • Status (investigating, identified, monitoring, resolved)
  • Assigned responder and team
  • Timestamp of the event
  • Action buttons for acknowledge, escalate, and resolve

Example notification payload

Batida sends the following Adaptive Card structure via the webhook:

json
{
  "type": "message",
  "attachments": [
    {
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "type": "AdaptiveCard",
        "version": "1.4",
        "body": [
          {
            "type": "TextBlock",
            "text": "INC-42: API latency spike",
            "weight": "Bolder",
            "size": "Large"
          },
          {
            "type": "TextBlock",
            "text": "Severity: critical | Status: investigating",
            "isSubtle": true
          }
        ],
        "actions": [
          {
            "type": "Action.OpenUrl",
            "title": "View Incident",
            "url": "https://app.batida.io/incidents/42"
          }
        ]
      }
    }
  ]
}

Event types

Notifications are sent for the following incident events:

EventDescription
OpenedNew incident created
UpdatedStatus or severity changed
CommentedNew timeline entry added
ResolvedIncident marked as resolved
EscalatedSeverity tier increased

Troubleshooting

  • No messages appearing: Verify the webhook URL is correct and has not expired. Go to the Teams connector settings and regenerate the URL if needed.
  • Cards not rendering: Ensure your Teams client is up to date. Adaptive Cards v1.4 is supported in Teams desktop and web.
  • Timeout errors: Teams webhooks have a rate limit of one message per second per channel. If you are running a high volume of alerts, consider distributing across multiple webhook URLs.

Built by the Batida team