From f5d5b6736b36403082f13f41842e0373c11369f8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?H=C3=A9lia=20Barroso?=
 <66432275+heliapb@users.noreply.github.com>
Date: Fri, 30 Jan 2026 15:01:42 +0000
Subject: [PATCH] chore: documment slack app configs (#4871)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Hélia Barroso <helia_barroso@hotmail.com>
---
 docs/configuration.md | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/docs/configuration.md b/docs/configuration.md
index ca5ce2c7c..45e588e7b 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -102,6 +102,10 @@ global:
   # The API URL to use for Slack notifications.
   [ slack_api_url: <secret> ]
   [ slack_api_url_file: <filepath> ]
+  [ slack_app_token: <secret> ]
+  [ slack_app_token_file: <filepath> ]
+  [ slack_app_url: <string> ]
+
   [ victorops_api_key: <secret> ]
   [ victorops_api_key_file: <filepath> ]
   [ victorops_api_url: <string> | default = "https://alert.victorops.com/integrations/generic/20131114/alert/" ]
@@ -1580,11 +1584,19 @@ The notification contains an [attachment](https://docs.slack.dev/legacy/legacy-m
 # Whether to notify about resolved alerts.
 [ send_resolved: <boolean> | default = false ]
 
-# The Slack webhook URL. Either api_url or api_url_file should be set.
+# The Slack webhook URL. Either api_url/api_url_file OR app_token/app_token_file should be set, but not both.
 # Defaults to global settings if none are set here.
 [ api_url: <secret> | default = global.slack_api_url ]
 [ api_url_file: <filepath> | default = global.slack_api_url_file ]
 
+# Slack App token for OAuth authentication. Mutually exclusive with api_url/api_url_file.
+# Defaults to global settings if no local authorization or webhook URL is configured.
+[ app_token: <secret> | default = global.slack_app_token ]
+[ app_token_file: <filepath> | default = global.slack_app_token_file ]
+
+# The Slack App URL. Required when using app_token authentication.
+[ app_url: <string> | default = global.slack_app_url ]
+
 # The channel or user to send notifications to.
 channel: <tmpl_string>
 
@@ -1606,7 +1618,7 @@ actions:
 fields:
   [ <field_config> ... ]
 [ footer: <tmpl_string> | default = '{{ template "slack.default.footer" . }}' ]
-[ mrkdwn_in: '[' <string>, ... ']' | default = ["fallback", "pretext", "text"] ]
+[ mrkdwn_in: [ <string>, ... ] | default = ["fallback", "pretext", "text"] ]
 [ pretext: <tmpl_string> | default = '{{ template "slack.default.pretext" . }}' ]
 [ short_fields: <boolean> | default = false ]
 [ text: <tmpl_string> | default = '{{ template "slack.default.text" . }}' ]