From 505baee65e551dc4980b894f45ccd3c9a5ecd442 Mon Sep 17 00:00:00 2001
From: socar-dini <0327jane@gmail.com>
Date: Fri, 27 Oct 2023 15:36:42 +0900
Subject: [PATCH] docs: revert delete

---
 docs/managed-datahub/saas-slack-setup.md | 111 +++++++++++++++++++++++
 1 file changed, 111 insertions(+)
 create mode 100644 docs/managed-datahub/saas-slack-setup.md

diff --git a/docs/managed-datahub/saas-slack-setup.md b/docs/managed-datahub/saas-slack-setup.md
new file mode 100644
index 0000000000000..8d4519b878cd8
--- /dev/null
+++ b/docs/managed-datahub/saas-slack-setup.md
@@ -0,0 +1,111 @@
+import FeatureAvailability from '@site/src/components/FeatureAvailability';
+
+# Configure Slack For Notifications
+
+<FeatureAvailability saasOnly />
+
+## Install the DataHub Slack App into your Slack workspace
+
+The following steps should be performed by a Slack Workspace Admin. 
+- Navigate to  https://api.slack.com/apps/
+- Click Create New App
+- Use “From an app manifest” option
+- Select your workspace
+- Paste this Manifest in YAML. Suggest changing name and `display_name` to be `DataHub App YOUR_TEAM_NAME` but not required. This name will show up in your slack workspace
+```yml
+display_information:
+  name: DataHub App
+  description: An app to integrate DataHub with Slack
+  background_color: "#000000"
+features:
+  bot_user:
+    display_name: DataHub App
+    always_online: false
+oauth_config:
+  scopes:
+    bot:
+      - channels:read
+      - chat:write
+      - commands
+      - groups:read
+      - im:read
+      - mpim:read
+      - team:read
+      - users:read
+      - users:read.email
+settings:
+  org_deploy_enabled: false
+  socket_mode_enabled: false
+  token_rotation_enabled: false
+```
+
+Confirm you see the Basic Information Tab
+
+![](https://raw.githubusercontent.com/datahub-project/static-assets/main/imgs/integrations/slack/slack_basic_info.png)
+
+- Click **Install to Workspace**
+- It will show you permissions the Slack App is asking for, what they mean and a default channel in which you want to add the slack app
+    - Note that the Slack App will only be able to post in channels that the app has been added to. This is made clear by slack’s Authentication screen also.
+- Select the channel you'd like notifications to go to and click **Allow**
+- Go to DataHub App page
+    - You can find your workspace's list of apps at https://api.slack.com/apps/
+
+## Generating a Bot Token
+
+- Go to **OAuth & Permissions** Tab
+
+![](https://raw.githubusercontent.com/datahub-project/static-assets/main/imgs/integrations/slack/slack_oauth_and_permissions.png)
+
+Here you'll find a “Bot User OAuth Token” which DataHub will need to communicate with your slack through the bot. 
+In the next steps, we'll show you how to configure the Slack Integration inside of Acryl DataHub.
+
+## Configuring Notifications
+
+> In order to set up the Slack integration, the user must have the `Manage Platform Settings` privilege. 
+
+To enable the integration with slack
+- Navigate to **Settings > Integrations**
+- Click **Slack**
+- Enable the Integration 
+- Enter the **Bot Token** obtained in the previous steps
+- Enter a **Default Slack Channel** - this is where all notifications will be routed unless 
+- Click **Update** to save your settings
+
+![](https://raw.githubusercontent.com/datahub-project/static-assets/main/imgs/integrations/slack/slack_add_token.png)
+
+To enable and disable specific types of notifications, or configure custom routing for notifications,  start by navigating to **Settings > Notifications**.
+To enable or disable a specific notification type in Slack, simply click the check mark. By default, all notification types are enabled.
+To customize the channel where notifications are send, click the button to the right of the check box.
+
+![](https://raw.githubusercontent.com/datahub-project/static-assets/main/imgs/integrations/slack/slack_channel.png)
+
+If provided, a custom channel will be used to route notifications of the given type. If not provided, the default channel will be used. 
+That's it! You should begin to receive notifications on Slack. Note that it may take up to 1 minute for notification settings to take effect after saving. 
+
+## Sending Notifications
+
+For now we support sending notifications to
+- Slack Channel ID (e.g. `C029A3M079U`)
+- Slack Channel Name (e.g. `#troubleshoot`)
+- Specific Users (aka Direct Messages or DMs) via user ID 
+
+## How to find Team ID and Channel ID in Slack
+
+- Go to the Slack channel for which you want to get channel ID
+- Check the URL e.g. for the troubleshoot channel in OSS DataHub slack
+
+![](https://raw.githubusercontent.com/datahub-project/static-assets/main/imgs/integrations/slack/slack_channel_url.png)
+
+- Notice `TUMKD5EGJ/C029A3M079U` in the URL
+  - Team ID = `TUMKD5EGJ` from above
+  - Channel ID = `C029A3M079U` from above
+
+## How to find User ID in Slack
+
+- Go to user DM
+- Click on their profile picture
+- Click on View Full Profile
+- Click on “More”
+- Click on “Copy member ID”
+
+![](https://raw.githubusercontent.com/datahub-project/static-assets/main/imgs/integrations/slack/slack_user_id.png)
\ No newline at end of file