Telegram Bookkeeping Bot

A full-featured Telegram group bookkeeping bot supporting multiple currencies, exchange rate management, permission control, and data statistics. Includes a complete backend.

Secure / Stable / Efficient / Reliable

Key Features

• Fast and lightweight; runs on low-spec servers.
• Audit-friendly: all records contain original and edited message info to prevent tampering.
• Interactive feedback: the bot reacts to confirm commands.
• Comprehensive bookkeeping functions including rates, calculator and tagging.

Pricing

• Self-hosted on customer server/domain: one-time 500 USD.
• Hosted service: 50 USD/month.

Main Functions

Basic

• Activate/deactivate bot in the group
• Permission management for operators
• Multi-currency support (20+ currencies)

Bookkeeping

• Quick add: +amount / -amount
• Multiple formats supported: 入款100, 出款100 etc.
• USDT support: append u to amount, e.g. +100u
• Undo by replying to the message and sending 撤销 or 取消

Statistics

• Balance query: 查 or c
• Detailed reports for inflows/outflows/adjustments
• Fee calculation

Settings

• Set rate: 设置汇率7.2
• Set fee: 设置费率0.01
• Set currency: 设置币种JPY
• Set merchant ID: 设置商户号12345

Quick Start

1. Activate the bot: send 激活机器人 or 激活 as admin.
2. Set operator by replying to a user and sending 设置操作人.
3. Configure rate: 设置汇率 7.2.
4. Start bookkeeping using +100 / -100 commands.

Commands

See the original Chinese document for full command list. Common commands include activation, setting rates/fees/currency, undo, query and more.

Deployment

Environment variables:

BOT_TOKEN=your_bot_token
ADMINS=admin1,admin2
PROXY_URI=proxy_uri (optional)

Install dependencies:

pip install -r requirements.txt

Run:

python -m bot
python api_entry.py

Data Security

• Permissions required for sensitive operations
• Soft delete supported
• Operation logs and backups

For support, contact @MrMiHa.