{"id":19017684,"url":"https://github.com/jon4hz/tg-autoresponder","last_synced_at":"2025-07-22T09:09:19.456Z","repository":{"id":103557194,"uuid":"343719010","full_name":"jon4hz/tg-autoresponder","owner":"jon4hz","description":"☎️ Telegram Autoresponder","archived":false,"fork":false,"pushed_at":"2021-08-13T09:01:55.000Z","size":23,"stargazers_count":11,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-23T02:53:13.592Z","etag":null,"topics":["autoresponder","telegram","telegram-bot","telegram-userbot"],"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/jon4hz.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}},"created_at":"2021-03-02T09:35:44.000Z","updated_at":"2023-01-30T23:42:25.000Z","dependencies_parsed_at":"2023-10-18T08:32:06.708Z","dependency_job_id":null,"html_url":"https://github.com/jon4hz/tg-autoresponder","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/jon4hz/tg-autoresponder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jon4hz%2Ftg-autoresponder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jon4hz%2Ftg-autoresponder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jon4hz%2Ftg-autoresponder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jon4hz%2Ftg-autoresponder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jon4hz","download_url":"https://codeload.github.com/jon4hz/tg-autoresponder/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jon4hz%2Ftg-autoresponder/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266463115,"owners_count":23932895,"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","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"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":["autoresponder","telegram","telegram-bot","telegram-userbot"],"created_at":"2024-11-08T19:49:16.102Z","updated_at":"2025-07-22T09:09:19.420Z","avatar_url":"https://github.com/jon4hz.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# tg-autoresponder\n\n## About\nThis userbot is an autoresponder that responds with a predefined message if no message has been received for a certain time. The timeout time gets calculated for every user.  \nThe timeout is set for each user individually. The userbot only responds to messages from persons. Messages from groups or bots will be ignored.\n\n## Prerequisites\nTo use the autoresponder you'll need to create a Telegram Application. Follow this [tutorial](https://core.telegram.org/api/obtaining_api_id) if you are unfamiliar with that.\nThe following programs are also required:\n* `docker`\n* `docker-compose`\n\n## Setup\n### Build the image\nTo build the image use `sudo docker-compose build`\n\n### Environment variables\nSet all required variables in the file `env_autoresponder`.\n\n| Variable | Function | Default |\n| --- | --- | --- |\n| TELEGRAM_API_ID | Your Telegram API ID | - |\n| TELEGRAM_API_HASH | Your Telegram API HASH | - |\n| TELEGRAM_PHONE | Your phone number | - |\n| DATABASE_FILE | Location of the database file | data/database.db |\n| AUTORESPONDER_TIMEOUT | Timeout in minutes | 60 |\n\n### Inital setup\nSince telethon generates a session file the first startup, the container must be started initially  with `sudo docker-compose run autoresponder`.\nAfter that it stores the session file and the container can be started in the background by executing `sudo docker-compose up -d`\n\n## Customization\n### Autoresponder Message\nThe message which will be sent is located in `./data/message.py`. After editing the message, restart the container with `sudo docker-compose restart`.\n\n### Exclude users\nThere is an option to exclude users from receiving the automated message. Add a users Telegram ID in the `excluded_users` array in the file `./data/config.py`.\n\n## Contribute\nThis is an open source project which welcomes any kind of contributions. \n### Contributors \n[![Contributors](https://contributors-img.web.app/image?repo=jon4hz/tg-autoresponder)](https://github.com/jon4hz/tg-autoresponder/graphs/contributors)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjon4hz%2Ftg-autoresponder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjon4hz%2Ftg-autoresponder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjon4hz%2Ftg-autoresponder/lists"}