This extension adds the capability to send notifications based on actions and triggers to collaboration tool Slack. This page describes how to configure and work with the extension in order to send notifications to Slack.
By default the only available kind of action consists in sending email. This extension defines a new type of Action: Slack Notification. You are able to:
Version | Release Date | Comments |
---|---|---|
17.4.0 | 2017-12-20 | Initial release. |
https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX
)Slack Integration
in the list of extensions at the end of the interactive wizard. The following settings are available to configure the module:
Parameter | Type | Description | Default Value |
---|---|---|---|
certificate_check | boolean | Whether to check the ssl certificate of slack server. | true |
certificate_file | string | Path to an custom certificate file. | |
timeout | Integer | Determine how many seconds iTop shall wait for a response of Slack | 5 |
Slack Notification is a special type of Action. It is based on Action/Triggers. The usage is quite similar to an email notification.
To view your Slack notifications use the link “Notifications” in the “Admin tools” menu and click on the tab “Actions”.
To create a new action, go to the “Actions” tab and click on “New…”. The following wizard appears:
The mandatory fields for a slack notification are:
log/slackintegration.log
(Default: no)Without any other Information iTop will send an empty notification to Slack.
Beside the Slack URL you are able to specify the following attributes:
You can add content to your notification by editing the attribute “simple text”. It is possible to format your message via HTML and add placeholders. Placeholders works in the same way like they do in the email notification. Fore more information please see this site.
For an improved formatting you can use a slack message attachment. An attachment will be shown below the simple text, indented and marked with a color at the left side.
To enable the attachment set the attribute “Use an attachment?” to “yes” and edit the following attributes:
SELECT Ticket WHERE id= :this->id