Slack v2.0
You can install the Slack Workspace integration to configure workflows to send notifications to Slack channels for alerts or Situations. The integration enables Slack notifications from Moogsoft Enterprise using the incoming webhook interface in Slack.
You can also use the Slack integration UI to define Slack workspaces and channel mappings based on the incoming webhooks configured in the Slack App.
This integration is available as a part of the Add-ons v2.1 and later downloads.
The Slack integration works with the following Workflow Engine functions:
setSlackChannel: Sets the Slack instance, and channel for the workflow. The channel name is checked against the Moogsoft Enterprise Slack Workspace config. When it finds a matching channel name, it uses the associated incoming webhook in the generated request payload.
notifySlack : Sends a notification to the Slack channel in
setSlackChannel
.
Before You Begin
The Slack integration has been validated with the Slack Apps v2 API incoming webhook endpoint. Before you start to set up your Slack v2.0 integration, ensure you have met the following requirements:
You have a Slack account and administrator privileges for your target Slack workspace.
You have created a Slack channel for incoming messages from Moogsoft Enterprise.
Configure Slack
These instructions offer the basic information you need to configure Slack for integration with Moogsoft Enterprise. For more information on Slack, see the Slack documentation.
Sign-in to your target Slack workspace.
From the workspace dropdown menu in the left navigation pane, select Settings & Administration > Manage apps. If you are accessing your Slack workspace with the Slack App, a browser session opens.
In the browser session, click the Build button.
Click on Create New App or select the existing Slack App to add webhook endpoints to.
Select Incoming Webhooks from the left navigation pane.
Set Activate Incoming Webhooks to On if it isn't already.
Click Add New Webhook To Workspace. In the resulting dialog, select an existing workspace channel for the webhook.
Copy the new webhook URL from the Incoming Webhooks section on the App page. You'll use this URL to configure the integration.
Configure Slack Channels
You can configure the Slack channels to receive incoming webhooks from the Moogsoft Enterprise workflows and add them to the Slack Workspace integration configuration. You must define at least one instance.
Navigate to the Integrations tab.
Click Slack in the Featured Integrations section.
Provide a unique integration name. You can use the default name or customize the name according to your needs.
Configure the Slack integration for alerts or Situations to initiate and identify the payload you need. See the Slack v2 Integration Reference for a description of all properties.
Define at least one instance to complete the configuration. If you are running multiple instances, identify any differences between them so you can configure these in the integration.
After you complete the configuration, Moogsoft Enterprise can send updates to Slack.