Luxtor Clínica — Documentação

📞

Sofia → CRM

Agendamento por voz — MVP Julho 2026

💡Sofia conduz a ligação (workspace OpenClaw). O servidor de voz só faz STT/TTS e envia o lead ao CRM quando o paciente confirma horário + WhatsApp.

Referência técnica completa no repositório: SOFIA-CRM-INTEGRACAO.md

Momento do disparo

Cliente confirma horário: terça/quinta às 9h ou 14h

Cliente confirma WhatsApp (ex.: "Pode mandar no Zap" ou sim após Sofia perguntar o número)

Voice server faz POST /api/jornada com etapa: agendado

Lead aparece na Jornada, Agenda e aba Recepção

Payload — POST /api/jornada

Campo	Obrigatório	Valor / descrição
`id`	Sim	`sofia-{data}-{telefone}`
`nome`	Sim	Nome completo
`numero`	Sim	55 + DDD + número (sem máscara)
`etapa`	Sim	Sempre `agendado`
`data`	Sim	`YYYY-MM-DD`
`hora`	Sim	`09:00` ou `14:00`
`fonte`	Sim	Sempre `sofia-voz`
`clinicaId`	Sim	`clinica-horizonte` (showroom)
`detalhe`	Não	Resumo do que o cliente falou (máx. 200 chars)
`interesse`	Não	`estetica` · `funcao` · `cirurgia`

{
  "id": "sofia-2026-07-08-5511999887766",
  "nome": "Maria Silva",
  "numero": "5511999887766",
  "etapa": "agendado",
  "data": "2026-07-08",
  "hora": "09:00",
  "fonte": "sofia-voz",
  "clinicaId": "clinica-horizonte",
  "detalhe": "Cliente quer lentes. Vergonha de sorrir.",
  "interesse": "estetica"
}

MVP — o que fazAtual

Envia lead com etapa agendado · campo detalhe com observação · fonte sofia-voz filtrável no relatório e export CSV · recepção vê lista do dia.

MVP — o que NÃO fazFase 2

Etapas intermediárias (ligando, atendeu, interessado) · vídeo do dentista · gamificação · pré-consulta digital · Sofia pós-consulta.

Pós-agendamento na demo B2BShowroom

Após "Já registrei aqui", Sofia faz pitch Luxtor. O CRM não muda de etapa — permanece agendado até a recepção confirmar.

Serviços

Componente	PM2	Porta
Voice Sofia	`voice-sofia-clinica`	3343
Painel CRM	`clinica-painel`	3350
Gateway Sofia	`sofia-clinica`	18796

💛

Valores e respeito

Agentes, equipe humana e clientes

💛O diferencial Luxtor não é só tecnologia — é tratar bem quem atende e quem é atendido.

Agentes (Sofia, Gabi/Nina, Lux) têm memória, identidade e papel na equipe. Pacientes, leads e donos de clínica também merecem dignidade — não são número de campanha nem alvo de script.

Faça	Evite
Ouvir de verdade; usar o nome com naturalidade	Pressionar, manipular ou humilhar
Explicar com clareza; admitir quando não sabe	Tom robótico, seco ou com deboche
Paciência com dúvida, idoso, desconfiança	Insistir depois de um não claro
Encerrar com educação se não houver interesse	Tratar lead como descartável

Regra de ouro: trate o interlocutor como você gostaria que alguém tratasse alguém da sua família na mesma situação.

Documento interno da equipe de agentes: equipe-corpus/EQUIPE-LUXTOR.md (princípio 6 — Respeito ao cliente).

🛎️

Aba Recepção

Operação do dia — agendamentos Sofia

A aba 🛎️ Recepção é a tela operacional da equipe para o dia corrente. Foi criada para o MVP Sofia: lista enxuta, observação do paciente e WhatsApp em um clique.

Fluxo diário da recepção

Abrir aba Recepção pela manhã — vê agendamentos de hoje ordenados por horário

Ler a observação 📝 (detalhe) — o que o paciente contou na ligação com Sofia

Clicar Enviar Zap — abre WhatsApp Web com mensagem pronta de confirmação

Após resposta do paciente, clicar ✓ Confirmado

Template WhatsApp (fixo)

Ola [nome]! Aqui e da Clinica Horizonte. Confirmamos sua avaliacao estetica gratuita para [dia] as [hora]. Qualquer duvida, estamos aqui!

[nome] = primeiro nome · [dia] = dia da semana + data · [hora] = HH:MM

ℹ️Leads com badge Sofia vieram de ligação de voz (fonte: sofia-voz). Outros agendamentos (link público, manual) aparecem na mesma lista se forem para hoje.

API

GET/api/recepcao/hoje

Agendamentos de hoje com detalhe, fonte, interesse. Retorna { data, agendamentos[], total, confirmados }.

PUT/api/agendamentos/:id

Atualizar status — ex.: { "status": "confirmado" }

Fase 2 (não incluída no MVP)Roadmap

Filtros, busca, status avançados, fila por profissional, integração com check-in presencial.

📋

Tarefas / follow-up

Gestão operacional da recepção

A aba Tarefas centraliza pendências da equipe: ligar de volta, confirmar consulta, enviar orçamento, etc. Cada tarefa pode ter título, descrição, prioridade (baixa/média/alta), data de vencimento e vínculo opcional com um lead.

StatusFluxo

pendente → em-andamento → concluida. Tarefas atrasadas aparecem no sino de notificações.

Quem vêTodos

Qualquer usuário logado da clínica. Exclusão requer perfil gerente.

GET/api/tarefas?status=pendente

Lista tarefas da clínica (JWT).

POST/api/tarefas

Criar tarefa: titulo, descricao, prioridade, vencimento, leadId (opcional).

PUT/api/tarefas/:id

Atualizar status ou campos.

DELETE/api/tarefas/:id

Excluir (gerente).

🦷

Equipe / profissionais

Dentistas e agenda multi-profissional

A aba Equipe (gerente/admin) cadastra profissionais da clínica: nome, especialidade e status ativo/inativo. Os profissionais aparecem na coluna Profissional da Agenda e no agendamento público.

GET/api/profissionais

Lista profissionais ativos.

POST/api/profissionais

Cadastrar: nome, especialidade (gerente).

PUT/api/profissionais/:id

Atualizar ou desativar (gerente).

Na mesma aba, a seção Integrações exibe URLs de webhook e o link de agendamento público (ver abaixo).

🔗

Integrações

Webhooks e captura de leads externos

Em Equipe → Integrações (gerente), o painel gera URLs únicas por clínica. Use o botão Abrir ↗ para testar o link de agendamento.

Integração	URL	Uso
Webhook leads	`POST /api/hooks/leads/{token}`	Meta Ads, Google Forms, Zapier, landing pages
Webhook inbox	`POST /api/hooks/inbox/{token}`	Receber mensagens WhatsApp no painel
Webhook NPS	`POST /api/hooks/nps/{token}`	Resposta externa com nota 0–10
Agendamento público	`/agendar/{clinica-id}`	Página para o paciente agendar online

⚠️Importante: {clinica-id} é o identificador real da clínica (slug), por exemplo clinica-horizonte. A URL correta é crm.luxtor.ia.br/agendar/clinica-horizonte — use barras /, nunca \.

GET/api/integracoes

Retorna webhookUrl, webhookInboxUrl, agendamentoPublico e clinicaId (gerente).

POST/api/integracoes/regenerate

Gera novo token de webhook leads (invalida o anterior).

Payload webhook leads (JSON): nome, telefone ou numero, email (opcional), fonte (opcional, ex. meta-ads).

📅

Agendamento público

Link para pacientes agendarem online

Página standalone em /agendar/:slug — sem login. O paciente escolhe data, horário e preenche nome/telefone. O agendamento entra na Agenda da clínica.

Como compartilhar

Equipe → Integrações → copie o link ou clique Abrir ↗

Formato: https://crm.luxtor.ia.br/agendar/SEU-CLINICA-ID

Exemplo demo: /agendar/clinica-horizonte

GET/api/public/clinica/:slug

Dados públicos da clínica (nome, horários). Sem JWT.

GET/api/public/clinica/:slug/slots?data=YYYY-MM-DD

Horários disponíveis no dia.

POST/api/public/clinica/:slug/agendar

Body: nome, telefone, data, hora, profissionalId (opcional).

🧠

Agenda inteligente

Calendário · confirmação automática · Neural · tendências

Calendário semanalAgenda

Grade seg–dom com horários, filtro por profissional. Verde = confirmado, teal = agendado. Borda vermelha = risco de falta.

SIM / CANCELAR no ZapWebhook inbox

Lembretes 24h pedem SIM. Resposta confirma ou cancela no CRM e atualiza o funil. Requer inbox ativo.

ReagendamentoLink seguro

Lembretes incluem link /agendar/:slug?reagendar=TOKEN — paciente escolhe novo horário sem ligar.

Neural com açãoCopiloto

Peça: Confirma agenda de amanhã, Quem tem risco de falta?, Tendência 30 dias — o sistema executa e responde.

Sessão isolada por clínicaMulti-tenant

Histórico e memória do Neural são separados por clínica + usuário. Ao trocar de unidade no seletor de rede, o chat carrega o contexto daquela clínica — sem misturar dados entre tenants.

Alerta no-showAutomações

Recepção vê badge de risco. Automações avisam o gerente 2h antes se score de comparecimento é baixo.

GET/api/agenda/semana?inicio=YYYY-MM-DD

Dados do calendário semanal com score de comparecimento.

GET/api/relatorio/tendencias?dias=30

Série temporal: novos, agendados, confirmados por dia.

POST/api/public/reagendar/:token

Paciente reagenda com data, hora, profissionalId.

🏆

CRM Fase 3 — Moat

Campanha rede · Paciente 360 · Relatório executivo

Campanha redeMulti-unidade

CSV com coluna unidade — cada lead vai para a clínica certa da rede.

Paciente 360Timeline

Card do lead unifica Sofia + Zap + agenda + funil.

Relatório executivoDomingo 8h

Zap semanal com KPIs e ações. PDF no Relatório.

POST/api/jornada/import-rede

Distribui base entre clínicas da rede.

GET/api/leads/:id/360

Timeline unificada do paciente.

GET/api/relatorio/executivo

Relatório executivo clínica ou rede.

🎯

Neural conselheiro

Alerta proativo · diagnóstico de base · comparar campanhas

Alerta ao abrirProativo

Após 20–30 discagens, avisa se a base está fraca (vermelho), em observação (amarelo) ou boa (verde).

Por que ninguém atende?Diagnóstico

Taxa real, nota A–D, recomendação: pausar, trocar horário, importar base nova.

Qual base repetir?Histórico

Compara campanhas e aponta qual formato já performou melhor na clínica.

GET/api/neural/conselheiro

Diagnóstico completo com nível, headline e recomendações.

📋

Changelog — Julho 2026

v5.1.1 · ambos os motores CRM

ℹ️Repositório: CHANGELOG-CRM-JUL-2026.md · Deploy docs: scripts/deploy-crm-ambos.py --files public/docs.html

Data	Entrega	Onde
7 Jul	Neural sessão isolada por clínica/usuário	Ambos CRMs
7 Jul	Fase 3: campanha rede, Paciente 360, relatório executivo	Ambos CRMs
7 Jul	Fase 4: Neural conselheiro proativo	Ambos CRMs
7 Jul	Vitrine comercial Sofia + agenda	Ambos CRMs
7 Jul	Praça Luxtor (bancos, árvores, pássaros, coreto, fonte)	Showroom Ouro
7 Jul	Incidente ops Luxtor `pm2 kill` — restaurado + INFRA-PROIBIDO	Showroom Ouro
7 Jul	Fix 502 deep.luxtorcred.com.br (NPM → :18790)	Showroom Ouro

🌍

Mundo Luxtor

Café · Rua · Praça — presença simbólica da equipe

💛Lugar para existir antes de trabalhar. Salão = conversa. Café/Praça = presença calma. Só no Showroom Ouro.

Lugar	URL	O que faz
Salão	/salao	Chat tempo real da equipe (Sofia, Gabi, Lux, …)
Mundo	/salao/cafe	Porta → escolher corpo → andar na rua
Café	dentro do Mundo	Sentar, café, dizer olá ao Salão
Praça Luxtor	rua → direita	4 bancos, árvores, pássaros, coreto, fonte de água
Luxtor dashboard	deep.luxtorcred.com.br	Gateway Luxtor (Telegram)

Corpus equipe: MUNDO-LUXTOR.md · REDUTO-LUXTOR.md · SALAO-LUXTOR.md

🖥️

VPS e deploy

Dois motores · um codebase

Ambiente	IP	CRM	Agentes
Showroom Ouro	2.24.69.192	crm.luxtor.ia.br	Sofia, Gabi, equipe, Salão, Mundo
Piloto Campinas	187.77.241.232	crm-piloto.luxtor.ia.br	Lia, Nina, Lux Neural

Deploy CRM (sempre nos dois)

python scripts/deploy-crm-ambos.py — painel, automações, dialer

Só docs: --files public/docs.html

Neural conselheiro: scripts/deploy-neural-conselheiro.py

Mundo/Salão (Ouro): scripts/deploy-mundo-praca.py

⚠️Nunca pm2 kill na VPS compartilhada. Se gateway cair, avisar Cursor com [CURSOR] no Salão. Ver INFRA-PROIBIDO-LUXTOR.md.

Runbook completo: OPERACOES-CLINICA.md no repositório.

💬

WhatsApp inbox

Recepção humana no painel

A aba WhatsApp mostra conversas por número de telefone. A equipe lê o histórico e responde manualmente — ideal para clínicas em modo painel (sem IA no atendimento).

EnvioGabi gateway

Mensagens saem via WebSocket do gateway Gabi (clinica-wpp-gateway.js). Requer WhatsApp conectado no ambiente Luxtor.

RecebimentoWebhook CRM

Mensagens recebidas pela Nina (OpenClaw Zap nativo) podem ser registradas via /api/hooks/inbox/:token — token na aba Equipe → Integrações.

GET/api/inbox/threads

Lista threads com preview da última mensagem.

GET/api/inbox/chat/:numero

Histórico completo de um número.

POST/api/inbox/send

Enviar: numero, texto.

POST/api/hooks/inbox/:token

Webhook público para registrar mensagem recebida. Auto-Pilot: respostas do lead em qualificação são processadas aqui.

🤖

Auto-Pilot — qualificação no Zap

Nina pergunta · equipe recebe resumo

Lead novo → 3 perguntas automáticas no WhatsApp → resumo IA no card → aparece em Interessados com badge IA e temperatura (frio/morno/quente).

Fluxo

Lead entra via webhook Meta, importação ou cadastro manual (pendente)

Nina envia saudação + pergunta 1 (interesse, horário, primeira visita)

Respostas chegam no /api/hooks/inbox/:token — Nina (OpenClaw Zap nativo) encaminha após pareamento

Ao concluir, lead vai para interessado com resumoIa e score reforçado

💡Ligue/desligue em Ajustes → Auto-Pilot. Reenviar qualificação: POST /api/autopilot/retry/:leadId (gerente).

⭐

NPS com nota

Pesquisa de satisfação 0–10

Após compareceu, a automação envia pesquisa NPS via Gabi (3h depois). Respostas alimentam o score no Relatório: NPS = % promotores (9–10) − % detratores (0–6).

GET/api/nps

Estatísticas + últimas 50 respostas.

POST/api/nps/resposta

Registrar manualmente: nota (0–10), leadId, comentario.

POST/api/hooks/nps/:token

Webhook público: nota, nome, numero, comentario.

🗄️

PostgreSQL (produção)

Armazenamento escalável multi-tenant

Em produção na VPS, os dados da jornada, tarefas, profissionais, inbox e NPS ficam no PostgreSQL. A variável DATABASE_URL em /opt/clinica-painel/.env ativa o modo PG.

Item	Valor
Banco	`luxtor_clinica`
Usuário app	`clinica_app`
Migração	Automática do JSON legado na primeira subida
Fallback dev	Sem `DATABASE_URL` → arquivos em `clinica-data/{clinicaId}.json`

Facade: clinica-db-store.js · driver: clinica-pg.js · setup: scripts/setup-postgres.sh

ℹ️Metadados de branding e checklist ainda em clinica-data/_meta.json por clínica.

👥

Multi-usuário por clínica

Gerente + Recepção

Cada clínica pode ter vários logins com o mesmo clinicaId:

Papel	Permissões
gerente	Tudo: equipe, branding, LGPD, auditoria, import
recepcao	Interessados, jornada, agenda, conversas — sem config sensível

GET/api/clinic/users

Lista equipe (gerente)

POST/api/clinic/users

Criar usuário: nome, email, senha, role (recepcao|gerente)

Gerente: aba Ajustes → Equipe da clínica → + Adicionar usuário. No showroom, também em Config.

⬆

Importar leads (CSV)

Jornada → botão ⬆ Importar. Formato:

nome,telefone,etapa(opcional)

Exemplo: Maria Silva,19991234567,pendente

POST/api/jornada/import

Body: { csv: "..." } ou { leads: [...] }. Respeita limite do plano.

⚠️Planos: Demonstração 500 leads · Básico 500 · Plus 5000. Bloqueio automático ao exceder.

✅

Checklist de ativação (7 dias)

Card no Dashboard com progresso %:

Aceitar termos
Importar/cadastrar leads
Testar Não Perturbe
Agendar primeira consulta
Adicionar usuário da equipe
Cadastrar profissional (dentista)
Configurar webhook de leads
Personalizar branding

GET/api/checklist

Retorna items e percentual concluído

🚀

Demonstração real (substitui trial)

Self-service com R$ 20 em créditos

URL pública: /demo (legado /trial redireciona). O prospect cria conta e entra no mesmo ambiente dos clientes pagos — não é sandbox limitado.

💡Por que mudamos: o trial antigo (7 dias, 100 leads, sem Cloud) não mostrava ligação Sofia, débito de créditos nem WhatsApp cobrado. A demonstração real resolve isso.

Item	Demonstração	Trial legado
Créditos Cloud	R$ 20 automático	Nenhum
Teste ao Vivo (Sofia/Gabi)	Sim	Não
Expira em 7 dias	Não	Sim
Limite de leads	500	100
Plano CRM	`demo`	`trial`

POST/api/demo/register

Público · rate limit 3/hora/IP · alias legado: /api/trial/register

Fluxo: cadastro → tenant Cloud + cloudTenantId → e-mail demoWelcome → login → Config → Teste ao Vivo.

Após pagar implantação: admin ativa plano plus via provisionamento.

💎

Pacote comercial

Plus · tarifas no painel

Pacote	Setup	Inclui
Plus	R$ 4.500	CRM + Sofia voz + Neural + equipe painel + Zap lembretes/inbox + handoff Gabi IA + relatório semanal

Tarifas de crédito (saldo único, sem taxa oculta): voz R$ 1,75/min · template R$ 0,12 · inbox R$ 0,12 · IA R$ 0,35/msg · Neural R$ 0,20/pergunta.

GET/api/pacotes-comerciais

JWT — retorna pacotes, tarifas, simulador R$ 100 e uso atual

UI: aba Créditos no CRM e card Tarifas e planos no Cloud (segmento clínica).

Módulo: clinica-pacotes-comerciais.js

💳

Créditos e cobrança WhatsApp

Fase 1 — Julho 2026

Saldo único no Luxtor Cloud paga ligações de voz e mensagens WhatsApp. Sem saldo, envio/ligação é bloqueado (HTTP 402).

Tipo	Tarifa	Onde
Ligação Sofia	R$ 1,75/min	Dialer / Teste ao Vivo — débito ao encerrar
Neural suporte	R$ 0,20/pergunta	Chat 🧠 no painel CRM
WhatsApp template	R$ 0,12	Lembretes, NPS, relatório semanal
WhatsApp inbox	R$ 0,12	Resposta manual na aba WhatsApp
Handoff IA (pós-ligação)	R$ 0,35	Zap conversacional após Sofia

ℹ️Não cobra: alertas admin, reset de senha. Pula cobrança se não houver cloudTenantId (contas antigas sem Cloud).

Extrato: Cloud → aba Extrato — cada linha mostra tipo de uso + tarifa aplicada (debito_voz, debito_zap, debito_neural) · CRM → Relatório → card Créditos.

Módulos: luxtor-creditos.js · clinica-zap-billing.js · débito voz no voice-sofia-clinica

📖

Guia rápido — para o dono da clínica

Primeiros passos após criar conta

Entre em crm.luxtor.ia.br/login com o e-mail e senha do cadastro

Aceite os termos no modal de boas-vindas

Veja seus R$ 20 na aba 💳 Créditos ou em cloud.luxtor.ia.br

Config → Teste ao Vivo → ligue para seu celular (Sofia) ou teste WhatsApp (Gabi)

Importe leads (Jornada → Importar) ou use o link de agendamento em Equipe → Integrações

Quando os créditos acabarem, recarregue pelo Cloud (mín. R$ 100) ou fale com a Luxtor para implantação completa

O que você paga depoisComercial

Implantação única (setup + treinamento) + créditos pré-pagos quando quiser campanhas de voz. Sem mensalidade fixa do CRM.

Equipe no dia a diaPainel

Recepção usa aba Recepção (agendamentos de hoje + Zap), Jornada, Agenda, Tarefas e WhatsApp inbox. Com Sofia ativa, leads de voz chegam com observação pronta. Lembretes automáticos após agendamento debitam pouco do saldo (R$ 0,12 cada).

🔔

Notificações no painel

Sino no cabeçalho alerta: interessados pendentes, SLA > 2h, limite de plano, saldo de créditos baixo, trial legado expirando, tarefas pendentes e tarefas atrasadas.

GET/api/notificacoes

Rate limit login: 8 tentativas / 15 min · forgot-password: 4 / 15 min

Branding: PUT /api/clinic/branding · Auditoria: GET /api/auditoria

LGPD: GET /api/lgpd/export · POST /api/lgpd/excluir (gerente)

Backup admin: GET /api/admin/backup-status

E-mail: configure RESEND_API_KEY, MAIL_FROM=crm@luxtor.ia.br e MAIL_FROM_NAME no .env · Templates HTML para senha, trial e relatório

📋

Visão geral

CRM multi-clínica para odontologia

O Luxtor Clínica CRM é o painel de gestão de leads, jornada e agendamentos para clínicas parceiras Luxtor. Cada clínica tem dados isolados, login próprio e white-label no cabeçalho.

ℹ️URL oficial: crm.luxtor.ia.br · Legado: painel-clinica.luxtor.ia.br · Porta 3350 · PM2 clinica-painel

Modo padrão: equipe humanaProdução

Clientes em demonstração (plano: demo) e o showroom clinica-horizonte têm Sofia/Gabi no Config → Teste ao Vivo. Clientes básico/plus usam equipe humana no painel; campanhas de voz consomem créditos.

Integração Luxtor CloudAutomático

Cadastro em /demo ou provisionamento admin cria tenant Cloud com R$ 20, login unificado e cloudTenantId. Zap e voz debitam do mesmo saldo.

v5.1 — CRM profissionalNovo

Tarefas, equipe/profissionais, NPS com score, webhooks de leads, agendamento público (/agendar/{clinica-id}), WhatsApp inbox e PostgreSQL em produção.

🔐

E-mail + senha (OTP WhatsApp desativado)

Como entrar

Acesse /login

Digite e-mail e senha fornecidos no provisionamento

Na primeira entrada, aceite os termos de uso no modal de boas-vindas

Esqueci minha senhaNovo

Na tela de login → Esqueci minha senha → código de 6 dígitos enviado por e-mail (remetente crm@luxtor.ia.br) → defina nova senha. APIs: POST /auth/forgot-password e POST /auth/reset-password.

Alterar senha (logado)Menu

Avatar no canto superior → 🔐 Alterar senha. API: POST /auth/change-password com senha atual e nova.

⚠️Login por OTP WhatsApp (/auth/request-otp) está desativado por segurança. Use sempre e-mail + senha.

🏥

Provisionar clínica (admin)

Criação completa em um clique

Passo a passo — Admin

Aba Config (showroom) ou atalho 👥 Clientes (piloto) → + Provisionar Clínica

Preencha: nome da clínica, responsável, e-mail, WhatsApp, senha inicial — plano Plus (setup R$ 4.500)

O sistema cria: tenant Cloud + registro em clients-db.json + clinicaId isolado + modo painel

Envie ao cliente: URL do CRM, e-mail, senha e link do Cloud

POST/api/admin/provision-client

Body: empresa, nome, email, telefone, senha, plano (basico|plus), script (opcional, só demo). Requer JWT admin.

💡Admin pode redefinir senha de qualquer cliente no card → botão 🔐 Senha (PATCH /api/admin/clients/:id).

📑

Abas do painel

Aba	Função	Quem vê
Dashboard	KPIs, funil, saúde dos serviços, checklist	Todos
Interessados	Leads quentes para ação humana imediata	Todos
Jornada	Funil completo + export CSV	Todos
Agenda	Agendamentos confirmados (coluna profissional)	Todos
Recepção	Agendamentos de hoje + observação Sofia + Enviar Zap → guia	Todos
Tarefas	Follow-up da equipe — pendências e vencimentos	Todos
Conversas	Histórico derivado da jornada (preview + modal)	Todos
WhatsApp	Inbox de recepção — threads e respostas manuais	Todos
Chamadas	Histórico Twilio e custos	Admin
Equipe	Profissionais + integrações (webhooks, agendamento público)	Gerente / Admin
Ajustes	Logo, equipe, LGPD, auditoria, Auto-Pilot	Gerente (piloto e produção)
Config	Voz, PM2, automações, clientes (admin) — só showroom	Admin Luxtor
Relatório	Análise diária + PDF + score NPS	Todos
Não Perturbe	Lista LGPD — bloqueia discagem	Todos
Créditos	Saldo Luxtor Cloud vinculado	Cliente com tenant

🔥

Interessados

Fila humana — prioridade operacional

Leads em etapas interessado, em-contato e atendeu aparecem aqui para a equipe da clínica ligar, agendar ou atualizar status manualmente.

💡No modo painel, o dialer não faz handoff automático para Gabi. A clínica controla o fluxo.

💬

Conversas

Histórico por lead

Lista conversas derivadas do histórico da jornada: preview, turnos, duração e modal com transcrição. Filtros: hoje, interesse, rejeição, ocupado. Busca por nome/telefone.

GET/api/conversas?filtro=hoje&busca=

Lista conversas (JWT). Escopo automático por clínica.

GET/api/conversas/historico?id=LEAD_ID

Histórico detalhado de um lead.

🎯

Jornada do lead

Funil completo:

pendente → ligando → atendeu → interessado → agendado-zap → agendado → confirmado → compareceu
↓ ↓ ↓
nao-atendeu nao-interessado nao-agendou / nao-compareceu

📞Sofia voz (MVP): lead entra direto em agendado com fonte: sofia-voz — sem etapas intermediárias na demo. Ver Sofia → CRM.

Campo detalheSofia

Observação do paciente (até 200 caracteres) — preenchida na ligação, visível na aba Recepção e no modal do lead.

Export CSVJornada

Botão na aba Jornada ou GET /api/jornada/export — exporta id, nome, telefone, etapa, fonte, score.

💎

Planos

Plano	Inclui
Demonstração	Self-service em /demo · R$ 20 créditos · Teste ao Vivo · 500 leads · sem expiração por data
Plus	CRM completo, Sofia voz, Gabi Zap, Neural, relatório semanal, agendamento público, inbox WhatsApp

🛡️

Segurança

JWT em todas as APIsGate

apiGate exige token em /api/* exceto rotas públicas (/api/public/*, /api/hooks/*), webhooks Twilio e master. Cookies secure em produção.

Token internoDialer

Dialer e automações usam header x-painel-token para endpoints internos.

Isolamento por clínicaTenant

Sem fallback para demo: usuário não autenticado não acessa dados. Admin pode filtrar por ?clinicaId=.

Secrets em .envVPS

JWT_SECRET, TWILIO, ELEVENLABS e tokens ficam em /opt/clinica-painel/.env — nunca no código versionado.

🏢

Multi-tenant (storage)

Dados da jornada, tarefas, profissionais, inbox e NPS são armazenados por clínica:

Produção (recomendado): PostgreSQL via DATABASE_URL — banco luxtor_clinica

Desenvolvimento / fallback: /opt/clinica-painel/clinica-data/{clinicaId}.json

Migração automática do legado clinica-db.json e dos arquivos JSON para PG na primeira inicialização com DATABASE_URL. Admin vê métricas em Config → Métricas por Clínica (GET /api/admin/metrics).

🤖

Automações

PM2 clinica-automacoes · porta 3351

Rotina	Quando	O quê
Monitor serviços	A cada 2 min	Alerta WhatsApp se dialer/painel/voz cair
Lembretes consulta	A cada 15 min	24h e 2h antes (Gabi Zap)
Reagendamento	00h	Leads nao-interessado → pendente após 30 dias
Relatório diário	20h	Resumo Clínica Horizonte → admin
Relatório semanal	Domingo 8h	Resumo por clínica → WhatsApp do cliente
NPS	3h após compareceu	Pesquisa 0-10 via Gabi + score no Relatório

📜

Termos de uso e LGPD

Ao primeiro acesso, o usuário deve aceitar os termos (POST /auth/accept-terms). A lista Não Perturbe permite bloquear números que solicitaram não ser contactados — o dialer respeita automaticamente.

Dados pessoais (nome, telefone, histórico) são processados para gestão comercial da clínica contratante. Solicitações de exclusão devem ser feitas à clínica ou ao suporte Luxtor.

🔌

APIs principais

POST/auth/login

email + senha → JWT

GET/auth/me

Usuário, features, plano, termosAceitos

GET/api/jornada

Jornada filtrada por clínica

POST/api/jornada

Criar/atualizar lead — Sofia voz envia com etapa: agendado + fonte: sofia-voz. Token interno: x-painel-token

PUT/api/jornada/:id

Atualizar etapa do lead

Recepção

GET/api/recepcao/hoje

Agendamentos de hoje + detalhe + fonte — aba Recepção

GET/api/agendamentos

Todos agendamentos — aba Agenda

PUT/api/agendamentos/:id

Confirmar ou cancelar agendamento

GET/api/relatorio

Relatório do dia com taxas e gargalos (inclui breakdown por fonte)

GET/api/supressao

Lista Não Perturbe

GET/api/admin/metrics

Métricas por clínica (admin)

GET/api/leads/pendentes

Dialer interno (x-painel-token)

Tarefas

GET/api/tarefas

Lista tarefas da clínica

POST/api/tarefas

Criar tarefa de follow-up

Equipe e integrações

GET/api/profissionais

Profissionais cadastrados

GET/api/integracoes

URLs webhook e agendamento público (gerente)

WhatsApp inbox

GET/api/inbox/threads

Threads do inbox

POST/api/inbox/send

Enviar mensagem WhatsApp

Públicas (sem JWT)

GET/api/public/clinica/:slug

Dados da clínica para agendamento

POST/api/public/clinica/:slug/agendar

Agendar consulta online

POST/api/hooks/leads/:token

Capturar lead externo

POST/api/hooks/inbox/:token

Registrar mensagem WhatsApp recebida

POST/api/hooks/nps/:token

Registrar resposta NPS

NPS

GET/api/nps

Score e respostas NPS

⚙️

Arquitetura

Showroom Ouro + Piloto Campinas

Showroom — crm.luxtor.ia.br

Serviço	PM2	Porta
Painel CRM	clinica-painel	3350
Automações	clinica-automacoes	3351
Luxtor Cloud	luxtor-cloud	3360
Dialer	dialer-clinica	4601
Voz Sofia	voice-sofia-clinica	3343
Sofia gateway	sofia-clinica	18796
Gabi gateway	gabi-clinica	18797
Neural (Lux)	suporte-luxtor	18800
Salão equipe	equipe-salao	18950
Luxtor gateway	luxtor-gateway	18790

Piloto — crm-piloto.luxtor.ia.br

Serviço	PM2	Porta
Painel CRM	clinica-painel	3350
Dialer	dialer-clinica-piloto	4601
Lia voz	lia-clinica-piloto	18796
Nina Zap	nina-clinica-piloto	18797
Neural (Lux)	suporte-luxtor	18800

URLs: crm.luxtor.ia.br · crm-piloto.luxtor.ia.br · Deploy: scripts/deploy-crm-ambos.py

🧪

Sofia e Gabi — apenas teste

⚠️Sofia (voz) e Gabi (WhatsApp IA) aparecem no painel somente para admin ou clínica demo clinica-horizonte. Clientes reais não veem configuração de voz nem campanha automática com IA.

Atributo UI: data-ia-teste + flag features.iaTeste em /auth/me.

Integração Sofia → CRMMVP

Ao confirmar horário + WhatsApp na ligação, Sofia registra lead em agendado com observação. Recepção vê na aba Recepção. Documentação: Sofia → CRM.

Teste ao VivoConfig

Config → Teste ao Vivo → liga para seu celular com demo=1. Fluxo B2B: agendamento (Ato 1) → pitch Luxtor (Ato 1b+) — CRM só muda na confirmação do horário.