WhatsApp / WAHA Pro Integration

Critical

WAHA is the WhatsApp HTTP API — not the official Meta Business API. It runs its own session.
Chat ID format: {phoneWithCountryCode}@c.us (e.g., 972501234567@c.us). Never include + or dashes.
Session must be alive — check isSessionAlive() before critical sends. Session name: WAHA_SESSION env var.
Four sessions: internalBoss (WORKING — business notifications/approvals to owner), superseller-whatsapp (WORKING — group agent + webhook receiver), superseller-ops (FAILED), superseller-biz (FAILED).
Group agent integration: superseller-whatsapp session has a webhook pointing to /api/whatsapp/claude/superseller for ClaudeClaw group processing. See claudeclaw-group-agent skill for The Method.
All sends are best-effort — catch errors, log, return null. Never fail a pipeline because WhatsApp is down.
WAHA is used by all products — Studio (WAHA_URL), Lead Pages (WAHA_BASE_URL), FB Bot (config.shared.wahaUrl), Worker/ClaudeClaw (WAHA_BASE_URL). Env var names differ per app.
OTP TTL is 5 minutes, max 3 attempts. Stored in Redis key otp:{phone}.