{"id":15714299,"url":"https://github.com/slack-samples/javascript-account-binding","last_synced_at":"2025-10-03T15:14:16.775Z","repository":{"id":47187452,"uuid":"94140706","full_name":"slackapi/template-account-binding","owner":"slackapi","description":"A sample Slack app that shows you how to bind a Slack user to a user on another system","archived":false,"fork":false,"pushed_at":"2023-04-18T16:19:40.000Z","size":92,"stargazers_count":22,"open_issues_count":6,"forks_count":8,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-10-04T21:35:46.516Z","etag":null,"topics":["slack-blueprint"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/slackapi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-06-12T21:10:02.000Z","updated_at":"2024-07-04T14:37:44.000Z","dependencies_parsed_at":"2023-01-23T14:25:15.498Z","dependency_job_id":null,"html_url":"https://github.com/slackapi/template-account-binding","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slackapi%2Ftemplate-account-binding","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slackapi%2Ftemplate-account-binding/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slackapi%2Ftemplate-account-binding/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/slackapi%2Ftemplate-account-binding/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/slackapi","download_url":"https://codeload.github.com/slackapi/template-account-binding/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219869309,"owners_count":16555579,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["slack-blueprint"],"created_at":"2024-10-03T21:35:52.649Z","updated_at":"2025-10-03T15:14:16.705Z","avatar_url":"https://github.com/slackapi.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Account Binding Template\n\nA Sample Slack app that shows how a user account on Slack can be bound to an account on another system.\n\n![account-binding](https://user-images.githubusercontent.com/700173/27056630-b57cd40c-4f7d-11e7-98f1-7e723f472192.gif)\n\n## Setup\n\n#### Create a Slack app\n\n1. Create an app at api.slack.com/apps\n1. Click on `Bot Users`\n1. Add a bot user and make sure it displays as always online\n1. Install the app and copy the `xoxb-` token\n\n#### Run locally or [![Remix on Glitch](https://cdn.glitch.com/2703baf2-b643-4da7-ab91-7ee2a2d00b5b%2Fremix-button.svg)](https://glitch.com/edit/#!/remix/slack-account-binding-blueprint)\n1. Get the code\n    * Either clone this repo and run `npm install`\n    * Or visit https://glitch.com/edit/#!/remix/slack-account-binding-blueprint\n1. Set the following environment variables to `.env` (see `.env.sample`):\n    * `SLACK_BOT_TOKEN`: Your app's `xoxb-` token (available on the Install App page)\n    * `SLACK_VERIFICATION_TOKEN`: Your app's Verification Token (available on the Basic Information page)\n    * `SESSION_SECRET`: A randomly generated secret for your session storage\n1. If you're running the app locally:\n    1. Start the app (`npm start`)\n    1. In another windown, start ngrok on the same port as your webserver (`ngrok http $PORT`)\n\n#### Add Slash Commands\n1. Go back to the app settings and click on Slash Commands\n1. Add the following Slash Commands:\n    * Command: /read-message\n        * Request URL: ngrok or Glitch URL + api/slack/command\n        * Description: Read secret message\n    * Command: /write-message\n        * Request URL: ngrok or Glitch URL + api/slack/command\n        * Description: Write secret message\n        * Usage Hint: [message]\n1. Reinstall the app by navigating to the Install App page\n\n#### In Slack\n\n1. In any channel, run /read-message\n1. You should see a DM from the bot asking you to link your accounts\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslack-samples%2Fjavascript-account-binding","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fslack-samples%2Fjavascript-account-binding","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fslack-samples%2Fjavascript-account-binding/lists"}