Modmail is similar to Reddit's Modmail both in functionality and purpose. It serves as a shared inbox for server staff to communicate with their users in a seamless way.
When a member sends a direct message to the bot, a channel or "thread" is created within an isolated category for that member. This channel is where messages will be relayed and where any available staff member can respond to that user.
All threads are logged and you can view previous threads through the corresponding generated log link. Example
?close in 2 hours silently.
This list is ever growing thanks to active development and our exceptional contributors. See a full list of documented commands by using the
Installation locally for development reasons or otherwise is as follows, you will need
Clone the repo
$ git clone https://github.com/kyb3r/modmail $ cd modmail
$ pipenv install
.env and fill out the fields.
And finally, run the bot.
$ pipenv run python3 bot.py
If you don't want to go through the trouble of setting up your own bot, and want to support this project as well, we offer installation, hosting and maintainance for Modmail bots for Patrons. Join the support server for more info!
This bot can be hosted on heroku. Installation via Heroku is done in your web browser. The installation guide will guide you through the entire installation process. If you run into any problems, join the development server for help and support.
You can also set up autoupdates. To do this, install the Pull app in your fork. Then go to the Deploy tab in your Heroku account, select GitHub and connect your fork. Turn on auto-deploy for the master branch.
Sepcial thanks to our sponsors for supporting the project.
Become a sponsor.
Modmail supports the use of third party plugins to extend or add functionality to the bot. This allows the introduction of niche features as well as anything else outside of the scope of the core functionality of Modmail. A list of third party plugins can be found using the
plugins registry command. To develop your own, check out the documentation for plugins.
Contributions to Modmail are always welcome, whether it be improvements to the documentation or new functionality, please feel free make the change. Check out our contribution guidelines before you get started.
This bot is free for everyone and always will be. If you like this project and would like to show your appreciation, here's the link for our Patreon.