---
url: https://docs.ouvixpro.ai/visoes/geral.md
description: >-
  Resumo: Pulso da recepção: onde falou, quem parou no balcão, alunos novos e o
  que pede atenção. Campos, exemplo e a tela pronta em painel.tela.resumo.
---

# Resumo

Pulso da recepção: onde falou, quem parou no balcão, alunos novos e o que pede atenção.

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.resumo` (cards com texto, cor e lista de evidências) e, mais leve, em `GET /v1/tela?tela=resumo`. O guia [Montando a tela](/guia/telas#resumo) mostra bloco a bloco.
:::

| Campo | Tipo | O que é |
| --- | --- | --- |
| `total` | number | Episódios na recepção no período (entrada + balcão + saída). |
| `mediaNota` | number / null | Nota média da recepção, de 0 a 10. |
| `graves` | number | Atendimentos marcados como graves. |
| `oportunidades` | number | Oportunidades apontadas no período. |
| `visitas` | number | Visitas ou tours. |
| `churn` | number | Cancelamentos e congelamentos. |
| `entradas` | number | Pessoas recebidas na entrada. |
| `atendimentosBalcao` | number | Atendimentos parados no balcão. |
| `saidas` | number | Despedidas na saída. |
| `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. |
| `alertas` | array | Alertas do período: título, severidade e quantidade. |
| `tipos` | array | Mix de tipos de atendimento (check-in, matrícula, renovação…). |
| `atendimentos` | array | Todos os atendimentos do período, em ordem de data e horário. Use o campo id em /v1/atendimentos/{id}. |
| `evidencias` | array | Atendimentos que pedem atenção (graves, sem próximo passo, demanda em aberto). |
| `ranking` | array | Nota e volume por unidade no período. Com uma unidade, a lista tem um item. |
| `isV2` | boolean | Verdadeiro quando o período usa o formato atual do painel. Períodos antigos podem trazer menos campos. |
| `demandas` | array | Pedidos fora do cardápio de planos, agrupados por tema: tema, chave, qtd, prometeu e exemplos. |

## Exemplo

```json
{
  "Id_unidade": "375",
  "visao": "recepcao",
  "de": "2026-10-06",
  "ate": "2026-10-06",
  "turno": "todos",
  "painel": {
    "total": 24,
    "mediaNota": 7.4,
    "graves": 0,
    "oportunidades": 2,
    "visitas": 0,
    "churn": 0,
    "entradas": 4,
    "atendimentosBalcao": 19,
    "saidas": 1,
    "atendNovos": 13,
    "novosFechados": 9,
    "novosSemProximoPasso": 3,
    "alertas": [
      {
        "titulo": "Aluno novo saiu sem próximo passo",
        "qtd": 3
      }
    ],
    "tipos": [
      {
        "tipo": "matricula",
        "label": "Matrícula",
        "qtd": 6
      }
    ],
    "atendimentos": [],
    "evidencias": [],
    "ranking": [
      {
        "loja": "Boituva",
        "score": 7.4,
        "qtd": 24
      }
    ],
    "isV2": true,
    "demandas": []
  }
}
```