---
url: https://docs.ouvixpro.ai/guia/novidades.md
description: >-
  Registro das mudanças na API, da mais recente para a mais antiga: logs e
  X-Request-Id, tela pronta, áudio por atendimento, desfecho da venda,
  Id_unidade.
---

# Novidades

Registro das mudanças na API, da mais recente para a mais antiga. A regra é compatibilidade: campos existentes mantêm nome e significado; mudanças entram como campos novos. Quando algo deixa de ser aceito, está dito explicitamente.

## Outubro de 2026 — logs das chamadas

* **Novo cabeçalho `X-Request-Id`** em toda resposta, sucesso ou erro. Guarde-o no seu log.
* **Nova tela Logs da API** no OuvixPRO: cada chamada feita com as suas chaves, com status, código do erro, parâmetros, duração, tamanho e IP de origem; filtros por período, status, endpoint e chave; detalhe com a URL e um `curl` para reproduzir. O `X-Request-Id` localiza a linha. Veja [Limites e erros](/guia/erros#rastreando-uma-chamada).
* A autenticação passou a rodar antes da validação dos parâmetros: sem chave válida a resposta é sempre `401`, mesmo que falte `de`/`ate`.

## Outubro de 2026 — a tela pronta

Para quem quer reproduzir o painel OuvixPRO no próprio sistema sem reescrever regra nenhuma. Tudo é calculado pelo mesmo código que desenha a interface.

* **Novo bloco `painel.tela`** em `GET /v1/painel`: as nove telas (`resumo`, `fluxo`, `qualidade`, `acesso`, `comercial`, `horarios`, `venda`, `renovacao`, `insights`) já montadas — cards com texto pronto (`valor`), cor (`tone`), legenda (`hint`) e a `lista` de conversas que abre ao clicar — mais `tela.listas`, com os ids, selos e notas de cada lista de evidência.
* **Novo endpoint `GET /v1/tela`**: só as telas, as listas e os atendimentos referenciados. Aceita `tela=venda` (ou qualquer uma das nove) para vir uma por vez, com apenas os atendimentos que ela usa.
* **Novo endpoint `GET /v1/catalogo`**: rótulos, cores, metas, catálogo de planos, motivos e regras de tom. Não depende de unidade nem período; cache de 1 hora.
* **Novo bloco `rotulos`** em todo atendimento: `quando`, `momento`, `perfil`, `tipo` (com label e cor), `chips` de contexto, tags de `planos` e o desfecho pronto para aluno novo (`novo`), venda (`venda`) e renovação (`renovacao`).
* **Correção:** o mesmo atendimento recebia ids diferentes conforme a lista (`atend_6`, `atend_6:2`, `atend_6:3`). Agora é um só id por conversa em todas as listas; o sufixo `:n` só aparece quando duas conversas distintas dividem o mesmo `atendimento_id`.
* Novo guia [Montando a tela](/guia/telas).

## Outubro de 2026 — áudio pelo id do atendimento

* **Novo endpoint** `GET /v1/atendimentos/{id}/audio`: entrega só o trecho da conversa, igual ao play do painel, sempre em WAV, com documento e nome completo em silêncio. Conversas que atravessam a troca de arquivo vêm coladas em um único áudio. Detalhes em [Áudio](/guia/audio).
* **Novo bloco `audio`** em todo atendimento (também nos itens de `insights` e nas listas de `protocolo`): `url`, `duracao_s`, `partes`. `null` quando não há gravação.
* **Removidos da resposta** os campos internos de arquivo: `id_upload`, `nome_arquivo`, `inicio_hms`, `fim_hms`, `arquivos`, `pii_mutes`, `id_cliente`. A API não expõe mais referência a arquivos de gravação.
* **Descontinuado** `GET /v1/audio` (parâmetros `id_upload`, `inicio_hms`, `fim_hms`). Responde `410 endpoint_removido`.
* Nova página [Começando](/guia/comecando) e reorganização desta documentação sob a marca OuvixPRO.

## Outubro de 2026 — desfecho da venda

A conta de venda passou a ter três estados em vez de dois. Antes, uma conversa de plano era "fechou" ou "não fechou"; agora o áudio cortado é separado.

**Em `painel.protocolo`**

| Campo | O que é |
| --- | --- |
| `fechadas` | Conversas que fecharam um plano (`fechou=true` ou `protocolo.plano_fechado`). |
| `abertas` | Saíram sem fechar e isso aparece no áudio (`fechou=false`). |
| `semDesfecho` | O áudio corta antes do fim (`fechou=null`). Não conta nem como fechada nem como aberta. |
| `vendasN` | Agora é `fechadas + abertas + semDesfecho`. |

**Em cada atendimento**

| Campo | O que é |
| --- | --- |
| `desfecho_venda` | Leitura dedicada do desfecho: `eh_venda`, `fechou`, `plano_fechado`, `evidencia` (fala literal que prova) e `proximo_passo`. Presente em toda conversa de plano. |
| `fechou` | Passa a seguir a mesma regra em todas as visões: `true` fechou plano, `false` saiu sem fechar, `null` sem desfecho no áudio. |
| `protocolo.plano_fechado` | Sempre preenchido quando `fechou=true`; sempre `null` quando `fechou=false`. |
| `motivo_nao_fechou` | Dois valores novos: `volta_depois` (volta outro dia para fechar) e `diaria` (pagou só a diária avulsa, R$ 49,90 — não é plano). |
| `id` | Agora vem também nos itens de `protocolo.vendas`, `fechadas`, `abertas`, `semDesfecho`, `renovacoes`, `passosVenda[].fez/faltou` e em `insights[].itens[]`. É o mesmo `id` de `painel.atendimentos`. |

**Regras que a leitura aplica**

* Fechou só com sinal forte na fala (link do contrato, cadastro do cartão, "fechou", liberação do acesso).
* Diária avulsa não é plano: `fechou=false`, `motivo_nao_fechou="diaria"`.
* Cadastro digital ou ativação de quem já pagou não é venda: `desfecho_venda.eh_venda=false`, fora de `protocolo.vendas`.
* Quem entra por Gympass/Wellhub ou TotalPass fica fora de `protocolo.vendas` (`agregador` preenchido).
* Ex-aluno que volta e pede plano é venda.

**Ordem das listas**

Toda lista de atendimentos (`atendimentos`, `novosAlunos`, `protocolo.vendas`, `evidencias`, `insights[].itens`…) vem em ordem de `data_ref` e `horario`, do mais cedo para o mais tarde. Antes, algumas listas vinham com "fechadas primeiro".

**Alunos novos**

`novosFechados` e `funilNovos.fechados` contam aluno novo **com cadastro** (nome, documento ou ficha). Plano fechado é `protocolo.fechouN`. As duas contas são diferentes de propósito: um visitante pode ter cadastro e ainda não ter plano.

**Insights**

`painel.insights` é uma lista de grupos: `chave`, `tipo` (`pendencia`, `decisao`, `risco`), `tema`, `assunto`, `acao`, `qtd`, `dias` e `itens[]` (um por conversa, com `id`, `quem`, `titulo`, `fato`, `aberto`, `acao`). O formato antigo (`assunto`, `qtd`, `aproveitou`) não existe mais.

## Outubro de 2026 — Id\_unidade

* `Id_unidade` substituiu `unidade` em toda chamada. Boituva é `375`. O parâmetro antigo não é mais aceito.
* `visao=professor` reservada; responde `visao_indisponivel` até o painel do tablet existir.