📡
WHATSAPP BRIDGE
The Gateway — Go Service on Port 8080
Every WhatsApp message enters and leaves through this bridge. Written in Go, it connects to WhatsApp servers, stores messages in SQLite, and provides a REST API for all agents.
A Real Conversation
A message arrives on WhatsApp — trace how the Bridge handles it
💬
WhatsApp
Meta Servers
encrypted E2E
message
📡
BRIDGE
Go binary — port 8080
REST API + WebSocket
stores → messages.db
media → /tmp/whatsapp/
QR auth → :9090
polls every 2s
🏛️
ZION
reads messages.db
WebSocket :8765
🔺
TRINITY
@trinity messages
POST /api/send
SEND API
/api/send {recipient, msg}
/api/download {media}
← reply delivered to WhatsApp
☁️ Oracle Cloud VM — 80.225.205.232
Inside The Bridge
What the Go binary actually does — every component
📡
BRIDGE
Go • port 8080
WA CONNECTION
🔐 QR Code Auth
📱 Whatsmeow lib
🔄 Auto-reconnect
scan at :9090
REST API
📤 /api/send
📥 /api/download
📊 /api/status
🖼️ /api/media
JSON in, JSON out
MEDIA
📷 Images — auto DL
🎤 Voice — .ogg files
📹 Video — .mp4
📄 Documents
saved to /tmp/whatsapp/
STORAGE
💾 messages.db
📋 all chats indexed
🔍 Zion polls this
SQLite — fast lookups
CONSUMERS
🏛️ Zion — polls 2s
🔺 Trinity — WebSocket
📧 Morpheus — email
🕵️ Anderson — alerts
all agents use bridge
RELIABILITY
⚙️ systemd service
🔄 cron restart 5 min
🩺 Anderson monitors
📡 TCP :8080 check
99.9% uptime target
Tech Stack
Language Go (compiled binary)
Library Whatsmeow — multi-device WA protocol
Port 8080 (REST API) + 9090 (QR scan UI)
Database SQLite — messages.db (all incoming messages)
Media /tmp/whatsapp/ — auto-downloaded files
Service whatsapp-bridge.service (systemd)
Monitor Anderson health.py checks every 5 min
Cost $0 — open source, self-hosted