About • Features • Installation • Images • Help

About

The Telegram Support Bot 📬 helps you to manage and organize your support inquiries using the pyTelegramBotAPI libary.

Features

• Text, Photos, Documents and Stickers are being forwarded
• Spam protection (sensitivity can be set in config.py)
• Bad words filter (using regex, words can be set in config.py)
• List all open/unanswered tickets (time passed since ticket opened is being shown as well)
• Ban / Un-ban users (via reply or user id). User won't be able to interact with the bot anymore
• List banned users, with last interaction point
• Customisable FAQ text
• Detect the users language and display it as an emoji

💡 Got a feature idea? Open an issue and I might implement it.

Staff commands

Command	Description
/ban	Ban user by ID or reply
/unban	Un-ban user by ID or reply
/banned	List banned users
/tickets or /t	List open tickets
/close or /c	Manually close a ticket by reply

User commands

Command	Description
/start	Starts the bot
/faq	Show the FAQ's

Installation

⚠️ Best to run the bot on a VPS. I can recommend Hetzner.

1. Log into MySQL (sudo mysql) and create a dedicated database and user with the following commands:
   1. CREATE DATABASE TelegramSupportBot;
   2. CREATE USER 'tsbuser'@'localhost' IDENTIFIED BY 'your-password';
   3. GRANT ALL PRIVILEGES ON TelegramSupportBot . * TO 'tsbuser'@'localhost';
   4. exit;
2. Clone this repository git clone https://github.com/TheDevFab/Telegram-Support-Bot.git
3. Create your virtual environment python3 -m venv Telegram-Support-Bot
4. Activate it source Telegram-Support-Bot/bin/activate && cd Telegram-Support-Bot
5. Install all requirements pip install -r requirements.txt
6. Edit and update config.py
7. Run the bot python main.py

Images

How can I help?

All kinds of contributions are welcome! The most basic way to show your support is to ⭐️star the project, or to raise 🐞issues.