Skip to main content

​
What is Switchbord

Switchbord is a self-hostable, multi-tenant WhatsApp operations platform. It gives operator teams a production-ready inbox, broadcast engine, AI assistant, and REST API — built on Meta’s WhatsApp Cloud API and Supabase.

​
What is shipped

  • Operator inbox — dual-sidebar inbox with conversation management, contact context, and real-time message updates via Supabase Realtime
  • Rich media sends — image, video, document, and audio outbound messages
  • Interactive messages — button replies and list messages
  • Broadcast engine — audience-scoped campaign sends with real-time delivery progress
  • Journey automation — event-triggered workflows with delay nodes, branch logic, and audit trails
  • Template management — build, submit, and sync WhatsApp message templates from the UI
  • Margaret AI assistant — LLM-powered reply drafting with PII pseudonymization before any prompt reaches an AI provider
  • LLM provider management — per-workspace config for OpenAI, Anthropic, OpenRouter, Ollama, and vLLM; API keys stored in Supabase Vault
  • Public REST API — OpenAPI spec at /spec with interactive Scalar explorer
  • Multi-tenancy — fully isolated workspaces with four RBAC roles: owner, admin, developer, operator
  • Security — session management, timing-safe secret comparison, CORS allowlist, GDPR data rights endpoints, PII redaction for AI, Supabase Vault secrets, audit logging, security headers

​
Design posture

  • pnpm + Turborepo monorepo
  • Vercel-hosted app, web, and API surfaces
  • Supabase-first: Postgres, Auth, Realtime, Vault, Storage
  • Railway-hosted worker for durable background processing
  • Mintlify docs

​
For operators

If you are setting up Switchbord for your team:

​
For contributors

If you are approaching the repo as an OSS contributor:

​
Documentation shape

  • Get Started — setup and repo basics
  • Contributing — OSS-facing contributor guidance
  • Platform — product and architecture detail
  • Security — multi-tenancy, authentication, GDPR, secrets, compliance
  • Operations — runtime and incident handling
  • API Reference — modeled HTTP contracts