Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
14 changes: 9 additions & 5 deletions docs/organizations/integrations/slack-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand Down
Loading