Skip to content

Slack

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:

    • enable "Interactivity"
    • set the Request URL to https://<your_domain>/app

  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
      • 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 (use in 3 here)
  3. In Basic Information section:
    • in the App Credentials subsection:
      • use "Verification Token" as ENV SLACK_VERIFICATION_TOKEN (use in 3 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.

    For simplicity, you can add all users from messenger.users to all channels listed in the route block.

  4. We highly recommend setting notification preferences to "Just @mentions" for each user in their route channels. Each user should:

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