---
url: https://docs.ouvixpro.ai/visoes/insights.md
description: >-
  Insights: O que ficou em aberto: uma pessoa pra fechar, uma decisão sua, ou um
  aluno em risco. Campos, exemplo e a tela pronta em painel.tela.insights.
---

# Insights

O que ficou em aberto: uma pessoa pra fechar, uma decisão sua, ou um aluno em risco.

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

| Campo | Tipo | O que é |
| --- | --- | --- |
| `insights` | array | O que ficou em aberto, agrupado por assunto. Cada grupo traz tipo (pendencia, decisao, risco), ação e os itens com id do atendimento. Campos na tabela "Dentro de insights". |

## Dentro de `insights`

| Campo | Tipo | O que é |
| --- | --- | --- |
| `chave` | string | Identificador do grupo: tipo/tema/assunto. |
| `tipo` | string | pendencia (uma pessoa pra fechar), decisao (só o dono resolve) ou risco (aluno que pode parar). |
| `tema` | string | Tema curto: avaliacao, aula, plano, lesao, horario… |
| `assunto` | string | Assunto legível, por exemplo "Spinning". |
| `acao` | string | A ação mais repetida entre os itens do grupo. |
| `qtd` | number | Quantas pessoas no grupo. |
| `dias` | number | Em quantos dias do período o assunto apareceu. |
| `itens` | array | Um item por conversa: id, atendimento\_id, data\_ref, horario, tipo, quem (dono ou recepcao), titulo, fato, aberto, acao. Use id em /v1/atendimentos/{id} para o áudio. |

Cada grupo junta o mesmo assunto no período ("Spinning · 2 pessoas"). Para ouvir, pegue `itens[].id` e chame `/v1/atendimentos/{id}/audio`: o trecho vem recortado, com dados pessoais em silêncio.

## Exemplo

```json
{
  "Id_unidade": "375",
  "visao": "recepcao",
  "de": "2026-10-06",
  "ate": "2026-10-06",
  "turno": "todos",
  "painel": {
    "insights": [
      {
        "chave": "pendencia|avaliacao|avaliação física",
        "tema": "avaliacao",
        "tipo": "pendencia",
        "assunto": "Avaliação física",
        "acao": "Ligar e marcar a avaliação física com dia e hora.",
        "qtd": 2,
        "dias": 1,
        "itens": [
          {
            "id": "2026-10-06:atend_8",
            "atendimento_id": "atend_8",
            "data_ref": "2026-10-06",
            "horario": "07:24:58",
            "tema": "avaliacao",
            "tipo": "pendencia",
            "quem": "recepcao",
            "titulo": "Tem direito à avaliação e saiu sem data",
            "fato": "Na fala, a recepção disse que a pessoa tem avaliação a cada três meses.",
            "aberto": "Saiu sem dia marcado pra avaliação.",
            "acao": "Ligar e marcar a avaliação física com dia e hora."
          }
        ]
      }
    ]
  }
}
```