Skip to content
A sample Slack app that shows you how to bind a Slack user to a user on another system
Branch: master
Clone or download
Latest commit 3b65384 Aug 21, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
config
data initial commit Jun 12, 2017
lib
public initial commit Jun 12, 2017
routers move secrets to .env Jun 15, 2017
views
.env.sample
.eslintrc.js
.gitignore initial commit Jun 12, 2017
.nvmrc
LICENSE Create LICENSE Aug 21, 2017
README.md
index.js move secrets to .env Jun 15, 2017
package-lock.json move secrets to .env Jun 15, 2017
package.json

README.md

Account Binding Template

A Sample Slack app that shows how a user account on Slack can be bound to an account on another system.

account-binding

Setup

Create a Slack app

  1. Create an app at api.slack.com/apps
  2. Click on Bot Users
  3. Add a bot user and make sure it displays as always online
  4. Install the app and copy the xoxb- token

Run locally or Remix on Glitch

  1. Get the code
  2. Set the following environment variables to .env (see .env.sample):
    • SLACK_BOT_TOKEN: Your app's xoxb- token (available on the Install App page)
    • SLACK_VERIFICATION_TOKEN: Your app's Verification Token (available on the Basic Information page)
    • SESSION_SECRET: A randomly generated secret for your session storage
  3. If you're running the app locally:
    1. Start the app (npm start)
    2. In another windown, start ngrok on the same port as your webserver (ngrok http $PORT)

Add Slash Commands

  1. Go back to the app settings and click on Slash Commands
  2. Add the following Slash Commands:
    • Command: /read-message
      • Request URL: ngrok or Glitch URL + api/slack/command
      • Description: Read secret message
    • Command: /write-message
      • Request URL: ngrok or Glitch URL + api/slack/command
      • Description: Write secret message
      • Usage Hint: [message]
  3. Reinstall the app by navigating to the Install App page

In Slack

  1. In any channel, run /read-message
  2. You should see a DM from the bot asking you to link your accounts
You can’t perform that action at this time.