Skip to main content
Slack can be both a Roomote sign-in provider and a communications provider. You may use one Slack app for both jobs.

​
What you need

  • a Slack workspace where you can create and install apps
  • a stable public Roomote URL
  • access to Roomote setup or deployment environment variables
Use <public-url> below for the exact public URL printed by local development or configured for your self-hosted deployment.

​
Fast path

In /setup, choose Create Slack app from manifest. Roomote opens Slack’s create-app flow with redirect URLs, webhook URLs, interactivity, scopes, and events prefilled for the current public URL. After Slack creates the app:
  1. copy Client ID, Client Secret, and Signing Secret from Basic Information > App Credentials
  2. paste them into Roomote setup, or save them as deployment env vars
  3. finish the Slack install step so Roomote can receive events and post replies
SLACK_CLIENT_ID=...
SLACK_CLIENT_SECRET=...
SLACK_SIGNING_SECRET=...
SLACK_APP_ID is optional for manual preconfiguration. Roomote saves Slack’s app_id from the OAuth installation response after workspace install.

​
Redirect URLs

Slack sign-in uses Slack OpenID Connect. Add the sign-in redirect URL: 
<public-url>/api/auth/oauth2/callback/slack
If the same app handles the Slack communications integration, add the integration redirect URL too: 
<public-url>/api/slack/callback
When you use separate Slack apps for sign-in and communications, use these auth-only compatibility variables for the sign-in app: 
ROOMOTE_AUTH_SLACK_CLIENT_ID=...
ROOMOTE_AUTH_SLACK_CLIENT_SECRET=...

​
Bot scopes

Add these bot token scopes under OAuth & Permissions > Scopes > Bot Token Scopes: 
app_mentions:read
channels:read
channels:history
chat:write
files:read
groups:read
groups:history
im:read
im:history
im:write
links:read
links:write
mpim:read
mpim:history
reactions:read
reactions:write
team:read
users:read
After adding or changing scopes, reinstall the app from OAuth & Permissions > Install to Workspace. Slack does not apply new scopes to an existing installation until you reinstall.

​
Events and interactivity

Turn on Event Subscriptions and set Request URL to: 
<public-url>/api/webhooks/slack
Subscribe to these bot events: 
app_mention
message.im
message.channels
message.groups
message.mpim
reaction_added
member_joined_channel
link_shared
entity_details_requested
function_executed
Turn on Interactivity & Shortcuts and use the same request URL: 
<public-url>/api/webhooks/slack
Roomote uses this endpoint for button clicks and other interactive Slack payloads.

​
App home and messages

If you want to start tasks by direct message, make sure the app can receive DMs. Enable the app surfaces needed for messages to the bot, then keep the message.im event subscription enabled.

​
Local URL changes

Keep the public URL stable. When it changes, update the Slack app’s redirect URLs, Event Subscriptions request URL, and Interactivity request URL, then restart Roomote with the matching URL.

​
Verify setup

  1. sign in with Slack, if Slack sign-in is enabled
  2. install the Slack app to the workspace
  3. mention the app in a channel or send it a direct message
  4. confirm Roomote starts a task and replies with a task link
  5. reply in the same thread and confirm the message continues the same task