Skip to main content
Deploy your agent to Slack for team collaboration.

​
Setup

1

Create Slack App

  1. Go to https://api.slack.com/apps
  2. Click Create New App
  3. Choose From scratch
  4. Name: agent name
  5. Workspace: your Slack workspace
2

Configure Permissions

  1. Go to OAuth & Permissions
  2. Add Bot Token Scopes:
    • chat:write
    • channels:read
    • groups:read
    • im:read
  3. Install app to workspace
  4. Copy Bot Token (Xoxb-…)
3

Add Channel to Agent

  1. Agents > Select agent
  2. Settings > Channels
  3. Click Add Channel
  4. Choose Slack
  5. Paste bot token
4

Test

  1. Add bot to Slack channel or DM
  2. Send message to bot
  3. Verify response
5

Deploy

Toggle Enabled. Bot active in workspace.

​
Features

  • Direct messages - One-on-one with users
  • Channel messages - Bot in public/private channels
  • Threads - Keep conversations organized
  • Mentions - Respond when @mentioned
  • File sharing - Send documents and images
  • 4,000 char limit - Auto-splits long messages

​
Channel Types

​
Direct Message

Message bot directly. Fastest response time.

​
Public Channel

Add bot to channel. Bot responds to all messages or when mentioned.

​
Private Channel

Add bot to private channel. Only members can interact.

​
Message Threading

Responses automatically create threads: 
User: "What's the weather?"
Bot: "In San Francisco: 72F, sunny"
  ↳ Response in thread (keeps channel clean)

​
Rate Limits

Slack workspace rate limits:
  • Standard: ~1 message/second
  • Enterprise: Higher limits
  • Burst: ~10 requests allowed
Noorle queues excess requests automatically.

​
Slash Commands

Create custom Slack commands (optional): 
/agent status
/agent help
/agent analyze {file}
Configure in app settings.

​
OAuth Scopes

Required scopes:
  • chat:write - Send messages
  • channels:read - See channel list
  • groups:read - See private channels
  • im:read - See direct messages
  • users:read - Get user info (optional)
Request only what you need.

​
User Identification

Slack identifies users by: Agent can personalize based on user info.

​
Limitations

  • 4,000 character limit
  • Can’t edit messages (after sent)
  • No reactions
  • Thread replies only

​
Troubleshooting

​
Bot not responding

  • Check bot token
  • Verify app is installed
  • Check bot has permissions
  • Test in Console first

​
Bot not in channel

  • Add bot manually to channel
  • Check app permissions
  • Verify scopes authorized

​
Slow responses

  • Slack delay (rare)
  • Agent processing
  • Network latency
  • Check usage dashboard

​
Privacy

  • Messages encrypted (Slack -> Noorle -> Slack)
  • User data not stored
  • Config as Workspace App (not public)
  • Can configure privacy levels

​
Cost

For current pricing details, see Pricing.

​
Next Steps