Slack

The Slack channel allows your assistant to receive and respond to direct messages in Slack. When configured:

• Users can DM the bot in Slack to start a conversation
• The assistant processes the message and replies in-thread
• Threaded replies are maintained automatically
• File attachments (images) are supported

Configuration

Setting Up a Slack App

1. Go to api.slack.com/apps and click Create New App then From scratch
2. Give the app a name (e.g. your assistant’s name) and select your workspace
3. Under OAuth & Permissions, scroll to Bot Token Scopes and add:
   • chat:write — Send messages
   • users:read — Look up user profiles
   • users:read.email — Read user email addresses
   • im:history — Read DM message history
4. Click Install to Workspace and authorize the app
5. Copy the Bot User OAuth Token (starts with xoxb-) from the OAuth & Permissions page
6. Under Basic Information, copy the Signing Secret
7. Under Event Subscriptions:
   • Toggle Enable Events on
   • Set the Request URL to https://yourdomain.com/webhooks/channels/slack/inbound (replace with your TeamWeb AI instance’s public URL)
   • Slack will send a verification challenge — TeamWeb AI handles this automatically
   • Under Subscribe to bot events, add message.im
   • Click Save Changes
8. Under App Home, ensure Messages Tab is enabled so users can DM the bot
9. In TeamWeb AI, go to your assistant’s Channels tab, click on Slack, paste the Bot Token and Signing Secret, and enable the channel