For partners subscribed to Select or Enterprise plans.
This article will walk you through the steps for configuring IT Glue and Slack to send webhook notifications to a Slack channel when specific events occur. For an introduction to workflows, refer to our Quick guide for workflows.
- You must have Manager or Administrator access to configure IT Glue workflows.
In this article, we will refer to the JSON API, which is basically a universal connector for data on the internet. JSON API is a specification for how a client should request that resources be fetched or modified, and how a server should respond to those requests. You don’t have to know anything beyond that to begin experimenting with this feature.
- In Slack, click on Add an app or custom integration in the channel you want to create the notification in.
- In the window that opens, click on Build (in the top-right corner). This takes you to api.slack.com.
- Select the Incoming WebHooks option from the navigation bar, and then click the incoming webhook integration link.
- Select the Slack channel you wish to connect to and then click the Add Incoming WebHooks integration button.
- On the next screen, copy the WebHook URL. You should keep this window open to refer to the instructions on how to construct the JSON payload.
- (Optional) If you scroll down the page, Slack will let you upload an image that is used for messages from that specific integration. We've attached a couple of icons that you can use. After you upload an image, click Save Settings to apply the change.
Defining the trigger and filters
- Open IT Glue and navigate to Account > Workflows.
- Click + New.
- Choose the trigger you want to use.
- Documents - Triggers when a document is published or updated
- Passwords - Triggers when a password is added or updated
- Domain Expirations - Triggers when the specified lead time is met on a domain's expiration date
- SSL Expirations - Triggers when the specified lead time is met on a SSL expiration date
- Configuration Expirations - Triggers when the specified lead time is met on a configuration's (warranty) expiration date
- Flexible Asset Expirations - Triggers when the specified lead time is met on a flexible asset's expiration date
- To configure the trigger:
- Trigger Name: Enter a descriptive name for the trigger (e.g. Send license expiration alerts to Slack).
- Notify At (Lead Time): Only applies to expiration-based triggers. Specify the number of days in advance that you want to be notified when an asset is nearing its expiration. For example, if you enter 10, you will receive notice 10 days in advance of the expiration date.
- (Optional) Check the Expire sooner than the lead time and Have already expired boxes to schedule a one-time job that will notify you of existing assets that are about to expire (i.e. sooner than the specified lead time) or are already expired. So, if your lead time is 10 days, and you check these boxes, IT Glue will check whether there are any assets that are already within 10 days or less of their expiration, or that are past their expiration date.
- Notification Failure Email: When notifications fail, an email will be sent to this email address from firstname.lastname@example.org.
- If you chose an expiration-based trigger, you can estimate how many notifications your trigger criteria will generate by clicking the Estimate How Many button.
- To add a filter, click the + Filter button (left side of the screen) and select your filter criteria using the drop downs.
- Click Next.
Defining the action
- Next, choose the action that will be triggered.
- To configure the action:
- Action Name: Enter a descriptive name for the action (e.g. Notify in #general Slack channel 10 days in advance).
- Webhook URL: Enter the Webhook URL copied from Slack.
- JSON Payload: Enter a key/value pair. The value you associate with the text key is the message that will be posted to your Slack channel.
This key/value pair includes variables that will pull values from the asset that’s triggering the notification. The available variables are listed at the bottom of the screen where you input this information. Having trouble formatting the message? Try reading the Slack documentation. Note: Line breaks are not currently supported.
Your team will now start receiving notifications to Slack within the next 24 hours. Note that notifications based on document or password triggers will be sent in real time.
From there, you can use a system of emoji reactions to let team members claim, investigate, and mark problems as resolved, or have conversations about specific notifications.
Note: You can download either of the following icons to upload to Slack as described further above. This will help your team visually verify where the messages originated: