**Important Disclaimer**: This bot is not a traditional bot! It does not actually join your server or appear online, but you can still use it through slash commands! 

# Instant Poll

Instant Poll is a simple, free and open source bot that allows you to create polls with live feedback in text channels. 

![Fancy GIF](https://github.com/JohnnyJayJay/instant-poll/blob/main/poll-demo.gif?raw=true)

## Features
- No setup required, just plug and play
- Real-time updating poll results
- Cutting-edge Discord features (slash commands, message buttons)
- Timed Polls
- Polls with multiple votes per user
- Dynamic Polls (adding options as you go)
- Open (non-anonymous) polls
- Restricted polls (only certain roles can participate)
- Gateway-free (you don't need to invite the bot to use it)

## Add it to your server

[**Add the official bot**](https://discord.com/oauth2/authorize?client_id=489108697864470531&scope=applications.commands)

You will notice that, when you've authorised the app, it **will not join your server**. This is **intended**, **you can use the commands anyway**.
You can verify this by typing `/poll info`.

## Usage
`/poll help` - Receive help
`/poll info` - Display bot info

Use `/poll create` to create a poll. 

| Parameter              | Description                                                                 | Constraints                               |
|------------------------|-----------------------------------------------------------------------------|-------------------------------------------|
| `question`             | The poll question                                                           | /                                         |
| `1`..`15`              | The options voters can pick from                                            | Format: `<emoji>? <key>? ; <description>` |
| `voter-role`           | A role people must have in order to participate                             | Any existing role                         |
| `allow-change-options` | Whether it should be possible to add more options after creation            | True or False                             |
| `show-votes`           | Whether it will be visible who voted for which option(s)                    | always, never or after closing            |
| `multi-vote`           | Whether every voter can pick multiple options                               | True or False                             |
| `close-in`             | Number of seconds after which poll is closed                                | positive number, <= 0 will be ignored     |
| `default-keys`         | Whether to use option keys A-O automatically. May improve mobile formatting | True or False                             |


Polls can be closed by the poll creator and people who are allowed to delete messages.

## How does this work?
The bot makes heavy use of new Discord features, including **webhook-based interactions**. Using those, bots don't have to be on the server anymore in order to receive events like commands and button presses. The new button interactions also allow bots to edit messages on each button press, without any rate limit. With traditional poll bots, this concept would blow up!

Check out the [source code](https://github.com/JohnnyJayJay/instant-poll) on GitHub for more insights.

Do you want to chat with me about feature requests, bug reports or general questions? My DMs are open, so you can do that by [joining a server I'm also on](https://discord.gg/npEXyQt). I do not accept friend requests at this time. 


Instant Poll

Instantly create polls with message buttons and real-time result displays - setup-free

为Instant Poll投票

你想要支持我们吗？