Novos alunos

Cada aluno novo atendido no balcão: guia cumprido, fechou ou saiu sem próximo passo. Alunos de casa, churn e oportunidades.

Os números abaixo estão em painel na resposta de GET /v1/painel. A chamada sempre leva Id_unidade e o período. Toda lista de atendimentos vem em ordem de data e horário, do mais cedo para o mais tarde.

curl "https://api.ouvixpro.ai/v1/painel?Id_unidade=375&de=2026-10-06&ate=2026-10-06" \
  -H "Authorization: Bearer $OUVIX_API_KEY"

Quer a tela pronta?

Esta mesma visão já vem montada em painel.tela.comercial (cards com texto, cor e lista de evidências) e, mais leve, em GET /v1/tela?tela=comercial. O guia Montando a tela mostra bloco a bloco.

Campo	Tipo	O que é
atendAlunos	number	Atendimentos de quem já é aluno.
atendNovos	number	Alunos novos (visitantes) atendidos no balcão.
novosFechados	number	Alunos novos com cadastro no balcão (nome, documento ou ficha). Plano fechado é outra conta: veja protocolo.fechouN.
novosSemProximoPasso	number	Alunos novos que saíram sem contato, agendamento ou matrícula.
novosSemOferta	number	Alunos novos atendidos sem oferta de plano ou experimental.
taxaFechamentoNovos	number / null	Percentual de alunos novos com cadastro.
contatoNovosPct	number / null	Percentual de alunos novos com contato registrado.
notaNovos	number / null	Nota média nos atendimentos de aluno novo.
aderenciaNovos	number / null	Aderência ao guia de aluno novo, em percentual.
demandasNaoResolvidas	number	Atendimentos de aluno em que a demanda ficou em aberto.
funilNovos	object	Funil do aluno novo: atendidos, visitas, cadastros, fechados (com cadastro), sem próximo passo e sem oferta.
motivosNaoFechou	array	Por que o aluno novo saiu sem fechar, com quantidade. Valores em "Motivos de não fechar".
novosAlunos	array	Lista dos alunos novos, em ordem de horário. Cada item é um atendimento, com id para o áudio.
guiaNovos	array	Guia dos alunos novos.
oportunidadesLista	array	Atendimentos com oportunidade na fala.
gympass	array	Atendimentos em que a pessoa entra pelo Gympass ou Wellhub.
totalpass	array	Atendimentos em que a pessoa entra ou compara com TotalPass.

Cadastro × plano fechado

novosFechados conta aluno novo com cadastro (nome, documento ou ficha). Plano fechado é painel.protocolo.fechouN. Um visitante pode ter cadastro e não ter fechado plano (pagou a diária, volta amanhã), e as duas contas aparecem separadas na tela.

novosSemProximoPasso conta quem saiu sem contato, agendamento ou matrícula. motivosNaoFechou diz por quê.

Motivos de não fechar

Valor	Rótulo na tela	Quando
volta_depois	Volta outro dia pra fechar	Disse que volta amanhã ou outro dia para fechar (sem documento, sem cartão, vai trazer alguém).
diaria	Pagou só a diária	Pagou a diária avulsa (R$ 49,90) e não entrou em plano.
preco	Preço	Achou caro ou comparou preço.
caro	Tá caro	Disse explicitamente que está caro.
horario	Horário	O horário da academia ou da aula não serve.
vai_pensar	Vai pensar	Vai pensar, sem data para voltar.
vou_pensar	Disse que ia ver	"Vou ver", sem compromisso.
conjuge	Vou ver com marido/esposa	Depende de outra pessoa.
totalpass	TotalPass	Prefere ou já tem TotalPass.
cartao	Não quer cartão	Não quis deixar o cartão no recorrente.
pix	Quer pagar no Pix	Quer pagar à vista no Pix.
so_olhando	Só olhando	Veio só conhecer.
sem_oferta	Sem oferta da recepção	A recepção não ofereceu plano.
outro	Outro	Qualquer outro motivo.

Exemplo

{
  "Id_unidade": "375",
  "visao": "recepcao",
  "de": "2026-10-06",
  "ate": "2026-10-06",
  "turno": "todos",
  "painel": {
    "atendAlunos": 4,
    "atendNovos": 13,
    "novosFechados": 9,
    "novosSemProximoPasso": 3,
    "novosSemOferta": 0,
    "taxaFechamentoNovos": 69,
    "contatoNovosPct": 31,
    "notaNovos": 7.4,
    "aderenciaNovos": 35,
    "demandasNaoResolvidas": 0,
    "funilNovos": {
      "atendidos": 13,
      "visitas": 0,
      "cadastros": 3,
      "fechados": 9,
      "sem_proximo_passo": 3,
      "sem_oferta": 0
    },
    "motivosNaoFechou": [
      {
        "motivo": "volta_depois",
        "label": "Volta outro dia pra fechar",
        "qtd": 2
      },
      {
        "motivo": "diaria",
        "label": "Pagou só a diária",
        "qtd": 1
      }
    ],
    "novosAlunos": [],
    "guiaNovos": [],
    "oportunidadesLista": [],
    "gympass": [],
    "totalpass": []
  }
}