Slack

Caution

We currently don’t support Slack connections in the Hawkeye dashboard.

Connecting Hawkeye to with your Slack account allows you to get alerts from your Slack workspace. This integration ensures efficient communication by keeping your team informed on important incidents and events.

For an easy connection, you will authenticate using a Slack App that you create within your Slack workspace.

Note

For each step, we’ve created a short demo walkthrough and a step-by-step guide. You can check out the demo for a visual guide to setting up your Slack connection!

Step 1: Setup Slack Integration

To get started, you’ll need to set up a new Slack App and obtain the necessary credentials. The following steps outline how to configure the Slack integration:

1. Navigate to Slack API: Sign in to your Slack account, then open the Slack API page and click on Create New App.

   

2. Create Slack App: Select From scratch to create a new Slack App.

   

   Provide a name for the app and select the appropriate Slack workspace.

   

3. Configure Scopes & Permissions: In your newly created app, navigate to OAuth & Permissions in the sidebar. Under Scopes, add the necessary permissions. For example:

   • channels:read for reading available channels.

     

4. Install App to Workspace: After adding the required scopes, scroll up to the OAuth Tokens section and click on Install to Workspace name.

   

   This will install the app in your selected Slack workspace and generate an OAuth token.

5. Copy OAuth Token: After installation, an OAuth Access Token will be generated. Copy this token as it will be needed to authenticate Hawkeye.

6. Create Webhook URL: In the same app settings, go to the Incoming Webhooks section.

   

   Enable incoming webhooks and click Add New Webhook to Workspace. Choose the channel where you want to send Hawkeye alerts and click Allow.

7. Copy Webhook URL: A webhook URL will be generated for the selected channel. Copy this URL to be used in Hawkeye.

Step 2: Add Slack Connection to Hawkeye

Now that you have your OAuth Token and Webhook URL, proceed to the Hawkeye dashboard to complete the integration.

1. Navigate to the Connections Tab: In the Hawkeye dashboard, go to the Connections section and click on New Connection.

   

2. Select Slack: From the list of available integrations, select Slack.

   Then, click Next at the top right corner.

3. Enter Credentials: Provide the following credentials:

   • Name: Give your connection a descriptive name (e.g., Slack Alerts).
   • OAuth Token: Paste the OAuth Access Token you generated from Slack.
   • Webhook URL: Paste the Webhook URL from your Slack app.

   Click Save to complete the setup.

4. Verify connection: Once the connection is successfully established, navigate to the connections section in Hawkeye. You should see the Slack connection card displayed on your dashboard.