WhatsApp Bridge Service

Appearance

Admin Panel Command Center ​

The WhatsApp Bridge Admin Panel is a lightweight, mobile-first command center designed for real-time monitoring, message orchestration, and data management.

🔐 Accessing the Panel ​

  1. URL: Navigate to http://your-server-ip:3001/dashboard/.
  2. MFA Login:
    • Enter your API_KEY (configured in .env).
    • The bridge will send a 6-digit dynamic OTP to your linked WhatsApp account.
    • Enter the code to receive your temporary session token.

📊 System Monitoring ​

The header provides real-time "telemetry" for your instance:

  • Connectivity: Pulse icon indicating if the WhatsApp socket is active.
  • Uptime: How long the Node.js process has been running.
  • CPU/RAM: Visual bars indicating hardware utilization (critical for Raspberry Pi class hardware).

🚀 The Orchestrator ​

The Orchestrator allows you to manually dispatch messages without writing a single line of code.

Delivery Modes ​

  • Direct Dispatch: The message is fired immediately (with a 1s safety buffer). Best for MFA or priority alerts.
  • Throttled Queue: The message is placed in the SQLite database and sent according to the global human-pacing logic. Best for bulk notifications.

Supported Payloads ​

  • Text: Supports WhatsApp Markdown (*bold*, _italics_).
  • Media: Upload Images or Documents (PDF/Doc) directly from your device.

📁 Data Management ​

1. System Logs ​

Browse the file-based logs generated by the Pino engine.

  • Filtering: View individual info, warn, or error streams.
  • Purging: Use the "Purge Log" button to permanently delete historical logs and free up disk space.

2. Activity Pulse (Audit) ​

A detailed forensic view of every message processed by the bridge.

  • Status Tracking: Track messages from Queued → Sent → Delivered → Read.
  • Destruction: Click on any record to view metadata and use the "DESTROY PERMANENTLY" button to shred the record from the audit database.

🛠️ Remote Maintenance ​

Located in the "Security" tab, these tools allow you to manage the server remotely:

  • Git Sync: Triggers a git pull origin master on the server and reports the output.
  • Soft Reboot: Safely restarts the Node.js process (useful for applying .env changes).
  • Session Reset: Logs out of WhatsApp and clears the auth/ directory.

IMPORTANT

Persistent Sessions: Accessing the Admin Panel creates a persistent session in your browser valid for 30 days. You will not need to re-verify OTP unless you clear your cookies or the server is migrated.