> ## Documentation Index
> Fetch the complete documentation index at: https://sitegpt.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Slack integration
> Deploy your AI chatbot in Slack workspaces for team support
Connect your SiteGPT chatbot to Slack to provide instant AI-powered support directly in your team's workspace. Your bot responds to direct messages, channel mentions, and maintains conversation context across all interactions.
## How it works
Once connected, your chatbot integrates seamlessly with Slack:
Responds to private DMs for one-on-one support
Answers when mentioned in any channel
Maintains conversation history across messages
All conversations sync to your SiteGPT dashboard
## Prerequisites
A Slack workspace where you can install and manage apps
Workspace admin or owner permissions to create custom apps
A trained SiteGPT chatbot ready to deploy
## Setup
Navigate to **Integrations** in your SiteGPT dashboard, locate the **Slack** card, and click **Get Started**. A modal titled "Connecting Slack to SiteGPT" will appear.
Inside the integration modal, you'll see a **Manifest** section containing JSON configuration. Click the copy icon to copy the entire manifest to your clipboard.
This manifest defines your Slack app's features including bot user, OAuth scopes, and event subscriptions.
Visit [api.slack.com/apps](https://api.slack.com/apps) and click **Create New App** → **From an app manifest**.
Select your Slack workspace, paste the JSON manifest, and click **Next** → **Create**.
Slack automatically configures all required permissions and settings from the manifest.
On the app's **Basic Information** page, click **Install to Workspace** → **Allow**.
Navigate to **OAuth & Permissions** in the left menu and copy the **Bot User OAuth Token** (starts with `xoxb-`).
Store this token securely—you'll need it to connect SiteGPT.
Get the channel ID using either method:
Open the channel in Slack's web client. The URL contains `/archives/C...` where the string after `/archives/` is your channel ID.
Click the channel name → **About** tab → scroll to find the **Channel ID** at the bottom.
Return to the SiteGPT integration modal and enter:
* **Bot User OAuth Token** (from step 4)
* **Channel ID** (from step 5)
Click **Connect**. The button will change to **Disconnect** when successfully connected.
Open your Slack channel and send a test message. Your SiteGPT bot should respond with a welcome message and answer questions from your knowledge base.
Responses appear in threads with source citations for transparency.
## Using your chatbot in Slack
Users can send private DMs to your chatbot:
1. Find your chatbot in the Slack sidebar under **Apps**
2. Click to open a direct message
3. Type your question and press Enter
4. Get instant AI-powered answers
Perfect for sensitive questions or personal support requests.
Mention your chatbot in any channel where it's been added:
```
@YourBotName How do I reset my password?
```
The chatbot responds in a thread, keeping conversations organized and providing source citations.
Expand your bot's reach by adding it to multiple channels:
1. Open the target channel in Slack
2. Type `/invite @YourBotName`
3. Press Enter to add the bot
Add your bot to high-traffic support channels for maximum impact.
## How the bot behaves
Your bot automatically:
* Responds in threads to keep channels organized
* Includes source citations for transparency
* Maintains conversation history within threads
* Works in any channel where it's invited (use `/invite @YourBotName`)
* Only accesses messages where it's mentioned or DM'd
The Channel ID in SiteGPT settings determines the primary channel for system notifications.
## Managing the integration
Track your Slack bot's performance in the SiteGPT dashboard:
Navigate to **Chat History** to:
* Review conversation transcripts
* Analyze response accuracy
* Identify knowledge gaps
* Export conversation data
* Track usage metrics
Use conversation insights to improve your chatbot's training data.
Changes to your SiteGPT bot are immediately available in Slack:
* Add new training data
* Update chatbot instructions
* Modify appearance settings
* Configure lead collection
No reconnection required—just test with a new question.
To remove the Slack integration:
1. Open **Integrations** in SiteGPT
2. Click **Manage** next to Slack
3. Click **Disconnect**
Optionally, remove the app from Slack via the [Slack API console](https://api.slack.com/apps).
## Advanced features
Enable seamless handoff to human agents:
1. Configure [human support](/features/human-support) in SiteGPT
2. Users can request human assistance during conversations
3. Escalated conversations appear in your SiteGPT dashboard
4. Respond via email or your preferred support channel
Combine with Zapier to create support tickets automatically.
Capture leads directly in Slack conversations:
1. Enable [lead collection](/features/lead-collection) in SiteGPT
2. Configure trigger keywords (e.g., "pricing", "demo", "consultation")
3. Bot collects contact information when users show interest
4. Leads sync to your SiteGPT dashboard
Perfect for sales teams using Slack for customer communication.
Receive real-time notifications for Slack conversations:
Set up [webhooks](/developers/webhooks) to:
* Log conversations to your database
* Trigger custom workflows
* Send notifications to other systems
* Analyze chatbot performance
```json theme={null}
{
"event": "ADD_MESSAGE",
"data": {
"chatbotId": "chatbot_123",
"threadId": "thread_456",
"question": "How do I reset my password?",
"answer": "To reset your password..."
}
}
```
The app manifest includes these OAuth scopes:
**Bot scopes:**
* `app_mentions:read` - Read mentions
* `channels:read` - View public channels
* `chat:write` - Send messages
* `incoming-webhook` - Post messages to channels
* `im:history` - Read direct messages
* `channels:history` - Read channel messages
* `groups:history` - Read private channel messages
All scopes are automatically configured when you create the app from the manifest.
## Best practices
Help users understand what your bot can do:
* Add a welcome message explaining the bot's capabilities
* Pin a message in channels describing how to use the bot
* Include example questions in your Slack app home
* Set up conversation starters for common queries
**Example welcome message:**
> "Hi! I'm the SiteGPT support bot. Ask me anything about our products, pricing, or documentation. Mention me with @BotName or send me a DM!"
Regularly review conversations to enhance performance:
* Check **Chat History** weekly for common questions
* Add frequently asked questions to your training data
* Identify topics where the bot struggles
* Update chatbot instructions based on user feedback
Export conversation data to analyze trends and identify knowledge gaps.
Add your bot to channels where it provides the most value:
* **#support** - Primary customer support channel
* **#general** - Company-wide announcements and questions
* **#sales** - Lead qualification and product questions
* **#onboarding** - New employee questions
Avoid adding the bot to channels where it's not relevant (e.g., #random, #watercooler).
Provide a safety net for complex questions:
1. Enable [human support](/features/human-support) in SiteGPT
2. Configure escalation triggers (keywords, low confidence, user request)
3. Set up email notifications for your support team
4. Use Zapier to create support tickets automatically
This ensures users always get help, even when AI can't answer.
Protect your Slack integration:
* Store the Bot User OAuth Token securely (use environment variables)
* Regularly review OAuth scopes and remove unused permissions
* Monitor the Slack API console for suspicious activity
* Rotate tokens periodically for enhanced security
* Only grant workspace access to trusted team members
## Next steps
Set up escalation to human agents
Capture leads from Slack conversations
Receive real-time conversation notifications
Review and analyze Slack conversations