---
url: https://docs.ouvixpro.ai/visoes/qualidade.md
description: >-
  Qualidade: Nota por momento, saudação, despedida, graves e boas práticas.
  Campos, exemplo e a tela pronta em painel.tela.qualidade.
---

# Qualidade

Nota por momento, saudação, despedida, graves e boas práticas.

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

| Campo | Tipo | O que é |
| --- | --- | --- |
| `mediaNota` | number / null | Nota média da recepção, de 0 a 10. |
| `graves` | number | Atendimentos marcados como graves. |
| `objecoes` | number | Objeções ouvidas no período. |
| `aderenciaGuia` | number / null | Percentual médio de cumprimento do guia da recepção. |
| `saudacaoPct` | number / null | Percentual de atendimentos com saudação. |
| `notaEntrada` | number / null | Nota média da entrada. |
| `notaAtendimento` | number / null | Nota média do balcão. |
| `notaSaida` | number / null | Nota média da saída. |
| `guia` | array | Itens do guia da recepção, com feitos, total e percentual. |
| `evidencias` | array | Atendimentos que pedem atenção (graves, sem próximo passo, demanda em aberto). |

## Exemplo

```json
{
  "Id_unidade": "375",
  "visao": "recepcao",
  "de": "2026-10-06",
  "ate": "2026-10-06",
  "turno": "todos",
  "painel": {
    "mediaNota": 7.4,
    "graves": 0,
    "objecoes": 0,
    "aderenciaGuia": 71,
    "saudacaoPct": 25,
    "notaEntrada": 8.1,
    "notaAtendimento": 7.2,
    "notaSaida": 6.4,
    "guia": [
      {
        "item": "saudacao",
        "label": "Saudação",
        "feitos": 20,
        "total": 30,
        "pct": 67
      }
    ],
    "evidencias": []
  }
}
```