1
0
mirror of https://github.com/Unleash/unleash.git synced 2024-10-18 20:09:08 +02:00
unleash.unleash/websitev2/docs/addons/slack.md

41 lines
2.0 KiB
Markdown
Raw Normal View History

2021-02-05 14:19:04 +01:00
---
id: slack
title: Slack
---
> This feature was introduced in _Unleash v3.11.0_.
The Slack addon allows Unleash to post Updates when a feature toggle is updated. To set up Slack, you need to configure an incoming Slack webhook URL. You can follow [Sending messages using Incoming Webhooks](https://api.slack.com/incoming-webhooks) on how to do that. You can also choose to [create a slack app for Unleash](https://api.slack.com/apps), which will provide you with additional functionality to control how Unleash communicates messages on your Slack workspace.
The Slack addon will perform a single retry if the HTTP POST against the Slack Webhook URL fails (either a 50x or network error). Duplicate events may happen,m and you should never assume events always comes in order.
## Configuration {#configuration}
2021-02-05 14:19:04 +01:00
#### Events {#events}
2021-02-05 14:19:04 +01:00
You can choose to trigger updates for the following events (we might add more event types in the future):
- feature-created
- feature-updated
- feature-archived
- feature-revived
2021-02-25 22:27:11 +01:00
- feature-stale-on
- feature-stale-off
2021-02-05 14:19:04 +01:00
#### Parameters {#parameters}
2021-02-05 14:19:04 +01:00
Unleash Slack addon takes the following parameters.
- **Slack Webhook URL** - This is the only required property. If you are using a Slack Application you must also make sure your application is allowed to post to the channel you want to post to.
- **Username** - Used to override the username used to post the update to a Slack channel.
- **Emoji Icon** - Used to override the emoji icon used to post the update to a Slack channel.
- Default channel - Where to post the message if the feature toggles has not overridden the channel via the slack tags.
2021-02-05 14:19:04 +01:00
#### Tags {#tags}
2021-02-05 14:19:04 +01:00
The Slack addon also defined the Tag type "slack". You may use this tag to override which Slack channel Unleash should post updates to for this feature toggle.
2021-02-05 14:19:04 +01:00
![Slack Tags](/img/slack_addon_tags.png)
2021-02-05 14:19:04 +01:00
In the picture you can see we have defined two slack tags for the "new-payment-system" toggle. In this example Unleash will post updates to the **#notifications** and **#random** channel.