{"id":20895501,"url":"https://github.com/fabston/telegram-support-bot","last_synced_at":"2025-05-12T23:31:59.099Z","repository":{"id":56506457,"uuid":"276587652","full_name":"fabston/Telegram-Support-Bot","owner":"fabston","description":"📬 Manage and organize all your support inquiries on Telegram.","archived":false,"fork":false,"pushed_at":"2023-06-02T15:13:25.000Z","size":757,"stargazers_count":103,"open_issues_count":4,"forks_count":31,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-05-12T20:04:33.439Z","etag":null,"topics":["bot","python","support","telebot","telegram","ticket"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fabston.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["fabston"],"liberapay":"fabston"}},"created_at":"2020-07-02T08:11:59.000Z","updated_at":"2025-04-25T22:41:30.000Z","dependencies_parsed_at":"2024-08-01T19:44:14.337Z","dependency_job_id":"52f1456b-fdc7-4998-ad8d-36ac0d7d9c49","html_url":"https://github.com/fabston/Telegram-Support-Bot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabston%2FTelegram-Support-Bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabston%2FTelegram-Support-Bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabston%2FTelegram-Support-Bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fabston%2FTelegram-Support-Bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fabston","download_url":"https://codeload.github.com/fabston/Telegram-Support-Bot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253840680,"owners_count":21972526,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","python","support","telebot","telegram","ticket"],"created_at":"2024-11-18T10:29:08.873Z","updated_at":"2025-05-12T23:31:58.799Z","avatar_url":"https://github.com/fabston.png","language":"Python","funding_links":["https://github.com/sponsors/fabston","https://liberapay.com/fabston","https://www.buymeacoffee.com/fabston"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003ca href=\"https://github.com/fabston/Telegram-Support-Bot\" target=\"_blank\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/fabston/Telegram-Support-Bot/master/assets/logo.png\"\u003e\u003c/a\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://www.python.org/downloads/release/python-380/\"\u003e\u003cimg src=\"https://img.shields.io/badge/python-3.9-blue.svg?style=plastic\" alt=\"Python version\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/fabston/Telegram-Support-Bot/blob/master/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/fabston/Telegram-Support-Bot?style=plastic\" alt=\"GitHub license\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/fabston/Telegram-Support-Bot/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/fabston/Telegram-Support-Bot?style=plastic\" alt=\"GitHub issues\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/fabston/Telegram-Support-Bot/pulls\"\u003e\u003cimg src=\"https://img.shields.io/github/issues-pr/fabston/Telegram-Support-Bot?style=plastic\" alt=\"GitHub pull requests\"\u003e\u003c/a\u003e\n    \u003cbr /\u003e\u003ca href=\"https://github.com/fabston/Telegram-Support-Bot/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/fabston/Telegram-Support-Bot?style=social\" alt=\"GitHub stars\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/fabston/Telegram-Support-Bot/network/members\"\u003e\u003cimg src=\"https://img.shields.io/github/forks/fabston/Telegram-Support-Bot?style=social\" alt=\"GitHub forks\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/fabston/Telegram-Support-Bot/watchers\"\u003e\u003cimg src=\"https://img.shields.io/github/watchers/fabston/Telegram-Support-Bot?style=social\" alt=\"GitHub watchers\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#about\"\u003eAbout\u003c/a\u003e\n  •\n  \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e\n  •\n  \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\n  •\n  \u003ca href=\"#images\"\u003eImages\u003c/a\u003e\n  •\n  \u003ca href=\"#how-can-i-help\"\u003eHelp\u003c/a\u003e\n\u003c/p\u003e\n\n## About\nThe **Telegram Support Bot** 📬 helps you to manage and organize your support inquiries.\n\n## Features\n- **Text**, **Photos**, **Documents** and **Stickers** are being forwarded\n- Spam protection (sensitivity can be set in [`config.py`](https://github.com/fabston/Telegram-Support-Bot/blob/master/config.py))\n- Bad words filter (using regex, words can be set in [`config.py`](https://github.com/fabston/Telegram-Support-Bot/blob/master/config.py))\n- List all open/unanswered tickets (time passed since ticket opened is being shown as well)\n- Ban / Un-ban users (via reply or user id). User won't be able to interact with the bot anymore\n- List banned users, with last interaction point\n- Customisable FAQ text\n- Detect the users language and display it as an emoji\n\n\u003e 💡 Got a feature idea? Open an [issue](https://github.com/fabston/Telegram-Support-Bot/issues/new?assignees=\u0026labels=enhancement\u0026template=feature-request---.md) and I might implement it.\n\n### Staff commands\n| Command | Description |\n| --- | --- |\n| /ban | Ban user by ID or reply |\n| /unban | Un-ban user by ID or reply |\n| /banned | List banned users |\n| /tickets or /t | List open tickets |\n| /close or /c | Manually close a ticket by reply |\n\n### User commands\n| Command | Description |\n| --- | --- |\n| /start | Starts the bot |\n| /faq | Show the FAQ's |\n\n\n## Installation\n\u003e ⚠️ Best to run the bot on a VPS. I can recommend \u003ca href=\"https://hetzner.cloud/?ref=tQ1NdT8zbfNY\" title=\"Get €20 in cloud credits\"\u003eHetzner\u003c/a\u003e's CX11 VPS for 2.89€/month. [Sign up](https://hetzner.cloud/?ref=tQ1NdT8zbfNY) now and receive **€20 free** credits.\n1. Log into MySQL (`sudo mysql`) and create a dedicated database and user with the following commands:\n   1. `CREATE DATABASE TelegramSupportBot;`\n   1. `CREATE USER 'SupportBotUser'@'localhost' IDENTIFIED BY '\u003cYOUR PASSWORD\u003e';`\n   1. `GRANT ALL PRIVILEGES ON TelegramSupportBot . * TO 'SupportBotUser'@'localhost';`\n   1. `exit;`\n1. Clone this repository `git clone https://github.com/fabston/Telegram-Support-Bot.git`\n1. Create your virtual environment `python3 -m venv Telegram-Support-Bot`\n1. Activate it `source Telegram-Support-Bot/bin/activate \u0026\u0026 cd Telegram-Support-Bot`\n1. Install all requirements `pip install -r requirements.txt`\n1. Edit and update [`config.py`](https://github.com/fabston/Telegram-Support-Bot/blob/master/config.py)\n1. Run the bot `python main.py`\n\n\n## Images\n![Telegram Support Bot](https://raw.githubusercontent.com/fabston/Telegram-Support-Bot/master/assets/about.jpg)\n\n## How can I help?\nAll 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). \n\n***\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://www.buymeacoffee.com/fabston\"\u003e\u003cimg alt=\"Buy Me A Coffee\" title=\"☕️\" src=\"https://github.com/fabston/Telegram-Airdrop-Bot/blob/main/assets/bmac.png?raw=true\" width=200px\u003e\u003c/a\u003e\n\u003c/p\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabston%2Ftelegram-support-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffabston%2Ftelegram-support-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabston%2Ftelegram-support-bot/lists"}