# Slack

How the connection HackenProof -> Slack works

This guide explains how our Slack bot can help companies when they run a bounty program at HackenProof.

As you know, HackenProof uses a ticket-based system that has [different stages of reports](/bug-bounty/reports-basics.md) processing.

Once you connect your bug bounty program to your Slack server, the bot will send notifications about the following:

* new reports (that includes the Program name, Report title, Report severity, and Report URL)
* report status changes
* report severity changes

<figure><img src="/files/Z8Oq5ziR806Y3ccgD8iP" alt=""><figcaption></figcaption></figure>

<mark style="background-color:purple;">Note! The Slack bot will not re-send messages when changes happen. The bot will change the previous message that is related to a specific report.</mark>

## Connect the HackenProof bot to your Slack space <a href="#h_3956254717" id="h_3956254717"></a>

* Select a Bug Bounty Program that you want to integrate with your Slack workspace.
* Go to the Integrations section and click on the Slack app:

<figure><img src="/files/yLt3exdww4yyEARMXsJc" alt=""><figcaption></figcaption></figure>

* Click on '**Add to Slack'** button

<figure><img src="/files/FqdSvQzUxo2E5H1iCT3L" alt=""><figcaption></figcaption></figure>

* Select your preferred Slack channel, then click the **'Allow'** button:

<figure><img src="/files/NLkEoxMU5dDgYDXuvtqt" alt=""><figcaption></figcaption></figure>

* Now your bug bounty program is connected to your Slack space:

<figure><img src="/files/i2ZzICCHDVrdiVBe1OSz" alt=""><figcaption></figcaption></figure>

## Approve the HackneProof Slack bot (important). <a href="#h_4e89e8078b" id="h_4e89e8078b"></a>

<mark style="background-color:purple;">Note! If you are not a Slack space admin, you should ask someone from your team to approve the HackneProof Slack bot</mark>. To approve the HackenProof bot in your Slack space:

* Click on your **workspace name** in the top-left corner.

<figure><img src="/files/Ra4cVhDcuE2K7IbNP2dW" alt=""><figcaption></figcaption></figure>

* From the dropdown menu, select **"Settings & administration"** and then click on **"Manage apps"**. This will take you to the app management page.

<figure><img src="/files/jbDYBtXfOr7CFzBfywM2" alt=""><figcaption></figcaption></figure>

* In the **'Manage apps'** section, you'll see a list of available apps and integrations. Find the **'HackenProof Notifications**' app and click on it.

<figure><img src="/files/fVpnfdndyzOXYqS001E4" alt=""><figcaption></figcaption></figure>

* Navigate to the 'App Details' tab

<figure><img src="/files/Y2jPduKpnbliSHbc14fR" alt=""><figcaption></figcaption></figure>

* Click on 'Approve' button

<figure><img src="/files/OZcyucUvG92hGHunfu0s" alt=""><figcaption></figcaption></figure>

## Connect the bot to the Private channel <a href="#h_8337d5f657" id="h_8337d5f657"></a>

To add a HackenProof notification bot to your Slack private channel:

* Navigate to the settings of the preferred private Slack channel.

<figure><img src="/files/CCsnc5vg6uEDq7mtq0Fc" alt=""><figcaption></figcaption></figure>

* Choose the **'Integrations'** section.

<figure><img src="/files/9C1QbOlY0oZLC0SwfZuS" alt=""><figcaption></figcaption></figure>

* Click on **'Add app'** button.

<figure><img src="/files/EEIzc2AG9GIpdwuIgi5i" alt=""><figcaption></figcaption></figure>

* Find the **'HackenProof Notifications'** app and click on **'Add'** button.

<figure><img src="/files/tlXUvdA7kGEjTcXSQSbV" alt=""><figcaption></figcaption></figure>

## Good to know <a href="#h_4ba09a094e" id="h_4ba09a094e"></a>

1. If a company has a few programs, and you want to connect all of them to your Slack space, then you need to set up the integration for each program.
2. You can use different Slack channels for different programs.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hackenproof.com/welcome/integrations/slack.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.