This article describes how to set up Slack and Diplomat MFT so that Diplomat can send transaction notifications to a given Slack channel. This involves setting up an Incoming WebHook in the Slack system and using its URL for the Notifications of a Diplomat MFT Transaction.
First, you must create a Slack Incoming WebHook. Then for each transaction in Diplomat you want to to add to the Slack notifications, you must enable the Messaging Notifications for that Slack Incoming WebHook URL.
Note: Slack Notifications is available starting with Diplomat MFT v8.3 and requires Standard or Enterprise Edition.
Create a Slack Incoming WebHook
An Incoming WebHook is a URL (endpoint) which can be used to deliver messages into a specific Slack channel. To enable an Incoming WebHook on a specific Slack channel, log into your Slack administration web page and go to the Slack Apps Directory, then search for Incoming WebHooks (or simply navigate to “https://<slackworkspace>.slack.com/apps/A0F7XDUAZ-incoming-webhooks”, where <slackworkspace> is the domain name of your slack workspace.
Click “Add To Slack” and then choose the channel to which you wish Diplomat MFT notifications to be sent. You might wish to create a channel specifically for Diplomat MFT first and use this for Diplomat MFT notifications (to do so, click the “or create a new channel” link underneath the “Choose a channel…” box). When finished, press “Add Incoming WebHooks integration” to create the Incoming WebHook that Diplomat MFT will use to send notifications.
Download the Diplomat MFT icon from the attachment at the bottom of this article or presented here:
Now configure the incoming WebHook so that incoming messages show the descriptive information as you see fit and use the above custom icon.
Make note of the “Webhook URL,” because you will need this value to configure Diplomat MFT. Now is a good time to highlight that URL and copy it into your clipboard.
Enable Slack Notification in a Diplomat MFT Transaction
To configure a Diplomat MFT transaction to send notifications to the Slack channel via the web hook, edit the Transaction and visit the “Notifications” area.
Locate the “Slack Notifications” checkbox and put a check in it to enable Slack notifications. Supply the Slack Incoming WebHook URL, and choose the level of notification to receive on the Slack channel.
Now you can run your transaction to test out the notifications. Slack should receive messages similar to this example: