https://github.com/fabston/Telegram-Support-Bot

📬 Manage and organize all your support inquiries on Telegram.
https://github.com/fabston/Telegram-Support-Bot

bot python support telebot telegram ticket

Last synced: 3 days ago
JSON representation

📬 Manage and organize all your support inquiries on Telegram.

• Host: GitHub
• URL: https://github.com/fabston/Telegram-Support-Bot
• Owner: fabston
• License: mit
• Created: 2020-07-02T08:11:59.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2023-06-02T15:13:25.000Z (over 1 year ago)
• Last Synced: 2024-08-01T19:55:29.014Z (3 months ago)
• Topics: bot, python, support, telebot, telegram, ticket
• Language: Python
• Homepage:
• Size: 739 KB
• Stars: 87
• Watchers: 9
• Forks: 29
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        




    

    

    

    

    


    

    





  About

  •

  Features

  •

  Installation

  •

  Images

  •

  Help



## About

The **Telegram Support Bot** 📬 helps you to manage and organize your support inquiries.

## Features

- **Text**, **Photos**, **Documents** and **Stickers** are being forwarded

- Spam protection (sensitivity can be set in [`config.py`](https://github.com/fabston/Telegram-Support-Bot/blob/master/config.py))

- Bad words filter (using regex, words can be set in [`config.py`](https://github.com/fabston/Telegram-Support-Bot/blob/master/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](https://github.com/fabston/Telegram-Support-Bot/issues/new?assignees=&labels=enhancement&template=feature-request---.md) 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's CX11 VPS for 2.89€/month. [Sign up](https://hetzner.cloud/?ref=tQ1NdT8zbfNY) now and receive **€20 free** credits.

1. Log into MySQL (`sudo mysql`) and create a dedicated database and user with the following commands:

   1. `CREATE DATABASE TelegramSupportBot;`

   1. `CREATE USER 'SupportBotUser'@'localhost' IDENTIFIED BY '';`

   1. `GRANT ALL PRIVILEGES ON TelegramSupportBot . * TO 'SupportBotUser'@'localhost';`

   1. `exit;`

1. Clone this repository `git clone https://github.com/fabston/Telegram-Support-Bot.git`

1. Create your virtual environment `python3 -m venv Telegram-Support-Bot`

1. Activate it `source Telegram-Support-Bot/bin/activate && cd Telegram-Support-Bot`

1. Install all requirements `pip install -r requirements.txt`

1. Edit and update [`config.py`](https://github.com/fabston/Telegram-Support-Bot/blob/master/config.py)

1. Run the bot `python main.py`

## Images

![Telegram Support Bot](https://raw.githubusercontent.com/fabston/Telegram-Support-Bot/master/assets/about.jpg)

## How can I help?

All kinds of contributions are welcome 🙌! The most basic way to show your support is to `⭐️ star` the project, or raise [`🐞 issues`](https://github.com/fabston/Telegram-Support-Bot/issues/new/choose). 

***