{"id":14956700,"url":"https://github.com/30mb1/telegram-mailer","last_synced_at":"2025-10-13T19:38:04.598Z","repository":{"id":50212444,"uuid":"103108932","full_name":"30mb1/Telegram-mailer","owner":"30mb1","description":"Web-application for sending messages to list of users. Use several accounts to avoid ban.","archived":false,"fork":false,"pushed_at":"2022-12-08T00:38:30.000Z","size":1106,"stargazers_count":34,"open_issues_count":6,"forks_count":11,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-05T04:41:37.966Z","etag":null,"topics":["flask-application","mongodb-database","python-3","spammer","telegram","telegram-api","telegram-bots","telegram-client","telegram-mailer","telegram-spammer","telethon"],"latest_commit_sha":null,"homepage":"","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/30mb1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-09-11T08:18:47.000Z","updated_at":"2025-03-22T21:06:49.000Z","dependencies_parsed_at":"2023-01-24T01:00:41.614Z","dependency_job_id":null,"html_url":"https://github.com/30mb1/Telegram-mailer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/30mb1/Telegram-mailer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/30mb1%2FTelegram-mailer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/30mb1%2FTelegram-mailer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/30mb1%2FTelegram-mailer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/30mb1%2FTelegram-mailer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/30mb1","download_url":"https://codeload.github.com/30mb1/Telegram-mailer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/30mb1%2FTelegram-mailer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279016928,"owners_count":26085888,"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-10-13T02:00:06.723Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","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":["flask-application","mongodb-database","python-3","spammer","telegram","telegram-api","telegram-bots","telegram-client","telegram-mailer","telegram-spammer","telethon"],"created_at":"2024-09-24T13:13:22.317Z","updated_at":"2025-10-13T19:38:04.570Z","avatar_url":"https://github.com/30mb1.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Telegram mailer\n\nTelegram mailer is a web-application that allows sending messages to list of users from a number of accounts that you have connected to it, so that you don't have to do it manually or worry about ban. It is a great tool for automation of mail distribution for your customer base via telegram.\n\n## Getting started\n\n### Requirements\n\n- Python 3\n- MongoDB 3.2+\n- Nginx/Apache\n- 1+ telegram accounts\n\n### Installation\n\nClone repository\n\n```bash\ngit clone https://github.com/30mb1/Telegram-mailer.git\ncd Telegram-mailer\n```\n\nCreate virtual environment and install requirements.\n\n```bash\nvirtualenv -p python3 venv\nsource venv/bin/activate\npip install -r requirements.txt\n```\n\nSet up proxy server (example for nginx):\n\n- Create new configuration file in save it in */etc/nginx/sites-available/your_app.conf*\n\n  Content of *your_app.conf*:\n\n  ```\n  server {\n      listen 80;\n      server_name some_domain.com;\n   \n      root /path/to/your_app;\n   \n      access_log /path/to/your_app/logs/access.log;\n      error_log /path/to/your_app/logs/error.log;\n   \n      location / {\n          proxy_set_header X-Forward-For $proxy_add_x_forwarded_for;\n          proxy_set_header Host $http_host;\n          proxy_redirect off;\n          if (!-f $request_filename) {\n              proxy_pass http://127.0.0.1:8000; # you can choose another port\n              break;\n          }\n      }\n  }\n  ```\n\n- Create symbol link for sites-enabled:\n\n  ```\n  sudo ln -s /etc/nginx/sites-available/your_app.conf /etc/nginx/sites-enabled/\n  ```\n\n- Check configuration for mistakes:\n\n  ```\n  nginx -t\n  ```\n\n- If it is ok, reload nginx.\n\n  ```\n  service nginx reload\n  ```\n\nNow you can run application locally with gunicorn, using nginx for handling external requests and redirecting them.\n\n### Setting up\n\nApplication use telegram client api, so that we need api keys. Follow instructions on [this](https://core.telegram.org/api/obtaining_api_id) page to get **api_id** and **api_hash**. You then need to install them in app, using *initialize.py* module:\n\n```\n\u003e cd Telegram-mailer\n\u003e source venv/bin/activate\n\u003e python initialize.py\nEnter api_id:\nYOUR_API_ID\nEnter api_hash:\nYOUR_API_HASH\n```\n\nNow you can run application and check it locally or from external address that we specified in .conf file.\n\n```bash\ncd Telegram-mailer\nsource venv/bin/activate\n# choose port, that we used in nginx .conf file earlier\ngunicorn app:app -b 127.0.0.1:8000 -w 8 --threads 8 # you can run it in screen too\n# you can set another number of workers or threads, depenging on your system characteristics\n# more detailed info you can find for example here\n# http://docs.gunicorn.org/en/stable/settings.html\n```\n\nTo make program work we need to attach some telegram accounts to it, so program will use them for message delivery. You can do it on *account* page of our app. There you also can change login-password\n\n![http://pix.toile-libre.org/upload/original/1508499881.png](http://pix.toile-libre.org/upload/original/1508499881.png)\n\nAfter putting your phone number in form, you will receive a code, that you need to paste in new form, that will appear\n\n![http://pix.toile-libre.org/upload/original/1508500245.png](http://pix.toile-libre.org/upload/original/1508500245.png)\n\nIf the code is correct, number will be marked as activated and stay on this page. This account now is added to list that will be used for delivery. It is better to add more accounts, so that chances of their ban will be less, because app use accounts by queue.\n\n### Run\n\nTo start message distribution go to config page\n\n![http://pix.toile-libre.org/upload/original/1508502322.png](http://pix.toile-libre.org/upload/original/1508502322.png)\n\nSpecify a list of users you want deliver your message to in form @tg_username/phone_number and a message. Interval is used for pause before sending next message in order to avoid ban.\n\nAccounts, attached to app would be used by queue when sending messages. It means, that if we have 10 accounts and want to send message to 20 users, the order will be:\n\n```\nacc1 -\u003e user1\npause for some interval\nacc2 -\u003e user2\n...\nacc1 -\u003e user11\nacc2 -\u003e user12\n```\n\nWhile app is sending messages, there will be appropriate window on *mailer* tab. You should not start a new distribution before the old one is ended, because of ban possibility. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F30mb1%2Ftelegram-mailer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F30mb1%2Ftelegram-mailer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F30mb1%2Ftelegram-mailer/lists"}