Skip to content

feat: native WhatsApp Web channel via wa-rs #294

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
qhkm merged 14 commits into from
Mar 10, 2026
Merged

feat: native WhatsApp Web channel via wa-rs #294

Show file tree
Hide file tree
Changes from 5 commits
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
7f17a71
feat(deps): add wa-rs and wa-rs-sqlite-storage behind whatsapp-web fe…
qhkm Mar 10, 2026
5823f30
feat: replace dead WhatsApp bridge channel with whatsapp_web config a…
qhkm Mar 10, 2026
b46f3b2
feat: implement WhatsApp Web channel with wa-rs scaffolding
qhkm Mar 10, 2026
5400726
docs: update CLAUDE.md and README.md for WhatsApp Web native channel
qhkm Mar 10, 2026
7edbd43
fix: address clippy lints in QR renderer
qhkm Mar 10, 2026
b31648a
feat: add QR code terminal rendering and improve onboarding UX
qhkm Mar 10, 2026
a027fad
feat: add channel setup to express onboard and standalone channel set…
qhkm Mar 10, 2026
7a8607c
feat: add WhatsApp Cloud API to channel setup and onboard
qhkm Mar 10, 2026
2605975
fix: make QR code compact with ANSI inverted colors
qhkm Mar 10, 2026
b5fa442
Revert "fix: make QR code compact with ANSI inverted colors"
qhkm Mar 10, 2026
1607098
fix: resolve LID-based sender JIDs to phone numbers for allowlist mat…
qhkm Mar 10, 2026
11fafee
fix(ux): reduce onboarding friction for channel setup
qhkm Mar 10, 2026
ffec543
fix(ci): update quinn-proto to fix security audit, fix test on defaul…
qhkm Mar 10, 2026
486168c
fix: address CodeRabbit review findings
qhkm Mar 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 8 additions & 4 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -249,7 +249,7 @@ src/
│ ├── slack.rs # Slack outbound channel
│ ├── discord.rs # Discord Gateway WebSocket + REST (reply + thread create)
│ ├── webhook.rs # Generic HTTP webhook inbound
│ ├── whatsapp.rs # WhatsApp via whatsmeow-rs bridge (WebSocket)
│ ├── whatsapp_web.rs # WhatsApp Web via wa-rs native (feature: whatsapp-web)
│ ├── whatsapp_cloud.rs # WhatsApp Cloud API (official webhook + REST)
│ ├── lark.rs # Lark/Feishu messaging (WS long-connection)
│ ├── email_channel.rs # Email channel (IMAP IDLE + SMTP)
Expand Down Expand Up @@ -407,8 +407,6 @@ Containerized agent proxy for full request isolation:
- Stdin/stdout IPC with containerized agent
- Semaphore-based concurrency limiting (`max_concurrent` config)
- Mount allowlist validation, docker binary verification
- **Auto-installs channel dependencies** (e.g., whatsmeow-bridge for WhatsApp)
- Dependencies installed at gateway startup via DepManager
- Warn-and-continue on dependency failures (non-blocking)

### Providers (`src/providers/`)
Expand All @@ -433,7 +431,7 @@ Message input channels via `Channel` trait:
- `SlackChannel` - Slack outbound messaging
- `DiscordChannel` - Discord Gateway WebSocket + REST API messaging (replies + thread creation)
- `WebhookChannel` - Generic HTTP POST inbound with optional Bearer auth
- `WhatsAppChannel` - WhatsApp via whatsmeow-rs bridge (WebSocket JSON protocol)
- `WhatsAppWebChannel` - WhatsApp Web via wa-rs native client (QR pairing, feature: whatsapp-web)
- `WhatsAppCloudChannel` - WhatsApp Cloud API (webhook inbound + REST outbound, no bridge)
- `MqttChannel` - MQTT messaging for IoT devices over WiFi/network (rumqttc, feature: mqtt)
- `SerialChannel` - UART serial messaging (line-delimited JSON, feature: hardware)
Expand Down Expand Up @@ -631,12 +629,15 @@ Environment variables override config:
- `ZEPTOCLAW_TOOLS_WEB_SEARCH_PROVIDER` — search provider: "brave", "searxng", "ddg" (default: auto-detect)
- `ZEPTOCLAW_TOOLS_WEB_SEARCH_API_URL` — SearXNG instance URL (required when provider is "searxng")
- `ZEPTOCLAW_TOOLS_CODING_TOOLS` — enable coding-specific tools: grep, find (default: false; auto-enabled by coder template)
- `ZEPTOCLAW_CHANNELS_WHATSAPP_WEB_ENABLED` — enable WhatsApp Web channel (default: false)
- `ZEPTOCLAW_CHANNELS_WHATSAPP_WEB_AUTH_DIR` — session persistence directory (default: ~/.zeptoclaw/state/whatsapp_web)

### Cargo Features

- `android` — Enable Android device control tool via ADB
- `google` — Enable Google Workspace tools (Gmail + Calendar) via gogcli-rs
- `mqtt` — Enable MQTT channel for IoT device communication (rumqttc async client)
- `whatsapp-web` — Enable native WhatsApp Web channel via wa-rs (QR code pairing)
- `memory-bm25` — Enable BM25 keyword scoring for memory search
- `peripheral-esp32` — Enable ESP32 peripheral with I2C + NVS tools (implies `hardware`)
- `peripheral-rpi` — Enable Raspberry Pi GPIO + native I2C tools via rppal (Linux only)
Expand All @@ -647,6 +648,9 @@ Environment variables override config:
```bash
cargo build --release --features android

# Native WhatsApp Web channel
cargo build --release --features whatsapp-web

# Linux sandbox runtimes
cargo build --release --features sandbox-landlock
cargo build --release --features sandbox-firejail
Expand Down
Loading
Loading