Another Application by IngeniousApplications

Discord Modmail

Version 1.0.0

Setup

Install python 3.6 to your local device. Please tick on add python to path when installing
Change the values in config.py
Run run_launcher.bat and follow instructions!

Setup (Heroku)

DISCLAIMER : HEROKU IS A FREE HOSTING PLATFORM AND I MADE THE BOT SUPPORT HEROKU. HOWEVER, AS THE CODE FOR HEROKU IS DIFFERENT FROM THE STANDARD CODE (ye fuck storage on heroku), UPDATES THAT GO TO THE MAIN BOT MIGHT NOT BE ROLLED OUT INSTANTLY ON THE HEROKU VERSION.

Fork this repository.
Get an account on heroku.com.
Press "Create a new app", select "Python app", give your app a name.
At deploy, select "Github" And link to your forked repo.
Press "Manual Deploy"
Go to the settings tab, press reveal config vars.
Enter ALL the config variables listed below and their respective value. The end result should be something like this

Config Var	Value
MainGuildID	int:The Main Guilds's ID
StaffGuildID	int:The Staff Guild's ID. Can be the same as MainGuildID.
ModMailCatagoryID	int:The Modmail Catagory's ID
DiscordModmailLogChannel	int:The ID of the Modmail Logging Channel
BotToken	str:The Bot's Token
BotPlayingStatus	str:The Bot's Playing Status
BotPrefix	str:The Bot's Prefix
LogCommands	bool:True/False. Since you are hosting on heroku, this would not affect regardless of input, but it must be a boolean.
BotBoundToGuilds	bool:True/False. Weather the bot should be bounded to the Main and Staff Guilds.
BotDMOwnerOnRestart	bool:True/False. Wheater the bot should DM bot owner when restart.
BotAutoReconnect	bool:True/False Wheater the bot should auto-reconnect if it becomes disconnected.
FROM_HEROKU	True. THIS MUST BE TRUE.

Reference : You can refer to this video which teaches you how to host a bot in heroku. However, please DO NOT FOLLOW STEP BY STEP because your target here is to get a feel on how to create a bot on heroku not follow what it teaches.

Video : https://www.youtube.com/watch?v=6za78ipFzg4 (see from 2:13 minute mark)

Go to Workers, and start the worker.
The bot is up!

Usage

Commands

Do {prefix}help in the staff guild for help.

Author

XtremeCoder

Bug Reporting and Feature Requesting

Use the Issues tab under this repository to report bugs and suggest features.

FAQ

Q: Which users get access to the channels for the modmail thread?

A: It depends on the permission settings of the Mod Mail Catagory.

Q: Which users can use the modmail commands?

A: Modmail commands can only be used in the modmail thread channels. Thus, whoever can see the channels can use the commands!

However, for other administrative commands, Manage Server is required.

Q: When FROM_HEROKU is specified, it creates three channels. Can I delete them?

A: NO. The bot stores data on the channels. As such, those channels cannot be deleted, renamed or modified in any way.

TODO

View whole blacklist
Show edited messages from user
Custom Start/Close Thread messages
Ratings , rate
Reverse typing proxy
Anonymous reply
Use user's top role instead of (Mod)
Use Embed or not
From_HEROKU if one or more data channels deleted, automatically recreate them.
Edit the messages already sent. User can do !edit <modmail message id, in the staff reply channel> --> this requires modmail to store <messageid of the message in the staff channel'> = <messageid of the message in the user's dm>, so that it can edit the correct message

MrKanishkPatel / Discord-Modmail