> NOTICE: This bot is in maintenance-mode. No new feature will be developed, but bug fixes and support is still available.


## Is this bot for me? Other questions?
Please read the [FAQ](https://github.com/qntnt/pollbot/wiki/FAQ)

## Summary
This bot supports various commands to create, participate in, and manage ranked-choice polls. Ballots are sent to users in a private DM.

## Commands

| Command | Description |
| - | - |
| `/poll create` | Create a poll |
| `/poll results` | View poll results and rankings |
| `/poll close` | Close a poll |
| `/poll audit` | (Admin-only) View detailed poll info and receive a CSV file with ballots via a DM |
| `/poll update` | Set poll properties, like the topic and closing time. You can also **reopen polls** by updating the closing time |
| `/unsafe_delete_my_user_data` | Deletes all polls and ballots for a user |
| `/help` | Displays pollbot help information

### Creating polls
Anyone can create a poll with this command.
`/poll create`

Example:
`/poll create topic:What is the best flavor of icecream? options:vanilla, chocolate, mint chip`

Pollbot will respond with a summary of the poll.

### Request a ballot

**To request a ballot, click the "Request Ballot" button at the bottom of the poll.** Pollbot will DM you a ballot with instructions.

### Submitting your votes

To submit your votes, DM Pollbot an ordered list of option keys.

Here is an example ballot DM:

**\[BOT\] pollbot**

> poll#72
> 
> Here's your ballot
> 
> To vote, order the options from best to worst in a comma-separated list e.g. `C,b,a,d`
> 
> Invalid options will be ignored
> 
> ***Privacy notice**: Your user id and current user name is linked to your ballot. Your ballot is viewable by you and bot admins.*

**What is the best flavor of icecream?**

```
a| vanilla
b| chocolate
c| mint chip
```

You would respond to this DM with a message like this if you prefer chocolate over mint chip and mint chip over vanilla:

b,c,a

### Results
Poll results are currently tabulated using [ranked-pair / Tideman](https://en.wikipedia.org/wiki/Ranked_pairs) analysis.
Anyone can view current and final results publicly with the following command.
`/poll results poll_id:<poll-id>`

Admins can audit polls and have a CSV file of ballots DMed to them using the following command.
`/pollbot audit poll_id:<poll-id>`

#### P.S.
> _**Like this bot? Consider [buying me a croissant](https://www.buymeacoffee.com/qntn) or donating below.**_ In addition to carbo-loading that'll help me cover hosting costs to keep this bot free for users

> If you'd like to delete your personal data, simply use the `/unsafe_delete_my_user_data` command.

## Privacy Policy
[quentintopper.com/pollbot/privacy](https://www.quentintopper.com/pollbot/privacy)

pollbot

A bot for ranked-choice voting. Create polls, submit votes privately, and review results using slash commands.

Bots Discord

pollbot