From 99d2de218c72982c04d28e7da912c4c9794182f4 Mon Sep 17 00:00:00 2001
From: Jay <159848059+jayacryl@users.noreply.github.com>
Date: Mon, 28 Oct 2024 18:27:38 -0400
Subject: [PATCH] feat(docs) steps on handling workspace admin approvals for
 slack installation (#11726)

---
 docs/managed-datahub/slack/saas-slack-setup.md | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/docs/managed-datahub/slack/saas-slack-setup.md b/docs/managed-datahub/slack/saas-slack-setup.md
index 590f57d2c2e70..f242d40203d08 100644
--- a/docs/managed-datahub/slack/saas-slack-setup.md
+++ b/docs/managed-datahub/slack/saas-slack-setup.md
@@ -29,7 +29,11 @@ The following steps should be performed by a Slack Workspace Admin.
 <p align="center">
   <img width="70%"  src="https://raw.githubusercontent.com/datahub-project/static-assets/main/imgs/saas/slack/setup_4.png"/>
 </p>
-6. You will be automatically re-directed to Slack to confirm DataHub Slack App's permissions and complete the installation process:
+6. You will be automatically re-directed to Slack to confirm DataHub Slack App's permissions and complete the installation process.
+
+:::note
+You may need approval from a workspace admin to do this step. Learn about [what to do in this scenario here](#workspace-admin-approval-guide).
+:::
 <p align="center">
   <img width="70%"  src="https://raw.githubusercontent.com/datahub-project/static-assets/main/imgs/saas/slack/setup_5.png"/>
 </p>
@@ -44,6 +48,14 @@ The following steps should be performed by a Slack Workspace Admin.
 
 Now proceed to the [Subscriptions and Notifications page](https://datahubproject.io/docs/managed-datahub/subscription-and-notification) to see how you can subscribe to be notified about events on the platform, or visit the [Slack App page](saas-slack-app.md) to see how you can use DataHub's powerful capabilities directly within Slack.
 
+### Workspace admin approval guide
+In some workspaces, you will find at step 6 above you will need approval from your workspace admin. In this case, you will want to:
+1. On step #6 above, continue by clicking the button to request their approval.
+2. Once approved, you will get a notification from the **Slack bot** that your request has been approved. Follow the link it provides to complete the process.
+**If you do not get the message:** visit [api.slack.com/apps](https://api.slack.com/apps), open your DataHub app and complete the installation from there.
+3. Once it is done, you can visit `<your-datahub-instance-url>/settings/notifications`, and send a test notification to verify everything's working.
+4. **Making Slack commands work:** when running Slack commands such as `/datahub search my dataset` you may get a `dispatch_failed` error. To resolve this, see [the steps here](https://datahubproject.io/docs/managed-datahub/slack/saas-slack-troubleshoot#slack-bot-issues).
+
 <!-- NOTE: we are hiding this method for now. If a need arises, we can uncomment below docs.
 # Bot Token Method (Not recommended)