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

# Slack

> Receive real-time notifications in Slack when Policy violations occur

export const domain = 'https://eu.whitecircle.com';

White Circle provides a native Slack integration that sends notifications directly to your Slack workspace when Policy violations are detected.

## Available Events

Currently, the Slack integration supports:

* **Policy violation** — Get notified when content violates selected Policies within selected Environments

<Info>More event types will be added in the future.</Info>

## Example Notification

When a violation is detected, you'll receive a message like this in your Slack channel:

<Frame>
  <img src="https://mintcdn.com/whitecircle/qmSGRNF95Ca4SZT_/images/slack/slack-example.jpeg?fit=max&auto=format&n=qmSGRNF95Ca4SZT_&q=85&s=b810e9d3ea40e5d1fe427dc1f9e70e65" alt="Example Slack notification showing a Policy violation" style={{ height: "300px" }} width="1164" height="952" data-path="images/slack/slack-example.jpeg" />
</Frame>

The notification includes:

* A link to the session details
* The Environment name
* The external ID (if provided)
* The list of flagged Policies

## Setting Up the Integration

<Steps>
  <Step title="Open Workspace Settings">
    Go to your <Link href={`${domain}/settings/integrations`} target="_blank">Workspace Settings → Integrations</Link> page.
  </Step>

  <Step title="Connect Slack">
    Click on the Slack integration and authorize White Circle to send messages to your workspace.
  </Step>

  <Step title="Configure Events">
    Add one or more events to listen for. For each event, configure:

    * **Event type** — Select "Policy violation"
    * **Channel** — Choose which Slack channel should receive notifications

    <Accordion title="Can't find your private channel?" icon="lock">
      Private channels require an extra step. You need to invite the White Circle Notifications app to the channel first:

      1. Open the private channel in Slack
      2. Type `/invite @White Circle Notifications`
      3. Refresh the integrations page — your channel should now appear in the dropdown
    </Accordion>

    * **Environments** — Select which Environments to monitor
    * **Policies** — Select which Policies should trigger notifications

    <Frame>
      <img src="https://mintcdn.com/whitecircle/qmSGRNF95Ca4SZT_/images/slack/integration.png?fit=max&auto=format&n=qmSGRNF95Ca4SZT_&q=85&s=d98e16f1296992c2b4189e74ce0fbc15" alt="Example Slack notification showing a Policy violation" width="1518" height="1576" data-path="images/slack/integration.png" />
    </Frame>
  </Step>

  <Step title="Save">
    Click **Save** to activate the integration.
  </Step>
</Steps>
