Skip to main content

​
Onboarding e ativação

O primeiro acesso da Orquena transforma uma conta recém-criada em uma organização pronta para atender clientes. O setup é guiado, possui progresso visual e pode ser retomado depois. A pessoa começa conectando o WhatsApp e continua cadastrando o negócio enquanto contatos e conversas recentes são sincronizados em segundo plano.

​
Primeiro acesso

A autenticação oferece:
  • Continuar com Google.
  • Email e senha.
O mesmo botão do Google serve para cadastro e login. No primeiro acesso, a Orquena cria:
A organização inicia como:
Depois do primeiro passo concluído, passa para SETUP_IN_PROGRESS. Quando todos os requisitos mínimos são atendidos, passa para READY.

​
Boas-vindas

A experiência utiliza o nome recebido no login:
O usuário pode sair e retomar exatamente de onde parou.

​
Progresso visual

A porcentagem é calculada pelo backend a partir de resultados concluídos ou decisões explícitas. Exemplo:
Não existe porcentagem enviada livremente pelo navegador. A API calcula o progresso usando os registros reais da organização.

​
Ordem do setup

A ordem pode permitir retorno a etapas anteriores, mas os critérios finais são validados no servidor.

​
Conectar o WhatsApp primeiro

A conexão começa cedo para que a sincronização aconteça enquanto o proprietário configura o negócio.
Estados mostrados ao usuário:
Depois de conectado:
A conexão deve persistir até que o usuário desconecte, remova o dispositivo no próprio WhatsApp ou a sessão seja invalidada.

​
Escopo da sincronização inicial

A Orquena não promete importar todo o histórico antigo. O MVP busca:
  • Contatos disponibilizados pelo provider.
  • Chats existentes e metadados básicos.
  • Um número limitado de mensagens recentes por conversa.
  • Todas as novas mensagens depois da conexão.
Uma falha parcial na importação não impede o recebimento de novas mensagens quando o canal já está conectado.

​
Dados do negócio

Informações mínimas:
  • Nome do negócio.
  • Segmento.
  • Telefone.
  • Endereço ou indicação de atendimento móvel.
  • Fuso horário.
  • Idioma e região.
  • Moeda.

​
Serviços

Para completar a etapa, deve existir pelo menos um serviço ativo com:
  • Nome.
  • Duração.
  • Preço atual.
  • Moeda.
A IA nunca inventa serviços ou preços que não estejam cadastrados.

​
Profissionais

Para completar a etapa, deve existir pelo menos um profissional ativo e associado a um serviço. O profissional não precisa ter acesso ao dashboard.

​
Horários e regras simples

A etapa reúne:
  • Horário de funcionamento.
  • Dias de atendimento.
  • Jornada dos profissionais.
  • Intervalos.
  • Bloqueios e folgas quando necessários.
  • Antecedência mínima para agendamento.
  • Limite futuro de agendamento.
  • Regra de cancelamento.
  • Confirmação antes de criar o compromisso.
Não existe uma etapa pesada chamada “Políticas” no MVP. As regras necessárias ficam junto da configuração da agenda.

​
Google Calendar

Entrar com Google e conectar o Calendar são autorizações separadas. O proprietário escolhe:
Pular é uma decisão válida e conclui a etapa. A agenda nativa da Orquena continua funcionando. Quando conectado, a primeira direção é:
A Orquena permanece a fonte oficial do agendamento.

​
Escolha da IA

O padrão é sempre:
O proprietário compara os três comportamentos em um simulador antes de escolher:
  • Desligada.
  • Assistente.
  • Automática.
Escolher “Desligada” conclui a etapa. A pessoa não é obrigada a ativar automação para finalizar o setup.

​
Simulador

O simulador utiliza serviços, profissionais e horários já cadastrados. Mensagem de exemplo:
A tela apresenta três experiências:

​
Desligada

Somente a mensagem recebida e o campo para resposta humana.

​
Assistente

Sugestões aparecem acima do campo. Clicar em uma sugestão apenas preenche o texto; nada é enviado automaticamente.

​
Automática

A IA consulta os dados cadastrados e demonstra como responderia e ofereceria horários. O simulador nunca envia uma mensagem real para o WhatsApp.

​
Critérios para ativação

A organização fica READY quando:
  • Dados do negócio estão completos.
  • WhatsApp está conectado.
  • Existe pelo menos um serviço ativo.
  • Existe pelo menos um profissional ativo ligado a um serviço.
  • Horários são válidos.
  • Google Calendar foi conectado ou explicitamente ignorado.
  • Um modo de IA foi escolhido.
  • A simulação foi concluída.
A sincronização histórica pode continuar depois da ativação, desde que o caminho de mensagens novas esteja funcionando.

​
Depois da ativação

Se o WhatsApp desconectar mais tarde:
O setup não é reiniciado. O dashboard mostra a ação necessária para reconectar.

​
Fonte canônica

Os detalhes de entidades, estados, segurança e critérios de aceitação estão no PRD: