A bot to manage emails that ask frequenty asked questions.
Super simple interface to reply to an email with a canned response. Simply reply to faqbot with @faqbot <template_name> and faqbot will respond to the original email with the response.
Easy API to add new email bot features. Simply hook into a email_callback and use the API to do tasks and reply to emails that suit your needs.
With a lot of faqbot usage from your organization, you can train a model such that faqbot can figure out how to reply on its own.
If you run a hackathon and use HackMIT's quill registration system, faqbot comes pre-baked with quill integration. Whitelist email addresses right from your inbox.
Use Python 2.7,
Resolve dependencies,
pip install -r requirements.txtYou need to place the config.py file inside the faqbot directory. We have provided an example config in the faqbot directory, config.example.py.
To run for local debugging,
python app.pyTo run on production,
python run.pyHead over to the url where you've deployed faqbot to view the control panel. There you can enable / disable features, tweak settings and add new templates.
Reply all to the email thread without the person who sent the email. Or reply-one to admin@hackmit.org (or your configured mail-box) with the body text:
@faqbot latereg
This will reply to the person a generic response to "I didn't register for you hackathon before the deadline."
You can also use the @fb trigger for shorthand.
faqbot has a quill integration module (HackMIT's registration system). This is used to whitelist emails in our system.
@faqbot whitelist <email>
This will whitelist the given email in quill and reply to the person.
faqbot can learn emails to template mapping and will attempt to automatically reply to an email if it's confident enough.
To use Smart Reply on your own emails, collect training data,
python tasks.py --collect
and then train the model on the collected dataset,
python tasks.py --train
faqbot's codebase is designed to be hackable. The main directory to add a new feature is the faqbot/features/ directory. Here you can register for email callbacks and use the faqbot API to send reply-all or reply-one messages based on the email you just received.
Adding new features is extensively documented in the features module. You can also take a look at the quill feature as an example feature to go off of.
The tests right now are hidden, because they are based on emails we've received in the past and hence reveal private information. However, we do plan on anonymize them and checking them in. The tests are run as follows:
python -m unittest tests.test_parsing
Try to use black and follow that style for everything outside of legacy/. Contribute by opening pull requests and report bugs by creating issues. Email parsing in general is nasty, so opening bugs for parsing errors will be really helpful.
Copyright (c) 2018-2019 Shreyas Kapur. Released under AGPLv3. See LICENSE.md for details.