Skip to content

SudoR2spr/Quiz-polls-Bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

29 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

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

Deploy to Heroku

Deploy to Render

๐Ÿš€ Deployment

๐Ÿงฑ Prerequisites

  • Node.js (v18 or above)
  • Telegram Bot Token from BotFather

๐Ÿ“ฆ Installation

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:

BOT_TOKEN=your_bot_token_here
BASE_URL=https://your-app-url.com
PORT=3000

๐Ÿƒโ€โ™‚๏ธ Run the Bot

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 file for more info.

Connect with me




โ™ฅ๏ธ Credits: ๐–๐Ž๐Ž๐ƒ๐œ๐ซ๐š๐Ÿ๐ญ

Contact Me On Telegram


Last Updated: Sat,May,31,2025

About

Advanced Poll Bot! Create professional polls in any language with flexible formatting. ๐ŸŽ‰ v1.0

Topics

Resources

License

Stars

Watchers

Forks