Skip to content

Slack

Authentication

  1. Use https://<your_domain>/auth/callback as ENV AUTH_REDIRECT_URL↰
  2. Go to Slack Apps, select IMPulse app
  3. In the Basic Information section:
    • use "Client ID" as ENV AUTH_CLIENT_ID↰
    • use "Client Secret" as ENV AUTH_CLIENT_SECRET↰
  4. In the OAuth & Permissions section:
    • in Redirect URLs subsection add URI from AUTH_REDIRECT_URL ↰ env
    • press Save URLs button

Create a bot

  1. Go to Slack Apps and click button Create New App.
  2. Select From scratch.
  3. Set the App Name to "IMPulse" and choose your workspace.

Configure the bot

  1. In the Interactivity & Shortcuts section:

  2. In the OAuth & Permissions section:

    • in Scopes subsection add these "Bot Token Scopes":
      • channels:read
      • chat:write
      • chat:write.customize
      • chat:write.public
      • groups:read
      • im:read
      • im:write
      • mpim:read
      • usergroups:read
      • users:read
    • we highly recommend to add the IP address of your IMPulse server in white list in Restrict API Token Usage subsection
    • in OAuth Tokens click the button Install to <your_workspace>, then Allow
    • use "Bot User OAuth Token" as ENV SLACK_BOT_USER_OAUTH_TOKEN↰ (used here)
  3. In Basic Information section:
    • in the App Credentials subsection:
      • use "Verification Token" as ENV SLACK_VERIFICATION_TOKEN↰ (used here)
    • in Display Information subsection:

Configure channels

  1. To use the IMPulse bot in private channels, you must manually invite it. Run this command in each required private channel:

    /invite @IMPulse

  2. All users from messenger.admin_users↰ must be present in every channel listed in the route↰ block.

  3. Add users from messenger.chains↰ to their respective channels.

  4. We recommend configuring IMPulse channels for all messenger.users↰ as follows:

    • right-click on the channel
    • select "Change notifications"
    • choose "Mentions" and check the option "Also include @channel and @here"
    • Click Save Changes.

Get group ID

To copy group ID:

  • In any thread mention group using @
  • Click it to open
  • Press "..." (More actions) button
  • Copy group ID button