Slack Integration - Overcentric · Overcentric

Follow these steps to integrate Slack with your Overcentric project and receive notifications for new chat messages. All messages will be threaded by conversation in your Slack channel.

1. Create a Slack App

  1. Go to api.slack.com/apps

  2. Click "Create New App" → "From scratch"

  3. Enter app name (e.g., "Overcentric Chat") and select your workspace

  4. Click "Create App"

2. Add Bot Permissions

  1. In the left sidebar, go to "OAuth & Permissions"

  2. Scroll to "Bot Token Scopes" and click "Add an OAuth Scope"

  3. Add: chat:write

3. Install to Workspace

  1. Scroll up to "OAuth Tokens"

  2. Click "Install to Workspace" → "Allow"

  3. Copy the Bot User OAuth Token (starts with xoxb-)

4. Invite Bot to Channel

  1. In Slack, go to the channel where you want notifications

  2. Type: /invite @YourAppName

5. Get Channel ID

  1. Right-click the channel name → "View channel details"

  2. Scroll to the bottom and copy the Channel ID (starts with C)

6. Configure in Overcentric

  1. Go to Project Settings → Slack section

  2. Paste the Bot Token in the "Bot Token" field

  3. Paste the Channel ID in the "Channel ID" field

  4. Save the project settings

That's it!

New chat messages will now appear in your Slack channel as threaded conversations. The first message creates a new notification, and all subsequent messages (from both users and agents) are added as replies in the thread.

Troubleshooting

Error: channel_not_found

  • Make sure you've invited the bot to the channel: /invite @YourAppName

  • Verify the Channel ID format (should start with C, not #)

Error: not_authed or invalid_auth

  • Check that the Bot Token is correct and starts with xoxb-

  • Ensure the app has chat:write scope

  • Try reinstalling the app to your workspace if you changed permissions