{"id":27252430,"url":"https://github.com/ekans111/simp-referral-bot","last_synced_at":"2025-04-11T01:21:02.086Z","repository":{"id":251967492,"uuid":"838233257","full_name":"Ekans111/Simp-Referral-Bot","owner":"Ekans111","description":"This is a Telegram Referral bot that works on Render running with webhook and polling method that users can send referral to their friends and get them to join your telegram group and shows ranking of referrals.","archived":false,"fork":false,"pushed_at":"2025-02-20T07:06:52.000Z","size":295,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-20T08:22:49.575Z","etag":null,"topics":["blockchain","cryptocurrency","javascript","nowpayments","polling","referral","telegram","telegram-api","telegram-bot","telegram-referrals","webhook"],"latest_commit_sha":null,"homepage":"https://simpreferralbot.onrender.com","language":"JavaScript","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/Ekans111.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-05T08:15:44.000Z","updated_at":"2025-02-20T07:06:55.000Z","dependencies_parsed_at":"2025-02-20T08:22:51.947Z","dependency_job_id":"a0818905-f0e5-449a-967e-ac010c25a41f","html_url":"https://github.com/Ekans111/Simp-Referral-Bot","commit_stats":null,"previous_names":["ekans111/simpreferralbot","ekans111/simp-referral-bot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ekans111%2FSimp-Referral-Bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ekans111%2FSimp-Referral-Bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ekans111%2FSimp-Referral-Bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ekans111%2FSimp-Referral-Bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ekans111","download_url":"https://codeload.github.com/Ekans111/Simp-Referral-Bot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248323218,"owners_count":21084463,"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":["blockchain","cryptocurrency","javascript","nowpayments","polling","referral","telegram","telegram-api","telegram-bot","telegram-referrals","webhook"],"created_at":"2025-04-11T01:21:01.719Z","updated_at":"2025-04-11T01:21:02.079Z","avatar_url":"https://github.com/Ekans111.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simp Referral Bot\n\nThis Telegram bot, designed to run on Render, allows users to send referral links to their friends and track their success in bringing new members to your Telegram group. The bot also features a ranking system to showcase top referrers.\n\n## Features\n\n- Generate unique referral links for users\n- Track successful referrals\n- Display a leaderboard of top referrers\n- Easy deployment on Render\n\n## Installation\n\n1. Clone this repository: \u003cbr /\u003e\n\n   `git clone https://github.com/Ekans111/Simp-Referral-Bot.git` \u003cbr/\u003e\n   `cd Simp-Referral-Bot` \u003cbr/\u003e\n   \n2. Install the required dependencies: \u003cbr /\u003e\n  `npm install`\n\n## Configuration\n\n1. Create a `.env` file in the project root and add the following .env.example file.\n2. Replace the placeholders with your actual values:\n   - `your_telegram_bot_token`: Obtain this from [@BotFather](https://t.me/BotFather) on Telegram\n   - `your_telegram_group_link`: The Link of the group you want users to join\n   - `your_database_url`: Your MongoDB database URL\n\n## Usage\n\nTo start the bot locally: \u003cbr /\u003e\n   run `npm start`\n\n## Deployment\n\nThis bot is designed to be deployed on Render. Follow these steps:\n\n1. Create a new Web Service on Render\n2. Connect your GitHub repository\n3. Set the environment variables in the Render dashboard\n4. Deploy the bot\n\n## Commands\n\n- `/start`: Access the help menu\n- `/myreferral`:Generate your unique referral link\n- `/leaderboard`: View the top members who have invited friends to become group user\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Author\n\n[ekans111](https://t.me/Ecrypto_1)\n\n## Live Bot\n\n[@SimpReferralBot](https://t.me/SimpReferralBot)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fekans111%2Fsimp-referral-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fekans111%2Fsimp-referral-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fekans111%2Fsimp-referral-bot/lists"}