Skip to main content

O que é o Switchbord

O Switchbord é uma plataforma multi-tenant de operações de WhatsApp, auto-hospedável. Ele oferece às equipes de operação uma caixa de entrada pronta para produção, um mecanismo de disparos em massa, um assistente de IA e uma API REST — construídos sobre a WhatsApp Cloud API da Meta e o Supabase.

O que já está disponível

  • Caixa de entrada do operador — inbox com barra lateral dupla, gerenciamento de conversas, contexto de contato e atualizações de mensagens em tempo real via Supabase Realtime
  • Envio de mídia rica — mensagens de saída com imagem, vídeo, documento e áudio
  • Mensagens interativas — respostas por botão e mensagens de lista
  • Mecanismo de disparos em massa — envios de campanha segmentados por audiência, com progresso de entrega em tempo real
  • Automação de jornadas — workflows disparados por eventos, com nós de espera, lógica de ramificação e trilhas de auditoria
  • Gerenciamento de templates — crie, envie para aprovação e sincronize templates de mensagem do WhatsApp a partir da interface
  • Assistente de IA Margaret — redação de respostas com apoio de LLM, com pseudonimização de PII antes que qualquer prompt chegue a um provedor de IA
  • Gerenciamento de provedores de LLM — configuração por workspace para OpenAI, Anthropic, OpenRouter, Ollama e vLLM; chaves de API armazenadas no Supabase Vault
  • API REST pública — especificação OpenAPI em /spec, com explorador interativo Scalar
  • Multi-tenancy — workspaces totalmente isolados, com quatro papéis de RBAC: owner, admin, developer, operator
  • Segurança — gerenciamento de sessão, comparação de segredos em tempo constante, allowlist de CORS, endpoints de direitos de dados da LGPD/GDPR, redação de PII para IA, segredos no Supabase Vault, registro de auditoria, cabeçalhos de segurança

Postura de design

  • Monorepo pnpm + Turborepo
  • Superfícies app, web e API hospedadas na Vercel
  • Supabase-first: Postgres, Auth, Realtime, Vault, Storage
  • Worker hospedado na Railway para processamento em segundo plano durável
  • Documentação com Mintlify

Para operadores

Se você está configurando o Switchbord para a sua equipe:

Para contribuidores

Se você está chegando ao repositório como um contribuidor open source:

Estrutura da documentação

  • Primeiros passos — configuração e fundamentos do repositório
  • Como contribuir — orientação para contribuidores open source
  • Plataforma — detalhes de produto e arquitetura
  • Segurança — multi-tenancy, autenticação, LGPD/GDPR, segredos, compliance
  • Operações — execução em runtime e tratamento de incidentes
  • Referência de API — contratos HTTP modelados