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.
- 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.
- Protected sessions: prevent others to reveal/cancel the sessions you've created.
- Average point: calculate average point to aid decision making process .
- The sessions are kept in database for 7 days, after that it's completely gone.
After successful installation,
slash command will be available in your team workspace. It works in:
Poker Planner app must be added to channel/conversation before usage.
- Public channels
- Private channels
- Group direct messages
You can add it from channel/conversation details menu, or just simply mention the app,
/pp some session title
This command starts a poker planning session with specified title,
or simply anything you typed after
Topic text cannot start with "config
" (case-sensitive). They have another functionalities
which is described below.
This command is deprecated and will be removed in future releases.
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
When I try to vote, I get
All the not-finished sessions are kept in a database for 7 days.
After that they're completely deleted.
/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.
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.
Since this project is open source,
is the preferred support channel. However you can directly
e-mail me too.