Slack
Connect Slack to send messages as yourself, read channel history, and search conversations.Capabilities
- Send DMs - Message any user in your workspace
- Post to channels - Send messages to channels you’re in
- Read history - View recent messages in conversations
- Search users - Find users by name or email
Setup
Prerequisites
You need to create a Slack app with user OAuth tokens. This lets Wovly act as you (not a bot).Step 1: Create Slack App
- Go to api.slack.com/apps
- Click Create New App
- Select From scratch
- Name it “Wovly” and select your workspace
Step 2: Configure OAuth Scopes
- Go to OAuth & Permissions in your app settings
- Under User Token Scopes, add:
channels:history- Read channel messageschannels:read- List channelschat:write- Send messagesim:history- Read DM historyim:read- List DMsim:write- Open DM channelsusers:read- List usersusers:read.email- Find users by email
Step 3: Set Redirect URL
- Under OAuth & Permissions, find Redirect URLs
- Add:
http://localhost:18924/oauth/callback - Save
Step 4: Get Credentials
- Go to Basic Information
- Copy the Client ID and Client Secret
Step 5: Connect in Wovly
- Go to Integrations in Wovly
- Click Setup on Slack
- Paste your Client ID and Client Secret
- Click Connect
- Authorize in Slack
Usage
How It Works
Wovly uses user tokens (not bot tokens), which means:- Messages appear as sent by you, not a bot
- You can access your DMs and private channels
- Actions are indistinguishable from you using Slack directly
Permissions Explained
| Permission | Why Needed |
|---|---|
channels:history | Read public channel messages |
chat:write | Send messages |
im:history | Read DM conversations |
users:read | Find users to message |
Troubleshooting
Can't post to channel
Can't post to channel
You must be a member of the channel. Wovly can only post to channels you’ve joined.
User not found
User not found
Check the user’s display name or try their email address. Wovly searches both.
OAuth redirect error
OAuth redirect error
Ensure
http://localhost:18924/oauth/callback is in your Slack app’s redirect URLs.Revoking Access
- In Wovly: Click Disconnect on Slack
- In Slack: Go to Slack App Management and remove the app