Poker Planner for Slack

What is this?

Poker Planner is a free and open-source project lets you make estimations with planning poker technique (or scrum poker) directly in Slack, without any need of external software. It can be a useful tool for agile remote teams. You can read more about planning poker on wiki. This service is free in goodwill, and hopefully will remain free. You can install the app with "Add to Slack" button above. If you want to host your own app, please check the setup guide on Github.

Features

Customizable poker points
Persistent settings for each channel/conversation: the app will remember the last settings you use on that channel, including participants and poker points.
Auto-reveal after voting ends (min 1 minute, max 7 days)
Protected sessions: prevent others to reveal/cancel the sessions you've created.
Average point: calculate average point to aid decision making process.

Usage

After successful installation, /pp slash command will be available in your team workspace. It works in:

Public channels
Private channels
Group direct messages

Poker Planner app must be added to channel/conversation before usage. You can add it from channel/conversation details menu, or just simply mention the app, like @poker_planner.

`/pp some session title`

This command starts a poker planning session with specified title, or simply anything you typed after /pp.

WARNING: Topic text cannot start with "config" and "help" (case-sensitive). They have another functionalities which is described below.

`/pp config`

This command is deprecated and will be removed in future releases.

`/pp help`

This commands prints a cheatsheet of usage.

Required Slack Permissions

commands - Add actions and/or slash commands that people can use
- We will add /pp slash command
chat:write - Send messages as Poker Planner

FAQ

I enter /pp command, but nothing happens?
In order to open a modal, Slack waits an API call for 3 seconds. After that, Slack does not allow us to open a modal. However, due to operational latencies which can be caused by either Slack's or our infrastructure, it's normal to get this error. Please try again.

Privacy

Apart from that, I get lots of question about privacy, so I want to clarify what the app can and cannot do:

The app does not know anything about your channels/conversations until you explicitly add the bot user to it.
Even if the bot is added to a channel, the only data that Slack sends to the app is channel id and channel name. Getting additional information (topic, member list, etc.) requires another permission that the app doesn't have.
The app cannot read any of your messages, even if the bot is added to that channel/conversation! The only thing the app can read is the poker planning session title you enter while using the app.
The app cannot list the users in your team workspace. When a user interacted with the app (create a new session, use a vote, etc.), Slack sends just user id and user name, nothing more.

Support

Since this project is open source, Github Issues is the preferred support channel. However you can directly e-mail me too.