Connect Slack to your agents for reading and sending messages, listing channels, and accessing user information.

Slack Integration

Slack provides access to workspace communication: channels, direct messages, and user information. Your agents can read message history, post messages, and browse channel lists.

OAuth Setup

When you click Connect Slack on the dashboard, Supyagent requests the following scopes:

Scope	Access
`channels:read`	View channel list and information
`channels:history`	Read message history in public channels
`chat:write`	Send messages to channels and users
`users:read`	View user profiles and presence
`im:read`	View direct message channel list
`im:history`	Read direct message history
`im:write`	Send direct messages

Permissions

Permission ID	Name	Type	Description
`slack.messages.read`	Read messages	read	View messages in channels and direct messages
`slack.messages.write`	Send messages	write	Send messages to channels and users
`slack.channels.read`	Read channels	read	View channel list and information
`slack.users.read`	Read users	read	View user profiles and presence

Messages

Example Actions

List messages from a channel:

curl -X GET "https://app.supyagent.com/api/v1/slack/messages?channel=general&limit=20" \
  -H "Authorization: Bearer sk_live_..."

Send a message:

curl -X POST "https://app.supyagent.com/api/v1/slack/messages" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "engineering",
    "text": "Deploy completed successfully. All health checks passing."
  }'

Reply in a thread:

curl -X POST "https://app.supyagent.com/api/v1/slack/messages" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "engineering",
    "text": "Build logs attached.",
    "thread_ts": "1678901234.567890"
  }'

What Agents Can Do

Read recent messages from any channel or DM the bot has access to
Post messages to channels
Reply to specific threads using thread_ts
Send direct messages to users

Channels

Example Actions

List channels:

curl -X GET "https://app.supyagent.com/api/v1/slack/channels" \
  -H "Authorization: Bearer sk_live_..."

What Agents Can Do

List public and private channels the bot has access to
Get channel details (topic, purpose, member count)

Users

Example Actions

List workspace users:

curl -X GET "https://app.supyagent.com/api/v1/slack/users" \
  -H "Authorization: Bearer sk_live_..."

What Agents Can Do

List workspace members
Get user profiles (name, email, title, status)
Check user presence (online/away)

Notes

Slack uses bot tokens, so the bot must be invited to a channel before it can read or post messages
Thread replies use the thread_ts field from the parent message
Channel names in the API do not include the # prefix
Rate limits apply: Slack allows approximately 1 request per second per method

Slack

On this page