Skip to main content
Connect your SiteGPT chatbot to Slack to provide instant AI-powered support directly in your team’s workspace.

​
Prerequisites

  • An active SiteGPT chatbot
  • Admin access to your Slack workspace
  • Slack integration feature enabled on your plan

​
Setting up Slack integration

1

Create a Slack app

  1. Go to Slack API and click Create New App
  2. Choose From an app manifest
  3. Select your workspace
2

Configure app manifest

In your SiteGPT dashboard:
  1. Go to Integrations → Slack
  2. Copy the Initial App Manifest.json provided
  3. Paste it into the Slack app manifest editor
  4. Review and create the app
3

Get OAuth token and channel ID

In your Slack app settings:
  1. Go to OAuth & Permissions
  2. Click Install to Workspace and authorize
  3. Copy the Bot User OAuth Token (starts with xoxb-)
  4. Get your channel ID from Slack (right-click channel → View channel details)
4

Connect in SiteGPT

Back in your SiteGPT dashboard:
  1. Enter the Bot User OAuth Token
  2. Enter the Channel ID
  3. Click Connect
  4. Copy the Final App Manifest.json that appears
5

Update Slack app manifest

Return to your Slack app settings:
  1. Go to App Manifest
  2. Replace the manifest with the Final App Manifest.json from SiteGPT
  3. Save changes
6

Test the integration

  1. Invite your bot to a channel: /invite @YourBotName
  2. Send a test message mentioning the bot
  3. Verify the bot responds correctly
Watch the video tutorial above for a step-by-step walkthrough of the setup process.

​
How it works

Once connected, your chatbot:
  • Responds to direct messages in Slack
  • Can be mentioned in channels using @YourBotName
  • Maintains conversation context across messages
  • Syncs all conversations back to your SiteGPT dashboard

​
Using your chatbot in Slack

  • Direct messages
  • Channel mentions
  • Adding to channels
Users can send direct messages to your chatbot for private conversations:
1

Find your chatbot

Find your chatbot in the Slack sidebar under Apps
2

Open direct message

Click to open a direct message
3

Ask questions

Type your question and press Enter
4

Get instant answers

The chatbot responds instantly with AI-powered answers

​
Managing the integration

​
View connection status

From the Integrations page, you can:
  • See if Slack is connected
  • View the current configuration
  • Access the app manifest
  • Disconnect the integration

​
Monitor conversations

All Slack conversations appear in your SiteGPT dashboard under Chat History, where you can:
  • Review conversation transcripts
  • Analyze chatbot performance
  • Identify common questions
  • Export conversation data

​
Disconnect

To disconnect Slack:
  1. Go to Integrations in your chatbot dashboard
  2. Click on Slack
  3. Click Disconnect and confirm
This removes the chatbot from your Slack workspace immediately.

​
Required Slack permissions

The integration requires these OAuth scopes:
  • User scopes
  • Bot scopes
  • channels:history - Read messages in public channels
  • im:history - Read direct messages
  • im:read - View direct message info
  • identify - View user identity
  • channels:read - View public channels
  • users:read - View users
  • mpim:read - View group messages
  • chat:write - Send messages
  • groups:write - Manage private channels

​
Troubleshooting

If your chatbot isn’t responding in Slack, try these solutions:
  • Verify the integration is still connected in your dashboard
  • Check that the bot has been invited to the channel (/invite @YourBotName)
  • Ensure your chatbot has trained content to answer questions
  • Verify the Bot User OAuth Token is still valid
  • Check that the app manifest is up to date
If you encounter connection errors, verify these settings:
  • Verify the Bot User OAuth Token is correct (starts with xoxb-)
  • Ensure the Channel ID is valid
  • Check that the Slack app is installed in your workspace
  • Verify the app manifest matches the Final App Manifest.json from SiteGPT
If conversations aren’t appearing in your dashboard:
  • Check your internet connection
  • Verify the integration status
  • Wait a few minutes for sync to complete
  • Ensure the webhook URL in your Slack app manifest is correct

​
Best practices

  • Set clear expectations - Add a welcome message in your Slack app home explaining what your chatbot can help with
  • Monitor regularly - Review Slack conversations to improve your chatbot’s responses
  • Use channels strategically - Add your chatbot to high-traffic support channels
  • Provide escalation - Enable human support for complex questions
  • Keep permissions minimal - Only grant the required OAuth scopes

​
Next steps

Human support

Set up escalation to human agents

Lead collection

Capture leads from Slack conversations
⌘I