---
url: https://docs.ouvixpro.ai/visoes/comercial.md
description: >-
  Novos alunos: Cada aluno novo atendido no balcão: guia cumprido, fechou ou
  saiu sem próximo passo. Alunos de casa, churn e oportunidades. Campos, exemplo
  e a tela pronta em painel.tela.comercial.
---

# 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.

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

::: tip 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](/guia/telas#comercial) 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

```json
{
  "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": []
  }
}
```