Integrations
Configuring Integrations
Conduktor console can integrate with Slack, MS Teams, and any system that receives webhooks.
MS Teams and webhook integrations can be enabled and disabled from this page with a simple toggle.
Disabling an integration used by existing alerts will not delete the alerts, but will prevent them from sending notifications externally.
Enabling the Slack integration requires creating a Slack application, installing this to your Slack workspace, inviting your app to the channel and adding the application token to Conduktor.
Enabling the MS Teams integration requires a webhook URL from Teams when creating alerts with this destination.
Additional instructions for either integration can be found within Conduktor's UI as part of setup, or below.
Slack Integration
As part of configuring the Slack integration in Conduktor, you will find steps for creating a Slack application (a bot) using the app manifest template (provided in Conduktor). This app needs to be installed to your Slack workspace and the OAuth token added to the Conduktor integration.
Once configured you'll need to add the application to the Slack channels you wish to send alerts too. You can do this by typing /invite
in the channel and choose the application you have just created., or through managing the app within Slack.
![Slack integration](/assets/images/slack-invite-43c9de4b96fed1e3b23a3737fcec60a1.png)
Channels that have not had the application invited cannot be set as destinations for alerts. You'll get a not_in_channel
error. Once the applications is invited to the channel, you'll be able to send alerts to that Slack channel.
Microsoft Teams Integration using Workflows
Microsoft plans to retire existing Microsoft 365 (previously Office 365) connectors and webhooks across all cloud platforms starting 8/15/2024, with plans to disable the ability to create new connectors and webhooks. Followed by connectors and webhook's functionality ceasing at the end of the year. Power Automate workflows are the intended solution to replace the connectors and webhooks.
This document focusses on the Workflows integration, rather than webhooks which are used with Microsoft teams to handle alerting from Conduktor's monitoring.
You can send notifications to different rooms for different alerts. However, this room must be a Microsoft Teams "standard room" and not a "shared" room.
Workflows Setup Instructions
- Open the Workflows app within the chat or channel by right-clicking on the conversation, or by clicking on More options (…) then selecting Workflows.
![Workflows](/assets/images/workflows-1-b9ec95ea68e76eb4da96ed66810d5d28.png)
- In the Workflow app, click on the "+ New flow" button, or select the Create tab and choose "Post to a channel when a webhook request is received" template.
![Workflows](/assets/images/workflows-2-e77d1f7d3e8a465348f46aaf1c384a26.png)
- Choose a name for this flow, you can use the default "Post to a channel when a webhook request is received". And choose who will own this workflow, it should default to the user you are using to log into teams. Then click Next.
![Workflows](/assets/images/workflows-3-cc97520e90df4895910da63727689d45.png)
- Pick which team and which channel to post to, then click on Create flow. This page may take some time to load.
![Workflows](/assets/images/workflows-4-91320bc26384d279aed884a26661172e.png)
-
Once you click on click on Create flow from the previous step, the next page should show you the URL for the webhook associated with the workflow you just created. Copy and paste this somewhere as it will be used in a later step. Then click done.
-
Go back to the Home tab in workflow, and edit the newly created workflow by click on more options(...) then Edit.
![Workflows](/assets/images/workflows-5-07744e30e01b19b16fcc8f0d0d4da2f7.png)
- On this page:
- Expand the first step "When a Teams webhook request is received" to see the URL endpoint again if you failed to save it from the previous step. You can also change who can trigger the flow, for this example we will use "Anyone".
- Expand the second step and select "attachments" from Select an output from previous steps, then in the sub step select "content" from Adaptive Card. Everything else should be filled in, however here you can choose a different channel if you want to change the options selected during Workflow creation.
![Workflows](/assets/images/workflows-6-24300c055b934367827bd17b8555af84.png)
- Head to the integrations settings in Conduktor and turn on the Teams integration. You can now create alerts with the destination "Microsoft Teams" and use the URL found in previous steps. You can test your connection by clicking on the test button.
![Workflows](/assets/images/workflows-7-f69b4603b02c394ce9dfa486b30c2482.png)
- Fire some alerts and you should now see alert messages being posted in Microsoft teams under the channel you specified
![Workflows](/assets/images/workflows-8-c5fbaf4e0582fd45598f3777594f6bec.png)