FormBot

A discord bot for handling responses to generic online forms, through private messages.

This bot was made specially for HackTheMidlands 4.0, but is designed to be used for any form.

Usage

Type !mentor anywhere in your server and it will trigger the bot to privately message you the questions on the form.

This bot is designed for a mentoring system, but can be altered to work for different kinds of forms quite easily.

It works with the following fields (however, everything should work):

• all plaintext fields
• checkbox
• radio

Things to note

• You can change the command from !mentor.
  • This can be done by renaming the method async def mentor(ctx):
• You can change the final message when all the questions have been asked.

Development

Setup a virtual environment

$ python3 -m venv .venv
$ source .venv/bin/activate

Install required packages

$ pip3 install -r requirements.txt

Configuation

You will need a token for discord. Follow this guide to get one.

Add the token, and URL for the form you want to use to config.yaml.

url:

discord:
  token:
  start_message: "Hello there! I'm here to help"
  end_message: "Someone will be over to help you shortly!"
  embed_title: "Respond with one of the options below"
  prefix: "!"

Run

$ python3 -m formbot

Contributors

• Justin Chadwell: Form scraping, validation and submission
• Will Russell: Discord bot used for asking questions and response handling