Microsoft Teams

Overview

Microsoft Teams is an enterprise communication platform. Enbbox sends notifications to Teams channels using Incoming Webhooks.

Step 1: Create an Incoming Webhook

1. Open Microsoft Teams and navigate to the channel where you want notifications
2. Click the ⋯ menu next to the channel name → Manage channel
3. Navigate to Connectors (or Settings → Connectors)
4. Find Incoming Webhook and click Configure
5. Enter a name (e.g., "Enbbox Notifications")
6. Optionally upload a custom icon
7. Click Create
8. Copy the Webhook URL

[!NOTE] If you don't see the Connectors option, your Teams administrator may need to enable it for your organization.

Step 2: Connect to Enbbox

1. Navigate to Integrations in the Enbbox dashboard
2. Click Add Provider → select Chat → Microsoft Teams
3. No global credentials needed — Teams uses per-subscriber webhook URLs
4. Activate the integration

Step 3: Configure Subscriber Credentials

import { SubscriberCredentialsApi, Configuration } from "@enbbox/api";

const config = new Configuration({ accessToken: "your-api-key" });
const credentialsApi = new SubscriberCredentialsApi(config);

await credentialsApi.setCredentials("subscriber-123", "msteams", {
  credentials: { webhook_url: "https://outlook.office.com/webhook/..." },
});

Step 4: Send a Test Notification

import { EventsApi, Configuration } from "@enbbox/api";

const config = new Configuration({ accessToken: "your-api-key" });
const eventsApi = new EventsApi(config);

await eventsApi.triggerEvent({
  name: "team-update",
  to: { subscriberId: "subscriber-123" },
  payload: { message: "📋 Sprint review meeting starts in 15 minutes" },
});

Troubleshooting