Integrate Our Platform with Microsoft Teams

Easily receive notifications, create tickets, and collaborate directly from Teams channels. Follow the steps below to set up a secure integration.

Prerequisites

• Microsoft 365 account with Teams admin privileges.
• Platform admin rights to create incoming webhooks.
• Browser with JavaScript enabled.

Step‑by‑Step Setup

1. Create an Incoming Webhook in Teams
   1. Open the Teams channel where you want notifications.
   2. Click ⋯ > Connectors > Configure next to Incoming Webhook.
   3. Name the webhook (e.g., “Platform Alerts”) and upload an optional avatar.
   4. Click Create. Copy the generated URL – you’ll need it later.
2. Configure the Webhook in the Platform

   WEBHOOK_URL = "https://outlook.office.com/webhook/…"

   Copy
3. Test the Integration

   Send a test message from the platform’s admin console. A message should appear in the selected Teams channel.

Sending Alerts from the Platform

Use the following API endpoint to push notifications to Teams:

POST /api/v1/teams/notify
Headers:
  Authorization: Bearer <API_TOKEN>
  Content-Type: application/json
Body:
{
  "title": "New Incident",
  "summary": "A high‑priority incident has been created.",
  "severity": "critical",
  "link": "https://yourplatform.com/incidents/12345"
}

All fields are optional except title. The platform formats the payload into a rich Teams card automatically.

Frequently Asked Questions