Skip to content

Latest commit

 

History

History
43 lines (34 loc) · 1.87 KB

README.md

File metadata and controls

43 lines (34 loc) · 1.87 KB

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