https://github.com/m-vdb/slack-randompicker

Pick a random person from a group or channel in Slack
https://github.com/m-vdb/slack-randompicker

Last synced: 2 months ago
JSON representation

Pick a random person from a group or channel in Slack

• Host: GitHub
• URL: https://github.com/m-vdb/slack-randompicker
• Owner: m-vdb
• License: gpl-3.0
• Created: 2020-04-26T06:00:44.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2020-08-24T13:37:06.000Z (over 4 years ago)
• Last Synced: 2024-10-03T10:24:37.264Z (3 months ago)
• Language: Python
• Size: 534 KB
• Stars: 12
• Watchers: 2
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
![Continuous Integration](https://github.com/m-vdb/slack-randompicker/workflows/Continuous%20Integration/badge.svg)

[![Coverage Status](https://coveralls.io/repos/github/m-vdb/slack-randompicker/badge.svg?branch=master)](https://coveralls.io/github/m-vdb/slack-randompicker?branch=master)

# 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](./docs/1_help.png)

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



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



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



## Server installation

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

```bash

$ 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`.