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

# Collaboration

Connect your collaboration platforms to Draftt to receive governance notifications, alerts, and remediation updates where your team already works.

## Supported Platforms

<CardGroup cols={3}>
  <Card title="Slack" icon="slack">
    Real-time notifications in Slack channels.
  </Card>

  <Card title="Microsoft Teams" icon="microsoft">
    Notifications via Microsoft Teams channels.
  </Card>

  <Card title="Email" icon="envelope">
    Email notifications for governance findings and alerts.
  </Card>
</CardGroup>

## Setup Instructions

<AccordionGroup>
  <Accordion title="Slack">
    Slack connects via **Slack OAuth**. Draftt requests the following scopes:

    * `chat:write` -- Post messages to channels
    * `chat:write.public` -- Post to channels without joining
    * `channels:read` -- List available public channels
    * `groups:read` -- List available private channels

    <Steps>
      <Step title="Start the connection">
        In Draftt, go to **Integrations > Collaboration > Slack > Add**.
      </Step>

      <Step title="Authorize with Slack">
        You will be redirected to Slack to authorize the Draftt app. Select the workspace you want to connect and approve the requested permissions.
      </Step>

      <Step title="Select channels">
        After authorization, configure which Slack channels should receive governance notifications.
      </Step>

      <Step title="Confirm in Draftt">
        The Slack integration appears in your connected collaboration platforms.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Microsoft Teams">
    <Steps>
      <Step title="Start the connection">
        In Draftt, go to **Integrations > Collaboration > Microsoft Teams > Add**.
      </Step>

      <Step title="Authorize with Microsoft">
        Follow the Microsoft OAuth flow to authorize Draftt to post messages to your Teams channels.
      </Step>

      <Step title="Select channels">
        Choose which Teams channels should receive governance notifications.
      </Step>

      <Step title="Confirm in Draftt">
        The Microsoft Teams integration appears in your connected collaboration platforms.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Email">
    <Steps>
      <Step title="Start the connection">
        In Draftt, go to **Integrations > Collaboration > Email > Add**.
      </Step>

      <Step title="Configure recipients">
        Add email addresses or distribution lists that should receive governance notifications.
      </Step>

      <Step title="Create">
        Click **Create** to finalize the connection.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## How It Works

Draftt sends notifications to your connected collaboration platforms when governance events occur. Notifications can include new policy violations, status changes on existing findings, remediation progress updates, and summary digests.

Configure notification rules in Draftt to control which events trigger messages and which channels or recipients receive them.

## Verifying Your Connection

After setup, return to **Integrations > Collaboration** in Draftt. Each connected platform shows a status:

* **Healthy** - Draftt can send messages as expected.
* **Unhealthy** - Check that the OAuth authorization has not been revoked and that the Draftt app has not been removed from your workspace.
