feat(docs) steps on handling workspace admin approvals for slack inst…

…allation (#11726)
datahub-project · Oct 28, 2024 · 99d2de2 · 99d2de2
1 parent e90d744
commit 99d2de2
Showing 1 changed file with 13 additions and 1 deletion.
diff --git 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)