WhatsApp Bridge Service

Appearance

v3.0.0 (The Admin Era) ​

Release Date: April 11, 2026

The v3.0.0 release transforms the headless API into a fully mature, self-managing enterprise platform. The core focus and biggest addition is the Interactive Admin Dashboard, which allows system administrators to monitor, orchestrate, and manage messages via an elegant web interface.

🚀 Key Features ​

  • Interactive Admin Dashboard: A sleek, mobile-first web interface (/dashboard/) powered by a secure token-based authentication system.
  • Orchestrator Interface: A built-in manual message dispatch tool within the Admin panel that fully supports multimedia (Images, PDFs) and priority flagging.
  • Hardware Telemetry Console: Real-time monitoring of CPU Load, Memory Usage, and Server Uptime directly on the dashboard.
  • Centralized Datewise Logging Engine:
    • Console noise is completely eliminated by default.
    • System events are asynchronously piped into daily logs/bridge-YYYY-MM-DD.log files.
    • Extremely verbose Baileys traces are now safely quarantined in logs/bridge-debug-YYYY-MM-DD.log (only active when .env contains DEBUG=true).
  • Intelligent Queue Manager: Added an SQLite-backed stateful queue for high-volume dispatch. Messages can be throttled or prioritized (is_priority).
  • System Logs Viewer: The Admin panel now includes a real-time log viewer capable of parsing JSONL files, filtering by severity (ERROR, WARN, INFO), and searching historic system telemetry natively in the browser.
  • Remote Maintenance Hub: Trigger system updates (git pull) and process reboots directly from the Admin UI.

🐛 Bug Fixes & Refactoring ​

  • Refactored Router Architecture: Dismantled the monolithic server.js and split API logic into modular Express routers (src/routes/).
  • Silent Drop Resolution: Fixed a critical API dispatch bug where requests missing the type parameter defaulted to a file upload handler, discarding plain text arrays entirely. The system now strictly defaults to type: text if no type is provided but a payload exists.
  • Stability Revert: Rolled back custom Ethereal/Windows browser fingerprints that flagged WhatsApp's anti-bot system. Returned to the official Browsers.macOS footprint for rock-solid stability.

📑 Documentation Updates ​

  • Updated all root documentation to reflect V3 architecture.
  • Added comprehensive documentation for the Logging Engine and Admin Panel configuration.