Skip to main content

​
Usuários, clientes e organizações

A plataforma diferencia quem opera o produto, quem contrata e administra tenants, quem trabalha em uma loja e quem apenas conversa com essa loja pelo WhatsApp.

​
Classes de ator

​
Operador da plataforma

Administra suporte, cobrança, segurança e operação técnica. Esse acesso não transforma o operador em membro dos tenants dos clientes.

​
Membro da conta comercial

Possui login e administra assinatura, billing e limite de organizações. Os papéis iniciais são:
  • ACCOUNT_OWNER
  • ACCOUNT_BILLING_ADMIN
Ser dono da conta não libera automaticamente contatos, conversas ou agenda de todos os tenants.

​
Membro da organização

Possui login e atua dentro de uma loja tenant. Exemplos:
  • Proprietário da loja.
  • Administrador.
  • Gerente.
  • Atendente.
  • Profissional.
  • Usuário somente leitura.
Um mesmo usuário pode participar de várias organizações, sempre com memberships e permissões independentes.

​
Cliente externo

É o cliente da barbearia, salão ou prestador de serviço. Ele continua usando o próprio WhatsApp para conversar com o número comercial da loja. Pode perguntar preços, consultar horários, agendar, reagendar, cancelar ou pedir atendimento humano. O cliente externo:
  • Não recebe login.
  • Não possui conta no painel.
  • Não acessa a plataforma diretamente.
  • É representado internamente como um Contact pertencente ao tenant.

​
Conta, grupo e tenant

​
CustomerAccount

Agrupa assinatura, cobrança e entitlement para criar organizações.

​
OrganizationGroup

Serve para organizar e filtrar tenants de uma mesma marca ou categoria. Não compartilha dados e não concede acesso.

​
Organization

É o tenant, a loja e a unidade comercial futura de cobrança. Cada organização possui seus próprios:
  • WhatsApp Business.
  • Contatos.
  • Inbox e conversas.
  • Serviços e preços.
  • Profissionais e escalas.
  • Agenda.
  • Agente de IA.
  • Plugins e credenciais.
Uma rede com três lojas utiliza três organizações, mesmo que todas pertençam à mesma conta e marca.

​
Profissional não é necessariamente usuário

Um profissional pode existir no calendário sem possuir login. O proprietário consegue cadastrar funcionários, serviços, horários de trabalho, intervalos e folgas mesmo quando esses profissionais nunca acessam o painel. Quando um profissional precisar acessar o sistema, seu registro poderá ser vinculado a um User.

​
Papéis da organização

  • OWNER
  • ADMIN
  • MANAGER
  • ATTENDANT
  • PROFESSIONAL
  • VIEWER
Os papéis são conjuntos de permissões. O backend valida membership, permissão, escopo e ownership em todas as operações protegidas.

​
Isolamento

A organização selecionada no navegador serve apenas para navegação. Cada requisição, evento, webhook e job valida novamente o tenant. Uma organização não acessa contatos ou agendas de outra organização, mesmo quando ambas pertencem à mesma conta ou grupo.