diff --git a/docs/organizations/integrations/images/codacy-slack-app-icon.png b/docs/organizations/integrations/images/codacy-slack-app-icon.png new file mode 100644 index 0000000000..e54e30d17b Binary files /dev/null and b/docs/organizations/integrations/images/codacy-slack-app-icon.png differ diff --git a/docs/organizations/integrations/slack-integration.md b/docs/organizations/integrations/slack-integration.md index 33e5a4f190..25ec65fdc7 100644 --- a/docs/organizations/integrations/slack-integration.md +++ b/docs/organizations/integrations/slack-integration.md @@ -7,21 +7,25 @@ The organization Slack integration for Security issues sends notifications to a To install the Slack integration: 1. **On Slack**: - 1. Access the [Incoming WebHooks](https://slack.com/apps/new/A0F7XDUAZ-incoming-webhooks) page on the App Directory of your Slack account. + 1. [Create the Codacy app](https://api.slack.com/apps?new_app=1&manifest_json=%7B%22display_information%22%3A%7B%22name%22%3A%22Codacy%22%2C%22description%22%3A%22Posts%20the%20new%20critical%20security%20issues%20Codacy%20finds%20in%20your%20repositories.%22%2C%22background_color%22%3A%22%231a2336%22%7D%2C%22features%22%3A%7B%22bot_user%22%3A%7B%22display_name%22%3A%22Codacy%22%2C%22always_online%22%3Afalse%7D%7D%2C%22oauth_config%22%3A%7B%22scopes%22%3A%7B%22bot%22%3A%5B%22incoming-webhook%22%5D%7D%7D%2C%22settings%22%3A%7B%22org_deploy_enabled%22%3Afalse%2C%22socket_mode_enabled%22%3Afalse%2C%22token_rotation_enabled%22%3Afalse%7D%7D) in Slack. Slack opens **Create from a manifest** with the app settings filled in, and notes that the manifest was created by a third party. - 1. Select the channel where you want to receive notifications and click **Add Incoming WebHooks Integration**. + 1. Select your workspace, click **Next**, then click **Create and Install**. - 1. Copy the Incoming WebHook URL (it starts with `https://hooks.slack.com/services/`). + 1. Select the channel where you want to receive notifications and click **Allow**. + + 1. Click **Go to App Settings**. Optionally, add the [Codacy logo](images/codacy-slack-app-icon.png) under **App icon & Preview**. + + 1. Open **Incoming Webhooks** and copy the webhook URL (it starts with `https://hooks.slack.com/services/`). 1. **On Codacy**: 1. Open your organization **Integrations**, page **Slack**. - 1. Paste the Incoming WebHook URL in the field and click **Install Slack**. + 1. Paste the webhook URL in the field and click **Install Slack**. ![Slack integration installation](images/slack-integration-install.png) -Once the Slack integration is installed, Codacy sends a confirmation message to the Slack channel you configured when creating the Incoming WebHook. From there on, Codacy notifies you on the same channel whenever a new critical Security issue is detected in the default branch of any repository in your organization. +Once the Slack integration is installed, Codacy sends a confirmation message to the Slack channel you selected when creating the app. From there on, Codacy notifies you on the same channel whenever a new critical Security issue is detected in the default branch of any repository in your organization. ![Slack integration message](images/slack-integration-message.png)