> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corgea.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

> Setting up the Slack Integration with Corgea

Corgea's Slack integration allows you to receive notifications in your Slack workspace when a scan is completed using Slack's Workflow Builder.

## Prerequisites

Before setting up the integration, ensure you have:

* Administrative access to your Corgea account
* Appropriate permissions in your Slack workspace

## Setting Up Slack Workflow Builder

This method provides flexibility by allowing you to create custom workflows that can route notifications to different channels or trigger other automated actions.

<Steps>
  <Step title="Create a Workflow">
    1. In Slack, click on your workspace name
    2. Select "Tools" → "Workflow Builder"
    3. Click "Create" to start a new workflow
    4. Select "Webhook" as the trigger
    5. Give your workflow a name and click "Next"
  </Step>

  <Step title="Configure Workflow Steps">
    1. After creating the webhook, copy the provided Webhook URL
    2. Add steps to your workflow (e.g., "Send a message")
    3. Configure the message format using variables from the webhook payload

    Here's an example payload that Corgea would send over.

    ```json theme={null}
          {
        "title": "🐕 Corgea scan is complete!",
        "user": "john@example.com",
        "project": "My Project",
        "num_issues": 10,
        "severity_counts": {
          "HIGH": 2,
          "MEDIUM": 3,
          "LOW": 5
        },
        "scan_url": "https://corgea.app/scan/?scan_id=123",
        "message": "The Corgea scan for project My Project has completed with 10 issues found.\n🔴 - 2 high severity issues\n🟠 - 3 medium severity issues\n🟡 - 5 low severity issues\n\nView full scan details at: https://corgea.app/scan/?scan_id=123"
      }
    ```

    You can use our canned message or create your own using variables.

    4. Click "Add a Step" and then select "Finish Up"
       * Sending messages to multiple channels
       * Creating reminders
       * Updating channel topics
       * Integrating with other Slack apps
    5. Make sure the workflow details and permission are correct before publishing.
  </Step>

  <Step title="Configure in Corgea">
    1. Log in to your Corgea account and go to "Integrations"
    2. Find the Slack section and click "Add Integration"
    3. Select "Slack Workflow"
    4. Enter a name for the integration
    5. Paste the Workflow Webhook URL
    6. Click "Save"
    7. Click "Test" to ensure the integration is working
  </Step>
</Steps>

## Notification Content

Corgea will send the following information to your Slack workflow:

* User who initiated the scan
* Project name
* Number of issues found
* Severity breakdown
* Direct link to scan results

## Customization Options

With Workflow Builder, you can:

* Create conditional logic for different types of notifications
* Route messages to different channels based on severity
* Trigger custom automations based on scan results
* Integrate with other Slack workflows and apps
* Use variables to customize message format and content

## Additional Resources

* [Slack Workflow Builder Guide](https://slack.com/help/articles/360035692513-Guide-to-Workflow-Builder)

By configuring the Workflow Builder integration, you can ensure your team stays informed about security scan results and take advantage of Slack's automation capabilities for a more streamlined security workflow.