View as markdown

Slack for Hub

Hub receives Slack mentions over the Events API. Socket Mode is not used, so your Hub must be reachable from Slack.

Create the app

Go to api.slack.com/appsCreate New App → From a manifest, and paste this after replacing hub.example.com with your PASEO_HUB_APP_URL:

display_information:
  name: Paseo
features:
  bot_user:
    display_name: Paseo
    always_online: false
oauth_config:
  redirect_urls:
    - https://hub.example.com/api/integrations/slack/callback
  scopes:
    bot:
      - app_mentions:read
      - chat:write
      - reactions:write
settings:
  event_subscriptions:
    request_url: https://hub.example.com/api/integrations/slack/events
    bot_events:
      - app_mention
  interactivity:
    is_enabled: false
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false

Configure Hub

From Basic Information → App Credentials, copy:

ValueEnvironment variable
App IDSLACK_APP_ID
Client IDSLACK_CLIENT_ID
Client SecretSLACK_CLIENT_SECRET
Signing SecretSLACK_SIGNING_SECRET

Restart Hub before Slack verifies the request URL. Hub needs the signing secret to answer the verification challenge.

Connect

Open Connections → Slack → Connect, pick the workspace, and allow it.

Use Hub's button, not Slack's Install to Workspace. The install has to start from Hub so the workspace binds to your organization.

Then invite the bot to each channel it should watch:

/invite @Paseo

Now write a trigger: Slack triggers.