Skip to content

m-vdb/slack-randompicker

Repository files navigation

Continuous Integration Coverage Status

slack-randompicker

Pick a random person from a group or channel in Slack

Usage

To show the help, you can type /pickrandom help in Slack:

Help

Here is the output of an instantaneous random pick, using /pickrandom #general to play music:

Instantaneous random pick

And an example of a periodic random pick, using /pickrandom #general to prepare slides every Monday at 10am:

Periodic random pick

To dispay all the current scheduled random picks, you can do /pickrandom list:

List of random picks

Server installation

After creatinga Slack bot, you can install slack-randompicker using docker on your own server:

$ export DATABASE_URL=...
$ export SLACK_TOKEN=...
$ export SLACK_SIGNING_SECRET=...
$ docker run -e DATABASE_URL -e SLACK_TOKEN -e SLACK_SIGNING_SECRET mvdb/slack-randompicker:0.6.0

Slack app setup

Assuming your Slackbot is installed at https://host.com, to setup the bot for your own workspace, you will need the following:

  • Interactivity: set the request URL to https://host.com/actions
  • Slash commands: create a new slash command named /pickrandom and set the request URL to https://host.com/slashcommand
  • Bot Token Scopes: set up the scopes channels:read, chat:write, chat:write.public, commands, groups:read, usergroups:read and users:read.

About

Pick a random person from a group or channel in Slack

Resources

License

Stars

Watchers

Forks

Packages

No packages published