instant-poll

instant-poll is a Discord application that allows you to create polls with live feedback in text channels.

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
• Gateway-free (you don't need to invite the bot to use it)

Add it to your server

Add the official bot

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

Use /poll create to create a poll.

Parameter	Description	Constraints
question	The poll question	< 500 characters in length
1..5	The options voters can pick from	Format: (<key>: )?<text> (key: 1-15 characters, text: 1-200 characters)
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

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

Hosting

You can host this application yourself using Docker. Further prerequisites:

• A Discord application with a bot user (https://discord.com/developers/applications)
• Domain with an SSL certificate
• Reverse proxy such as nginx.

Setup

Installation

Make a directory for the app, cd into it and run

wget https://raw.githubusercontent.com/JohnnyJayJay/instant-poll/main/config/config.edn.template -O config/config.edn
wget https://raw.githubusercontent.com/JohnnyJayJay/instant-poll/main/docker-compose.yml

Edit config/config.edn to include the public key and token of your Discord app. You can find both of these on your applications page.

Proxy Setup

The application will run a web server that accepts Discord requests at any URI. You should set up your reverse proxy to forward requests to your domain (or a specific URI, if you want) to the Docker container.

The port to forward to on your local host is chosen by Docker by default, so you'll have to set that after you started the container (see docker ps). Alternatively, you can set a fixed port by changing this: - "8090" to -"<your-port>:8090" in docker.compose.yml, where <your-port> is the port that you want your reverse proxy to forward to.

Slash Commands Registration

Run

wget https://github.com/JohnnyJayJay/instant-poll/blob/main/command.json
token="your-bot-token"
appid="your-bot-id"
curl -d "@command.json" \ 
     -H "Content-Type: application/json" \
     -H "Authorization: Bot $token" \ 
     https://discord.com/api/v9/applications/$appid/commands

If you get a success response, you've registered the command(s) in your app.

Run

To start the app, run docker-compose up or docker-compose up -d to start in detached mode.

If it's your first run, you need to tell Discord where to send interactions now. Again, you can to that on the developer portal in your application's page. Set "Interactions Endpoint URL" to whereever your server accepts requests and save your changes.

Depending on when you registered the slash commands, you may have to wait up to an hour before you can use the commands in your servers. Once they're available, check /poll info to see if it works.

License

Copyright © 2021 JohnnyJayJay

Licensed under the MIT License.