https://github.com/sudor2spr/quiz-polls-bot
Advanced Poll Bot! Create professional polls in any language with flexible formatting. 🎉 v1.0
https://github.com/sudor2spr/quiz-polls-bot
angel javascript multiple-quiz-bot node-js opleech poll quiz-bot sudor2spr telegram-poll-bot woodcraft
Last synced: 5 months ago
JSON representation
Advanced Poll Bot! Create professional polls in any language with flexible formatting. 🎉 v1.0
- Host: GitHub
- URL: https://github.com/sudor2spr/quiz-polls-bot
- Owner: SudoR2spr
- License: mit
- Created: 2025-05-31T11:34:20.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-06-01T06:07:32.000Z (about 1 year ago)
- Last Synced: 2025-07-21T05:14:17.483Z (11 months ago)
- Topics: angel, javascript, multiple-quiz-bot, node-js, opleech, poll, quiz-bot, sudor2spr, telegram-poll-bot, woodcraft
- Language: JavaScript
- Homepage: https://t.me/Opleech_WD
- Size: 55.7 KB
- Stars: 1
- Watchers: 0
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README


[](https://git.io/typing-svg)
---
## 🗳️ Advanced Telegram Poll Bot
A powerful and multilingual Telegram bot to create professional-looking polls with various formats — including **basic polls**, **quiz polls**, and **multi-format polls**. Built using **Telegraf.js**, this bot supports persistent buttons, inline help, image replies, and rate limiting.
---
## 📌 Features
- 🎯 Basic, Quiz, and Multi-format Polls
- 🌐 Language-ready format (currently English, extensible)
- 🧠 Rate-limiting to avoid spam
- 📸 Welcome Image with Inline Buttons
- 🔄 Smart Message Editing for Help/Back buttons
- 🧩 Modular and easy-to-extend structure
---
## 🚀 Deploy
[](https://heroku.com/deploy?template=https://github.com/SudoR2spr/Quiz-polls-Bot)
[](https://render.com/deploy?repo=https://github.com/SudoR2spr/Quiz-polls-Bot)
## 🚀 Deployment
### 🧱 Prerequisites
- Node.js (v18 or above)
- Telegram Bot Token from [BotFather](https://t.me/BotFather)
---
### 📦 Installation
```bash
git clone https://github.com/SudoR2spr/Quiz-polls-Bot.git
cd Quiz-polls-Bot
npm install
```
---
### 🔧 Environment Variables
Create a `.env` file in the root directory with the following:
```env
BOT_TOKEN=your_bot_token_here
BASE_URL=https://your-app-url.com
PORT=3000
```
---
## 🏃♂️ Run the Bot
```bash
npm start
```
The bot will start and respond to the following commands:
---
## 🛠 Available Commands
| Command | Description |
|--------------|--------------------------------------------|
| /start | Sends welcome image and buttons |
| /help | Shows poll creation guide |
| /poll | Basic poll: `/poll "Question"` |
| /pollquiz | Quiz poll with explanation |
| /pollmult | Advanced format: options in A/B/C form |
| /future | (Planned) Show upcoming features |
---
## 🖼 Welcome Image & Buttons
The `/start` command sends an image with:
- ✅ Inline button: Help
- 🔗 External button: Join Channel
If message editing fails, the bot deletes the previous message and sends a new one.
---
## 📖 Example Usage
### Multi-format Poll:
```
/pollmult Which country has the largest Bengali-speaking population?
a) India
b) Bangladesh ✅
c) Pakistan
Based on 2023 language census data
```
### Quiz Poll:
```
/pollquiz What is the capital of France?
Paris ✅ | Berlin | Madrid
Correct answer is Paris.
```
---
## 🔒 Rate Limiting
To avoid abuse, each user can trigger a command once every **3 seconds**.
If exceeded, the bot replies:
> ❌ দয়া করে একটু অপেক্ষা করুন! খুব দ্রুত কমান্ড পাঠাচ্ছেন।
---
## 💡 Planned Features
- 🔄 Multi-language UI
- 🕑 Scheduled Polls
- 📊 Poll Analytics Dashboard
- 📄 Poll Templates
---
## 📜 License
MIT License © [SudoR2spr]
See the [LICENSE](./LICENSE) file for more info.
# Connect with me
-----
♥️ Credits: [𝐖𝐎𝐎𝐃𝐜𝐫𝐚𝐟𝐭](https://t.me/Farooq_is_KING)
[](https://t.me/Farooq_is_king)
Last Updated: Sat,May,31,2025