Back to Documentation

Slack Integration

Bring AI-powered support to your Slack workspace. Respond to messages, handle mentions, and manage conversations seamlessly.

Prerequisites

  • Slack Workspace

    Admin access to install apps in your workspace

  • AgentPro Account

    An active AgentPro account with at least one chatbot configured

  • Chatbot with Knowledge Base

    A trained chatbot ready to handle Slack messages

Step-by-Step Setup

1Create a Slack App

  1. 1Go to api.slack.com/apps and click Create New App
  2. 2Select From scratch
  3. 3Enter a name (e.g., "AgentPro Bot") and select your workspace
  4. 4Click Create App

2Configure OAuth & Permissions

  1. 1Go to OAuth & Permissions in the sidebar
  2. 2
    Add these Bot Token Scopes:
    app_mentions:readchannels:historychat:writeim:historyim:readim:writeusers:read

3Enable Event Subscriptions

  1. 1Go to Event Subscriptions and toggle it On
  2. 2
    Enter the Request URL (you'll get this from AgentPro):
    https://agentpro.chat/api/v1/webhooks/slack/{channel_id}
  3. 3
    Subscribe to these Bot Events:
    app_mentionmessage.channelsmessage.im

4Install to Workspace & Configure in AgentPro

  1. 1Go to Install App and click Install to Workspace
  2. 2Copy the Bot User OAuth Token (starts with xoxb-)
  3. 3Copy the Signing Secret from Basic Information
  4. 4In AgentPro, go to Dashboard → Channels → Slack
  5. 5Enter the Bot Token, Signing Secret, and select a chatbot
  6. 6Copy the webhook URL and paste it in Slack's Event Subscriptions

Features

AI Auto-Response

Automatic AI-powered responses in Slack channels and DMs

Thread Replies

Responses are sent in threads to keep conversations organized

Channel Mentions

Respond to @mentions of your bot in any channel

Direct Messages

Handle private conversations in DMs with your bot

Human Takeover

Agents can take over conversations from the dashboard

Unified Inbox

View and manage Slack conversations in your dashboard

Troubleshooting

Bot not responding to messages

  • •Verify the bot has been added to the channel
  • •Check that Event Subscriptions are enabled and verified
  • •Ensure message.channels and message.im events are subscribed
  • •Confirm the bot token has chat:write permission

Events not being received

  • •Verify your webhook URL is accessible from the internet
  • •Check that Request URL verification succeeded
  • •Ensure your server is running and responding to requests
  • •Check server logs for incoming webhook requests

Invalid signature error

  • •Verify the Signing Secret is correct
  • •Ensure the raw request body is being used for verification
  • •Check that the request timestamp is within 5 minutes

Bot responds multiple times

  • •Check for duplicate event subscriptions
  • •Ensure message subtypes are being filtered
  • •Verify the bot is not responding to its own messages

On this page

Related Guides

WhatsApp Integration
Website Widget

Need Help?

Our support team is here to help you set up your Slack integration.

Contact Support