Request / Requirements
Create a Telegram bot for automating review work on various platforms. The bot should automate the process:
- Creating tasks for leaving reviews on platforms (Avito, Yandex Maps, Google, etc.)
- Distributing tasks among performers with instructions and checkpoints
- Automatic verification of review publication through parsing review pages
- Performer management — registration, statistics, task completion control
- Payment system for published reviews with screenshot verification
- Referral program for attracting new performers
- Data export to Excel for work analytics
- Admin panel with advanced capabilities for managing tasks and performers
- Work modes — day/night mode for work optimization
Development Process
Stage 1: Architecture Design (3 days)
Started with requirements analysis and bot structure design:
- Designed data structure for tasks, performers, reviews, and payments
- Developed role system: owner, admin, manager, performer, active
- Planned modular architecture with file separation (mm.js, reviewParser.js, logger.js, performerTexts.js)
- Designed session system for multi-step operations
- Defined directory structure for data storage (tasks, performers, reviews, payments)
Stage 2: Basic Bot Structure and Commands (4 days)
Created main bot structure and basic commands:
- Set up Telegraf with session system
- Implemented
/start, /active, /restore commands for user management
- Created user registration system with data saving to JSON files
- Implemented basic menu for performers and administrators
- Added rules system and consent to rules during registration
- Set up logging through Winston with separation into regular logs and errors
Screenshot 1: Bot Main Menu
Stage 3: Review Task Creation System (5 days)
Developed full-featured system for creating tasks for leaving reviews:
- Implemented task creation on various platforms (Avito, Yandex Maps, Google, etc.)
- Added review template system for quick task creation
- Created interface for performers to view and accept review tasks
- Implemented task filtering system by platforms
- Added ability to attach instructions with images for performers
- Created task completion control system with timers for review publication
- Implemented multi-step execution process: platform registration → action execution → review publication → verification
Screenshot 2: Creating Review Task
Stage 4: Automatic Review Publication Verification via Puppeteer (6 days)
Implemented automatic parsing of review pages to verify publication:
- Integrated Puppeteer with stealth plugin to bypass bot detection during parsing
- Implemented parsing of review pages on Yandex Maps with dynamic content support
- Added caching system for parsing results optimization for repeated checks
- Created
reviewParser.js module with support for various platforms (Yandex Maps, Google Maps, Avito)
- Implemented automatic verification of review presence by text and performer nickname
- Added parsing error handling with detailed logging
- Created review validation system before acceptance — checking text, publication date, authorship
Screenshot 3: Automatic Review Verification
Stage 5: Review Performer Management System (4 days)
Developed performer management system with advanced capabilities:
- Implemented performer registration with data saving and task history
- Created statistics system for each performer (published reviews, payments, rating)
- Added warning system (warn) for performers for violations
- Implemented user status management (active, banned, frozen, flew)
- Created user search system by ID or name for administrators
- Added ability to assign managers to administrators
- Implemented account freeze system when review publication is overdue
- Added review quality control — checking text compliance, publication time
Screenshot 4: Performer Management
Stage 6: Payment System for Published Reviews (3 days)
Implemented payment system for published and verified reviews:
- Implemented payment system for accepted reviews after automatic verification
- Created "flames" (flame) system — bonuses for series of published reviews
- Added ability to verify payment screenshots by administrators
- Implemented payment tracking system with transaction history
- Created automatic bonus accrual for series of completed review tasks
- Added refund system (flew) for unpublished or rejected reviews
- Implemented automatic notification to performers about payment accrual
Screenshot 5: Payment System
Stage 7: Referral Program (2 days)
Implemented new user attraction system:
- Created referral link system for each user
- Implemented tracking of invited users
- Added bonus accrual for invitations
- Created referral program statistics
- Implemented referral bonus payout system
Screenshot 6: Referral Program
Stage 8: Excel Data Export (2 days)
Added data export capability for analytics:
- Integrated ExcelJS for creating Excel files
- Implemented review export to Excel with formatting
- Created performer statistics export
- Added task and payment data export
- Implemented automatic report generation
Screenshot 7: Excel Export
Stage 9: Admin Panel and Advanced Features (5 days)
Developed full-featured admin panel:
- Created user management system with search and filtering
- Implemented task management (create, edit, delete)
- Added mass messaging system to users
- Created administrator and manager management system
- Implemented work modes (day/night/technical) with automatic switching
- Added news and notification system
- Created statistics for all aspects of bot operation
Screenshot 8: Admin Panel
Stage 10: Optimization and Improvements (3 days)
Conducted optimization and improvements:
- Optimized review parsing with result caching
- Improved error handling with detailed logging
- Added data validation system before saving
- Implemented automatic creation of necessary directories
- Optimized file system operations
- Added data backup system
Final Result
The bot is successfully launched and processes hundreds of tasks daily:
Implemented Features
- ✅ Review Task Creation: Creating tasks for leaving reviews on various platforms with instructions and templates
- ✅ Automatic Publication Verification: Verifying review publication through parsing review pages from Yandex Maps and other platforms
- ✅ Performer Management: Registration, statistics of published reviews, status management, warning system
- ✅ Payment System: Automatic payment accrual for published and verified reviews
- ✅ "Flames" System: Bonus system for series of published reviews with bonus accrual
- ✅ Referral Program: Attracting new performers with bonus accrual
- ✅ Data Export: Exporting reviews, performer statistics, and reports to Excel
- ✅ Admin Panel: Full-featured management of review tasks, performers, and publication verification
- ✅ Work Modes: Day/night/technical mode with automatic switching
- ✅ News System: Performer notifications about new review tasks and updates
Technical Achievements
- Stable parsing of review pages through Puppeteer with bot detection bypass
- Optimized file system operations for storing tasks and performer data
- Modular architecture with separation of concerns (mm.js, reviewParser.js, logger.js)
- Detailed logging of all parsing and review verification operations
- Caching system for optimizing repeated review checks
- Automatic creation of necessary directories and files
- Multi-step task execution process with control at each stage
Solution Advantages
- Automation: Automatic verification of review publication through page parsing without manual checking
- Scalability: Modular architecture allows easy addition of new review platforms
- Reliability: Detailed logging and error handling ensure stable parsing operation
- Convenience: Intuitive interface for performers and administrators with step-by-step task execution
- Analytics: Data export to Excel for analyzing performer work and task effectiveness
Technical Details
Architecture
- Backend: Node.js using Telegraf for Telegram Bot API work
- Review Parsing: Puppeteer with stealth plugin to bypass bot detection when parsing pages
- Data: JSON files for data storage (review tasks, performers, published reviews, payments)
- Logging: Winston with separation into regular logs and parsing errors
- Export: ExcelJS for creating Excel files with reviews and statistics
Implementation Features
- Modularity: Separation into modules (mm.js, reviewParser.js, logger.js, performerTexts.js)
- Sessions: Session system for multi-step operations (task creation, user management)
- Caching: Caching parsing results for optimization
- Validation: Data verification before saving and processing
- Security: Access rights verification for all administrative operations
Data Structure
- Review Tasks: Storing tasks with instructions, review templates, checkpoints, and statuses
- Performers: User data with statistics of published reviews, rating, and task history
- Reviews: Saving published reviews with parsing results and publication verification
- Payments: Payment and payout history for published reviews linked to tasks
- Referrals: Tracking invited performers and bonus accrual
Results
Achieved Goals
✅ Fully automated review publication verification process through page parsing
✅ Implemented system for creating tasks for leaving reviews on various platforms
✅ Created full-featured admin panel for managing tasks and performers
✅ Implemented payment and bonus system for published reviews
✅ Implemented referral program for attracting new performers
✅ Added data export to Excel for review work analytics
Solution Advantages
- Efficiency: Automating review publication verification significantly reduces time spent on manual checking
- Scalability: System easily scales for work with large number of review tasks and performers
- Flexibility: Modular architecture allows easy addition of new review platforms
- Reliability: Detailed logging and error handling ensure stable 24/7 parsing operation
- Convenience: Intuitive interface makes working with the bot simple and clear for performers and administrators
Application
Perfect for:
- Automating review work on various platforms (Avito, Yandex Maps, Google, etc.)
- Creating tasks for leaving reviews with automatic publication verification
- Managing teams of performers leaving reviews with payment and motivation system
- Analyzing performer work and review task effectiveness
- Scaling review business through referral program
Conclusion
The project is a full-featured system for automating review work on various platforms.
The bot processes hundreds of review tasks daily, automatically verifies review publication through parsing pages from various platforms,
manages performers, accrues payments and bonuses for published reviews, and provides detailed analytics through data export to Excel.
Modular architecture and detailed logging ensure stable 24/7 parsing system operation, and the intuitive interface makes working with the bot simple and convenient
for both performers leaving reviews and administrators creating tasks and controlling publication.
