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.

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

{
  "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."
          }
        ]
      }
    ]
  }
}