Skip to main content

​
Cos’è Switchbord

Switchbord è una piattaforma multi-tenant e self-hostable per le operazioni WhatsApp. Offre ai team operativi una Posta in arrivo pronta per la produzione, un motore di broadcast, un assistente AI e una API REST — costruita sulla WhatsApp Cloud API di Meta e su Supabase.

​
Cosa viene fornito

  • Posta in arrivo per operatori — posta in arrivo a doppia barra laterale con gestione delle conversazioni, contesto sul contatto e aggiornamenti dei messaggi in tempo reale tramite Supabase Realtime
  • Invio di contenuti multimediali avanzati — messaggi in uscita con immagini, video, documenti e audio
  • Messaggi interattivi — risposte a bottoni e messaggi con elenco
  • Motore di broadcast — invii di campagne su un pubblico definito, con avanzamento della consegna in tempo reale
  • Automazione dei percorsi (journey) — flussi di lavoro attivati da eventi, con nodi di ritardo, logica di ramificazione e log di controllo
  • Gestione dei modelli — crea, invia e sincronizza i modelli di messaggio WhatsApp direttamente dall’interfaccia
  • Assistente AI Margaret — bozze di risposta basate su LLM, con pseudonimizzazione dei dati personali prima che qualsiasi prompt raggiunga un provider AI
  • Gestione dei provider LLM — configurazione per area di lavoro per OpenAI, Anthropic, OpenRouter, Ollama e vLLM; le chiavi API sono archiviate in Supabase Vault
  • API REST pubblica — specifica OpenAPI su /spec con l’esploratore interattivo Scalar
  • Multi-tenancy — aree di lavoro completamente isolate con quattro ruoli RBAC: owner, admin, developer, operator
  • Sicurezza — gestione delle sessioni, confronto dei segreti a tempo costante, allowlist CORS, endpoint per i diritti sui dati GDPR, redazione dei dati personali per l’AI, segreti in Supabase Vault, log di audit, header di sicurezza

​
Impostazione architetturale

  • monorepo pnpm + Turborepo
  • superfici app, web e API ospitate su Vercel
  • Supabase-first: Postgres, Auth, Realtime, Vault, Storage
  • worker ospitato su Railway per l’elaborazione in background durevole
  • documentazione Mintlify

​
Per gli operatori

Se stai configurando Switchbord per il tuo team:

​
Per i contributori

Se ti avvicini al repository come contributore OSS:

​
Struttura della documentazione

  • Per iniziare — configurazione e basi del repository
  • Contribuire — guida per i contributori OSS
  • Piattaforma — dettagli su prodotto e architettura
  • Sicurezza — multi-tenancy, autenticazione, GDPR, segreti, conformità
  • Operazioni — gestione del runtime e degli incidenti
  • Riferimento API — contratti HTTP modellati