Latest version: 4.3.x
Webhooks (Microsoft Teams)
Setup a Microsoft Teams connection for Streaming Data Platform alerts using Webhooks.
Set up
0. To create a webhook in your MS Teams workspace you can use this guide
At the end of the process you get a url of the format:
https://YOUR_URL.webhook.office.com
/webhook/<secret-token-by-ms>/IncomingWebhook/<secret-token-by-ms>
You’ll need the second part
/webhook/<secret-token-by-ms>/IncomingWebhook/<secret-token-by-ms>
for the Request Path later in this guide.
1. Visit Admin → Connections and click New connection
2. Select Webhook
3. Provide a name and configuration
You can also optionally add tags (i.e. teams). Then add the Webhook configuration information with host outlook.office.com
as included in the Microsoft Teams webhook URL.
Moreover make sure that the Use HTTPS
switch is turned on.
Add channel
Next add one or multiple target Webhook channels.
1. Visit Admin → Channels and click Webhook
2. Setup the configuration options
For example the above will create the MS Teams Webhook
, that is using the Webhook connection of microsoft-teams
to POST
in the general
channel.
In the field Request path you need to fill in the part of the Webhook URL like this /webhook/<secret-token-by-ms>/IncomingWebhook/<secret-token-by-ms>
.
In the field Body payload you need to use a custom payload based on the requirements of Microsoft Teams for messages. The following snippet shows an example payload for a simple message:
{"text": "{{CATEGORY}} {{LEVEL}} {{ID}}"}
Below is the configuration for Microsoft Teams alert channel:
An example
If for example you create a rule to send infrastructure notifications to Microsoft Teams via Webhook,
then the moment a Broker becomes offline, an HTTP POST
will be made to the Microsoft Teams Webhook endpoint.
Additional info
Users with the alert permission can create alert rules .