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"

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

Resumo ​

Exemplo ​

Resumo

Exemplo