{"id":39289242,"url":"https://github.com/nessshon/support-bot","last_synced_at":"2026-01-18T01:15:16.228Z","repository":{"id":218360541,"uuid":"743865960","full_name":"nessshon/support-bot","owner":"nessshon","description":"Telegram bot for feedback with topic support.","archived":false,"fork":false,"pushed_at":"2025-07-02T22:59:21.000Z","size":75,"stargazers_count":77,"open_issues_count":1,"forks_count":26,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-07-02T23:33:29.796Z","etag":null,"topics":["aiogram","feedback-bot","support-bot","telegram-bot"],"latest_commit_sha":null,"homepage":"https://t.me/nessshonSupportBot","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/nessshon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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,"zenodo":null}},"created_at":"2024-01-16T06:43:19.000Z","updated_at":"2025-07-02T22:59:24.000Z","dependencies_parsed_at":"2024-04-04T19:31:54.678Z","dependency_job_id":"bcd837cc-d027-43d0-95df-caa47970970e","html_url":"https://github.com/nessshon/support-bot","commit_stats":null,"previous_names":["nessshon/support-bot"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/nessshon/support-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nessshon%2Fsupport-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nessshon%2Fsupport-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nessshon%2Fsupport-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nessshon%2Fsupport-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nessshon","download_url":"https://codeload.github.com/nessshon/support-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nessshon%2Fsupport-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28525941,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T00:39:45.795Z","status":"ssl_error","status_checked_at":"2026-01-18T00:39:39.467Z","response_time":85,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["aiogram","feedback-bot","support-bot","telegram-bot"],"created_at":"2026-01-18T01:15:15.675Z","updated_at":"2026-01-18T01:15:16.222Z","avatar_url":"https://github.com/nessshon.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤖 Support Bot\n\n[![License](https://img.shields.io/github/license/tonmendon/ton-subdomain)](https://github.com/tonmendon/ton-subdomain/blob/main/LICENSE)\n[![Telegram Bot](https://img.shields.io/badge/Bot-grey?logo=telegram)](https://core.telegram.org/bots)\n[![Python](https://img.shields.io/badge/Python-3.10-blue.svg)](https://www.python.org/downloads/release/python-3100/)\n[![Redis](https://img.shields.io/badge/Redis-Yes?logo=redis\u0026color=white)](https://redis.io/)\n[![Docker](https://img.shields.io/badge/Docker-blue?logo=docker\u0026logoColor=white)](https://www.docker.com/)\n\n**Support Bot** is a specially designed Telegram bot for feedback. With built-in support for topics, all user messages\nare intelligently categorized, promoting organized and streamlined discussion in your group. It provides features such\nas blocking unwanted users, silent mode in topics for discreet conversations, and more. Improve group communication with\nSupport Bot!\n\n* Bot example: [@nessshonSupportBot](https://t.me/nessshonSupportBot)\n* Linked group example: [@nessshonSupportGroup](https://t.me/nessshonSupportGroup)\n\n**About Limits**:\n\u003cblockquote\u003e\nSpecific limits are not specified in the documentation, but the community has shared some rough numbers. \n\u003cbr\u003e\n• Limit on topic creation per minute \u003cb\u003e~20\u003c/b\u003e.\n\u003cbr\u003e\n• Limit on the total number of topics \u003cb\u003e~1M\u003c/b\u003e.\n\u003c/blockquote\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eAvailable bot commands for admins (DEV_ID)\u003c/b\u003e\u003c/summary\u003e\n\n* `/newsletter` - Open the newsletter menu.\n\n  Use this command to initiate a newsletter for users.\n  **Note**: This command works only in private chats.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eAvailable bot commands in the group topics\u003c/b\u003e\u003c/summary\u003e\n\n* `/ban` - Block/Unblock User.\n\n  Use this command to block or unblock a user, controlling the receipt of messages from them.\n\n* `/silent` - Activate/Deactivate Silent Mode.\n\n  Enable or disable silent mode to prevent messages from being sent to the user.\n\n* `/information` - User Information.\n\n  Receive a message containing basic information about the user.\n\n\u003c/details\u003e\n\n## Usage\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003ePreparation\u003c/b\u003e\u003c/summary\u003e\n\n1. Create a bot via [@BotFather](https://t.me/BotFather) and save the TOKEN (referred to as `BOT_TOKEN` later).\n2. Create a group and enable topics in the group settings.\n3. Add the created bot to the group as an admin and grant it the necessary rights to manage topics.\n4. Add the bot [What's my Telegram ID?](https://t.me/my_id_bot) to the group and save the group ID (referred to\n   as `BOT_GROUP_ID` later).\n5. Optionally, customize the bot texts to fit your needs in the file\n   named [texts](https://github.com/nessshon/support-bot/tree/main/app/bot/utils/texts.py).\n6. Optionally, add the language you need\n   to [SUPPORTED_LANGUAGES](https://github.com/nessshon/support-bot/tree/main/app/bot/utils/texts.py#L4)\n   and add the appropriate codes to\n   the [data](https://github.com/nessshon/support-bot/tree/main/app/bot/utils/texts.py#L49).\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eInstallation\u003c/b\u003e\u003c/summary\u003e\n\nYou need your own server or you can rent one from a hosting provider. For this, check out the [Recommended Hosting Provider](#recommended-hosting-provider) section below.\n\n1. Clone the repository:\n\n    ```bash\n    git clone https://github.com/nessshon/support-bot.git\n    ```\n\n2. Change into the bot directory:\n\n    ```bash\n    cd support-bot\n    ```\n3. Clone environment variables file:\n\n   ```bash\n   cp .env.example .env\n   ```\n\n4. Configure [environment variables](#environment-variables-reference) variables file:\n\n   ```bash\n   nano .env\n   ```\n\n5. Running a bot in a docker container:\n\n   ```bash\n   docker-compose up --build\n   ```\n\n\u003c/details\u003e\n\n## Environment Variables Reference\n\n\u003cdetails\u003e\n\u003csummary\u003eClick to expand\u003c/summary\u003e\n\nHere is a comprehensive reference guide for the environment variables used in the project:\n\n| Variable       | Type  | Description                                                   | Example               |\n|----------------|-------|---------------------------------------------------------------|-----------------------|\n| `BOT_TOKEN`    | `str` | Bot token, obtained from [@BotFather](https://t.me/BotFather) | `123456:qweRTY`       | \n| `BOT_DEV_ID`   | `int` | User ID of the bot developer or admin                         | `123456789`           |\n| `BOT_GROUP_ID` | `str` | Group ID where the bot operates                               | `-100123456789`       |\n| `BOT_EMOJI_ID` | `str` | The custom emoji ID for the group's topic.                    | `5417915203100613993` |\n| `REDIS_HOST`   | `str` | The hostname or IP address of the Redis server                | `redis`               |\n| `REDIS_PORT`   | `int` | The port number on which the Redis server is running          | `6379`                |\n| `REDIS_DB`     | `int` | The Redis database number                                     | `1`                   |\n\n\u003cdetails\u003e\n\u003csummary\u003eList of supporting custom emoji ID's\u003c/summary\u003e\n\n`5434144690511290129` - 📰\n\n`5312536423851630001` - 💡\n\n`5312016608254762256` - ⚡️\n\n`5377544228505134960` - 🎙\n\n`5418085807791545980` - 🔝\n\n`5370870893004203704` - 🗣\n\n`5420216386448270341` - 🆒\n\n`5379748062124056162` - ❗️\n\n`5373251851074415873` - 📝\n\n`5433614043006903194` - 📆\n\n`5357315181649076022` - 📁\n\n`5309965701241379366` - 🔎\n\n`5309984423003823246` - 📣\n\n`5312241539987020022` - 🔥\n\n`5312138559556164615` - ❤️\n\n`5377316857231450742` - ❓\n\n`5350305691942788490` - 📈\n\n`5350713563512052787` - 📉\n\n`5309958691854754293` - 💎\n\n`5350452584119279096` - 💰\n\n`5309929258443874898` - 💸\n\n`5377690785674175481` - 🪙\n\n`5310107765874632305` - 💱\n\n`5377438129928020693` - ⁉️\n\n`5309950797704865693` - 🎮\n\n`5350554349074391003` - 💻\n\n`5409357944619802453` - 📱\n\n`5312322066328853156` - 🚗\n\n`5312486108309757006` - 🏠\n\n`5310029292527164639` - 💘\n\n`5310228579009699834` - 🎉\n\n`5377498341074542641` - ‼️\n\n`5312315739842026755` - 🏆\n\n`5408906741125490282` - 🏁\n\n`5368653135101310687` - 🎬\n\n`5310045076531978942` - 🎵\n\n`5420331611830886484` - 🔞\n\n`5350481781306958339` - 📚\n\n`5357107601584693888` - 👑\n\n`5375159220280762629` - ⚽️\n\n`5384327463629233871` - 🏀\n\n`5350513667144163474` - 📺\n\n`5357121491508928442` - 👀\n\n`5357185426392096577` - 🫦\n\n`5310157398516703416` - 🍓\n\n`5310262535021142850` - 💄\n\n`5368741306484925109` - 👠\n\n`5348436127038579546` - ✈️\n\n`5357120306097956843` - 🧳\n\n`5310303848311562896` - 🏖\n\n`5350424168615649565` - ⛅️\n\n`5413625003218313783` - 🦄\n\n`5350699789551935589` - 🛍\n\n`5377478880577724584` - 👜\n\n`5310303848311562896` - 🏖\n\n`5350424168615649565` - ⛅️\n\n`5413625003218313783` - 🦄\n\n`5350699789551935589` - 🛍\n\n`5377478880577724584` - 👜\n\n`5431492767249342908` - 🛒\n\n`5350497316203668441` - 🚂\n\n`5350422527938141909` - 🛥\n\n`5418196338774907917` - 🏔\n\n`5350648297189023928` - 🏕\n\n`5309832892262654231` - 🤖\n\n`5350751634102166060` - 🪩\n\n`5377624166436445368` - 🎟\n\n`5386395194029515402` - 🏴\n\n`5350387571199319521` - 🗳\n\n`5357419403325481346` - 🎓\n\n`5368585403467048206` - 🔭\n\n`5377580546748588396` - 🔬\n\n`5377317729109811382` - 🎶\n\n`5382003830487523366` - 🎤\n\n`5357298525765902091` - 🕺\n\n`5357370526597653193` - 💃\n\n`5357188789351490453` - 🪖\n\n`5348227245599105972` - 💼\n\n`5411138633765757782` - 🧪\n\n`5386435923204382258` - 👨\n\n`5377675010259297233` - 👶\n\n`5386609083400856174` - 🤰\n\n`5368808634392257474` - 💅\n\n`5350548830041415279` - 🏛\n\n`5355127101970194557` - 🧮\n\n`5386379624773066504` - 🖨\n\n`5377494501373780436` - 👮\n\n`5350307998340226571` - 🩺\n\n`5310094636159607472` - 💊\n\n`5310139157790596888` - 💉\n\n`5377468357907849200` - 🧼\n\n`5418115271267197333` - 🪪\n\n`5372819184658949787` - 🛃\n\n`5350344462612570293` - 🍽\n\n`5384574037701696503` - 🐟\n\n`5310039132297242441` - 🎨\n\n`5350658016700013471` - 🎭\n\n`5357504778685392027` - 🎩\n\n`5350367161514732241` - 🔮\n\n`5350520238444126134` - 🍹\n\n`5310132165583840589` - 🎂\n\n`5350392020785437399` - ☕️\n\n`5350406176997646350` - 🍣\n\n`5350403544182694064` - 🍔\n\n`5350444672789519765` - 🍕\n\n`5312424913615723286` - 🦠\n\n`5417915203100613993` - 💬\n\n`5312054580060625569` - 🎄\n\n`5309744892677727325` - 🎃\n\n`5238156910363950406` - ✍️\n\n`5235579393115438657` - ⭐️\n\n`5237699328843200968` - ✅\n\n`5238027455754680851` - 🎖\n\n`5238234236955148254` - 🤡\n\n`5237889595894414384` - 🧠\n\n`5237999392438371490` - 🦮\n\n`5235912661102773458` - 🐈\n\n\u003c/details\u003e\n\n\u003c/details\u003e\n\n## Recommended Hosting Provider\n\nI recommend using [aeza.net](https://aeza.net/?ref=362599) for your hosting needs. Here's why:\n\n- **24/7 Support**: Quick and effective support via chat or phone.\n- **Promo Plan for €1**: Great for testing Telegram bots and small websites.\n- **Easy Backups**: Secure backups on independent servers.\n- **Hourly Billing**: Rent a server by the hour for testing or demos.\n- **Anti-DDoS Protection**: Reliable and secure internet connection for your business.\n- **Multiple Payment Methods**: Supports various payment methods, including cryptocurrencies like TON.\n\nLearn more at [aeza.net](https://aeza.net/?ref=362599).\n\n## Donations\n\n**TON** - `EQC-3ilVr-W0Uc3pLrGJElwSaFxvhXXfkiQA3EwdVBHNNess`\n\n**USDT** (TRC-20) - `TDHMG7JRkmJBDD1qd4bNhdfoy2uzVd8ixA`\n\n## Contribution\n\nWe welcome your contributions! If you have ideas for improvement or have identified a bug, please create an issue or\nsubmit a pull request.\n\n## License\n\nThis repository is distributed under the [MIT License](LICENSE).\nFeel free to use, modify, and distribute the code in accordance with the terms of the license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnessshon%2Fsupport-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnessshon%2Fsupport-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnessshon%2Fsupport-bot/lists"}