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

# Slack

> Get real-time notifications for leads, conversations, and escalations in your Slack channels.

## Overview

Connect your Slack workspace to InsiteChat and receive instant notifications when important events happen — new leads captured, conversations escalated, messages received, and more.

## Setup

<Steps>
  <Step title="Create a Slack app">
    Go to your chatbot's **Webhooks** tab in the InsiteChat dashboard and click **Connect Slack**.
  </Step>

  <Step title="Authorize InsiteChat">
    You'll be redirected to Slack. Select your workspace and click **Allow** to grant InsiteChat permission to post messages.
  </Step>

  <Step title="Pick a channel">
    After connecting, click **Change channel** to select which Slack channel receives notifications. Make sure to invite the InsiteChat bot to the channel with `/invite @InsiteChat`.
  </Step>

  <Step title="Choose events">
    Select which events trigger Slack notifications:

    * **Lead Captured** — when a visitor submits the lead form
    * **Message Received** — when a visitor sends a message
    * **Conversation Started** — when a new chat session begins
    * **Conversation Escalated** — when a visitor requests human help
  </Step>
</Steps>

## Notification format

Slack notifications use rich Block Kit formatting:

* **Lead Captured** — shows name, email, and phone in a structured card
* **Message Received** — shows the visitor's message with session ID
* **Conversation Escalated** — urgent alert with message count
* **Conversation Started** — notification with session details

## Testing

Click **Send Test** on the Slack card in your Webhooks tab. You should see a test message appear in your selected Slack channel within seconds.

## Disconnecting

Click **Disconnect** on the Slack card to remove the integration. Notifications will stop immediately.

## Requirements

* A Slack workspace where you have permission to install apps
* InsiteChat Starter plan or above (free plan supported for testing)
