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

# Slack Integration

> Connect Living Security to Slack to send training notifications, security alerts, and playbook updates to your workspace.

The Slack integration enables Living Security to send notifications directly to your Slack workspace. Notify users about training assignments, alert security teams about risk events, and keep managers informed about team progress.

<Note>
  For nudge and playbook delivery setup, start at **Settings → Communications → Channels** and click the **Slack** card. This page covers the underlying Slack app configuration.
</Note>

## Prerequisites

Before configuring the Slack integration, ensure you have:

* Slack workspace admin or app installation permissions
* Access to the Slack API portal at [api.slack.com](https://api.slack.com)
* Living Security admin privileges

## Creating a Slack App

<Steps>
  <Step title="Create a new Slack app">
    1. Go to [api.slack.com/apps](https://api.slack.com/apps)
    2. Click **Create New App**
    3. Select **From scratch**
    4. Enter an app name (e.g., "Living Security")
    5. Select your workspace
    6. Click **Create App**

    <Check>
      Your app appears in the Slack API dashboard.
    </Check>
  </Step>

  <Step title="Configure OAuth scopes">
    1. In the left sidebar, click **OAuth & Permissions**
    2. Scroll to **Bot Token Scopes**
    3. Add the following scopes:

    | Scope               | Purpose                                   |
    | ------------------- | ----------------------------------------- |
    | `chat:write`        | Send messages to channels                 |
    | `chat:write.public` | Send messages to channels without joining |
    | `users:read`        | Look up user information                  |
    | `users:read.email`  | Match users by email address              |

    <Tip>
      Only add the scopes your organization needs. Fewer scopes means better security.
    </Tip>
  </Step>

  <Step title="Install the app to your workspace">
    1. Scroll to the top of **OAuth & Permissions**
    2. Click **Install to Workspace**
    3. Review the permissions and click **Allow**

    <Check>
      A **Bot User OAuth Token** appears starting with `xoxb-`.
    </Check>
  </Step>

  <Step title="Get your signing secret">
    1. In the left sidebar, click **Basic Information**
    2. Scroll to **App Credentials**
    3. Copy the **Signing Secret**

    <Warning>
      Keep your signing secret private. Never share it in public repositories or logs.
    </Warning>
  </Step>
</Steps>

## Adding Credentials to Living Security

<Steps>
  <Step title="Navigate to Outbound Integrations">
    Go to **Settings → Integrations → Outbound** and click on the **Slack** card.
  </Step>

  <Step title="Add your credentials">
    Click **Add Credential** and enter:

    <ParamField body="botToken" type="string" required>
      Your Bot User OAuth Token starting with `xoxb-`. Found in **OAuth & Permissions**.
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      Your app's Signing Secret. Found in **Basic Information → App Credentials**.
    </ParamField>

    <ParamField body="appToken" type="string">
      Optional. Required only for Socket Mode connections. Starts with `xapp-`.
    </ParamField>

    <ParamField body="label" type="string">
      Optional. A friendly name for this credential (e.g., "Production Slack").
    </ParamField>
  </Step>

  <Step title="Save and verify">
    Click **Save**. The credential appears in your list with an **active** status.

    <Check>
      Your Slack integration is now connected and ready to send notifications.
    </Check>
  </Step>
</Steps>

## Notification Types

Once connected, Living Security can send the following notification types to Slack:

| Notification             | Description                                |
| ------------------------ | ------------------------------------------ |
| Training assignments     | Alert users when new training is assigned  |
| Training reminders       | Remind users of upcoming deadlines         |
| Completion confirmations | Confirm when training is completed         |
| Security alerts          | Notify security teams of risk events       |
| Playbook summaries       | Send periodic playbook performance updates |

## Troubleshooting

<AccordionGroup>
  <Accordion title="Messages not appearing in channels">
    * Verify the bot has been invited to the channel (`/invite @YourBotName`)
    * Check that `chat:write.public` scope is added for posting to public channels without joining
    * Confirm the channel ID is correct (use channel ID, not name)
  </Accordion>

  <Accordion title="Invalid token error">
    * Ensure you copied the complete token starting with `xoxb-`
    * Verify the app is still installed to your workspace
    * Check if the token was regenerated (requires updating in Living Security)
  </Accordion>

  <Accordion title="Rate limiting">
    Slack limits API requests. If you see rate limit errors:

    * Reduce notification frequency
    * Consolidate multiple notifications into digest messages
    * Contact support for high-volume use cases
  </Accordion>
</AccordionGroup>

## Best Practices

<Tip>
  Create a dedicated Slack channel for Living Security notifications (e.g., `#security-training`) to keep alerts organized and reduce noise in general channels.
</Tip>

* Use meaningful credential labels when managing multiple workspaces
* Regularly audit which channels receive notifications
* Set up notification digests instead of individual messages for high-volume alerts
* Review Slack app permissions quarterly and remove unused scopes

## Related

<CardGroup cols={2}>
  <Card title="Email Integration" icon="envelope" href="/integrations/outbound/email">
    Configure email as a delivery channel.
  </Card>

  <Card title="Teams Integration" icon="microsoft" href="/integrations/outbound/teams">
    Configure Microsoft Teams as a delivery channel.
  </Card>

  <Card title="Communication Log" icon="clock-rotate-left" href="/features/communications/log">
    Track Slack delivery status and history.
  </Card>

  <Card title="How to Set Up a New Integration" icon="plug" href="/integrations/managing/setup">
    General integration setup guide.
  </Card>
</CardGroup>