Watch the demo
Prerequisites
- A Slack workspace where you have permission to install apps
- Admin or owner permissions (or approval from an admin)
- An active organization in LithoBlocks
Connect your workspace
Step 1: Initiate connection
- Navigate to Integrations in the sidebar
- Find the Slack section
- Click Connect Slack Workspace
Step 2: Authorize
- Select your workspace from the dropdown (if you’re in multiple workspaces)
- Review the requested permissions
- Click Allow to grant access
Step 3: Confirm
After authorization you’ll be redirected back; your Slack connection will appear in Integrations with a success message.Required permissions
The platform requests these Slack bot permissions:| Permission | Purpose |
|---|---|
chat:write | Send messages to channels and users |
users:read | Look up users by email for direct messages |
users:read.email | Resolve email addresses to Slack user IDs |
channels:read | List and validate channel access |
groups:read | Access private channel information |
im:write | Send direct messages to users |
Some workspaces require admin approval for app installations. If you see “Request to Install,” workspace admins must approve before you can complete the connection.
Add the bot to channels
The bot must be in a channel to send messages there. Public channels: In Slack, open the channel and run/invite @lithoblocks.
Private channels: The channel creator must invite the bot with /invite @lithoblocks.
Direct messages: No setup needed; the bot can send DMs to any workspace member.
Test your connection
- Go to Templates
- Select or create a template
- Click Send to Slack
- Choose a test channel or send to yourself
- Verify the message appears in Slack
Managing your connection
View connection details
In Integrations you can see workspace name, who connected it, when it was established, and status (Active or Inactive).Disconnect
- Go to Integrations
- Find your Slack connection
- Click Disconnect
- Confirm
Troubleshooting
Connection failed or OAuth returns error
Connection failed or OAuth returns error
Allow popups from the platform domain; try a different browser or network. Check with your workspace admin if restrictions apply.
Messages not sending
Messages not sending
Check connection status in Integrations, ensure the bot is in the target channel, and for DMs confirm the user is in the workspace. View detailed errors on the Usage page.
Buttons don't respond when clicked
Buttons don't respond when clicked