diff --git a/website/docs/docs/deploy/job-notifications.md b/website/docs/docs/deploy/job-notifications.md index b4673eb4ad..229d2b16f7 100644 --- a/website/docs/docs/deploy/job-notifications.md +++ b/website/docs/docs/deploy/job-notifications.md @@ -43,7 +43,7 @@ You can receive email alerts about jobs by configuring the dbt Cloud email notif ## Slack notifications -You can receive Slack alerts about jobs by setting up the Slack integration, then configuring the dbt Cloud Slack notification settings. +You can receive Slack alerts about jobs by setting up the Slack integration, then configuring the dbt Cloud Slack notification settings. dbt Cloud integrates with Slack via OAuth to ensure secure authentication. :::note If there has been a change in user roles or Slack permissions where you no longer have access to edit a configured Slack channel, please [contact support](mailto:support@getdbt.com) for assistance. @@ -52,16 +52,28 @@ If there has been a change in user roles or Slack permissions where you no longe ### Prerequisites - You must be an administrator of the Slack workspace. - You must be an account admin to configure Slack notifications in dbt Cloud. For more details, refer to [Users and licenses](/docs/cloud/manage-access/seats-and-users). -- Make sure the notification channel (where you want to receive alerts) is a public channel. The integration only supports public channels in the Slack workspace. +- The integration only supports _public_ channels in the Slack workspace. ### Set up the Slack integration -1. From the gear menu, select **Profile settings**. On your **User profile** page, scroll to the **Linked accounts** section. -1. In the **Linked accounts** section, find the Slack application and click **Link**. +1. From the gear menu, select **Account settings** and then select **Integrations** from the left sidebar. +1. Locate the **OAuth** section with the Slack application and click **Link**. -1. Allow dbt Labs to access the Slack workspace. If you are a member of multiple workspaces, you can select the appropriate workspace from the dropdown menu in the upper right corner. + +### Logged in to Slack +If you're already logged in to Slack, the handshake only requires allowing the app access. If you're a member of multiple workspaces, you can select the appropriate workspace from the dropdown menu in the upper right corner. +## Logged out + +If you're logged out or the Slack app/website is closed, you must authenticate before completing the integration. + +1. Complete the field defining the Slack workspace you want to integrate with dbt Cloud. + +2. Sign in with an existing identity or use email address and password. +3. Once you have authenticated successfully, accept the permissions. + + ### Configure Slack notifications 1. From the gear menu, choose **Notification settings**. @@ -80,5 +92,5 @@ If there has been a change in user roles or Slack permissions where you no longe ### Disable the Slack integration -1. From the gear menu, select **Profile settings**. On your **User profile** page, scroll to the **Linked accounts** section. -1. Find the Slack application in the **Linked accounts** section, click the trash can icon, and click **Unlink**. Channels that you configured will no longer receive Slack notifications. Channels that are configured by other account admins will continue to receive Slack notifications if they still have active Slack integrations. To migrate ownership of a Slack channel notification configuration, have another account admin edit the configuration. \ No newline at end of file +1. From the gear menu, select **Account settings**. On the **Integrations** page, scroll to the **OAuth** section. +1. Click the trash can icon (on the far right of the Slack integration) and click **Unlink**. Channels that you configured will no longer receive Slack notifications. _This is not an account-wide action._ Channels configured by other account admins will continue to receive Slack notifications if they still have active Slack integrations. To migrate ownership of a Slack channel notification configuration, have another account admin edit their configuration. diff --git a/website/static/img/docs/dbt-cloud/Link-your-Slack-Profile.png b/website/static/img/docs/dbt-cloud/Link-your-Slack-Profile.png index bdc4ad2fc5..246d6a903f 100644 Binary files a/website/static/img/docs/dbt-cloud/Link-your-Slack-Profile.png and b/website/static/img/docs/dbt-cloud/Link-your-Slack-Profile.png differ diff --git a/website/static/img/docs/dbt-cloud/accept-permissions.png b/website/static/img/docs/dbt-cloud/accept-permissions.png new file mode 100644 index 0000000000..d57a0a614c Binary files /dev/null and b/website/static/img/docs/dbt-cloud/accept-permissions.png differ diff --git a/website/static/img/docs/dbt-cloud/define-workspace.png b/website/static/img/docs/dbt-cloud/define-workspace.png new file mode 100644 index 0000000000..60df32c27c Binary files /dev/null and b/website/static/img/docs/dbt-cloud/define-workspace.png differ