Skip to content

Commit 699af9d

Browse files
ppf2jrodewiglcawlelasticmachine
authored
[DOCS] Fix obsolete Slack setup info (#57834)
Slack no longer recommends the legacy "integrations" setup (https://api.slack.com/legacy/custom-integrations/incoming-webhooks). Updated documentation to reference https://api.slack.com/messaging/webhooks instead. Removed screenshots from our documentation related to Slack setup. We should avoid these screenshots (and simply point to Slack documentation) for Slack may change the instructions/their UI in the future. Also added a short note on the use case of notifying multiple Slack channels. Co-authored-by: James Rodewig <40268737+jrodewig@users.noreply.github.com> Co-authored-by: Lisa Cawley <lcawley@elastic.co> Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com>
1 parent 2220a4b commit 699af9d

File tree

1 file changed

+5
-14
lines changed

1 file changed

+5
-14
lines changed

x-pack/docs/en/watcher/actions/slack.asciidoc

Lines changed: 5 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -181,20 +181,8 @@ aggregation and the Slack action:
181181
You configure the accounts {watcher} can use to communicate with Slack in the
182182
`xpack.notification.slack` namespace in `elasticsearch.yml`.
183183

184-
You need a https://api.slack.com/incoming-webhooks[Slack webhook URL] to
185-
configure a Slack account. To create a webhook
186-
URL, set up an an _Incoming Webhook Integration_ through the Slack console:
187-
188-
. Log in to http://slack.com[slack.com] as a team administrator.
189-
. Go to https://my.slack.com/services/new/incoming-webhook.
190-
. Select a default channel for the integration.
191-
+
192-
image::images/slack-add-webhook-integration.jpg[]
193-
. Click *Add Incoming Webhook Integration*.
194-
. Copy the generated webhook URL so you can paste it into your Slack account
195-
configuration in `elasticsearch.yml`.
196-
+
197-
image::images/slack-copy-webhook-url.jpg[]
184+
You need a Slack App with the https://api.slack.com/messaging/webhooks[Incoming Webhooks feature]
185+
to configure a Slack account. Use the generated webhook URL to set up your Slack account in {es}.
198186

199187
To configure a Slack account, at a minimum you need to specify the account
200188
name and webhook URL in the {es} keystore (see {ref}/secure-settings.html[secure settings]):
@@ -231,6 +219,9 @@ xpack.notification.slack:
231219
mrkdwn_in: "pretext, text"
232220
--------------------------------------------------
233221

222+
To notify multiple channels, create a webhook URL for each channel in Slack
223+
and multiple Slack accounts in {es} (one for each webhook URL).
224+
234225
If you configure multiple Slack accounts, you either need to configure a default
235226
account or specify which account the notification should be sent with in the
236227
<<actions-slack,`slack`>> action.

0 commit comments

Comments
 (0)