YanguBot is a Discord bot that integrates with a WooCommerce store that can help stores engage with their customers.
- Order status checking
- Shipping estimates
- Auto-assigning roles to verified customers
- Custom commands
In its current state, YanguBot is configured for our use case and some features may require you to manually reconfigure them in the code. At the moment, one of priorities is to make this more user-friendly to modify.
- Install Python 3.7 and prerequisites using
pip install -r requirements.txt. - Make a copy of
config_ex.pyand rename it toconfig.py. Configure the bot as desired. See Configuration. - Run the bot using
python bot.py.
TODO
!status <order_id> - Check the status of an order.
!cc <add/remove/list> - Manage custom commands. See Custom Commands. Requires a staff role.
!wcm <order_id> - Sends a Direct Message to the sender containing a direct link to the order on WooCommerce. Requires a staff role.
!stop_bot - Stops the bot. Requires bot owner.
Custom commands allow you to set messages that can be triggered by staff members. Useful for responding to common inquiries.
!cc add <trigger> <title> <message> - Creates a new custom command. Titles and messages with multiple words should be surrounded by quotation marks. Note that only one custom command can be assigned to a specific trigger.
!cc remove <trigger> - Removes the custom command with the specified trigger.
!cc list - Lists all custom commands.