Período e turno

Os endpoints /v1/painel, /v1/atendimentos/{id} e /v1/atendimentos/{id}/audio exigem o período da consulta. Não há valor padrão: a API não assume "hoje" nem "ontem", para que o resultado seja sempre reproduzível.

de e ate

Datas no formato YYYY-MM-DD, inclusivas nas duas pontas.

Consulta	Parâmetros
Um dia	de=2026-10-08&ate=2026-10-08
Uma semana	de=2026-10-02&ate=2026-10-08
Um mês	de=2026-10-01&ate=2026-10-31

• O intervalo máximo é de 31 dias. Para períodos maiores, divida em chamadas mensais.
• de precisa ser menor ou igual a ate.
• Em intervalos, os números do painel são consolidados e as listas trazem os atendimentos de todos os dias, em ordem de data_ref e horario.

Quando consultar

Os dados de um dia ficam prontos na madrugada seguinte, depois do processamento das gravações. Consultas ao dia corrente podem voltar incompletas.

turno

Parâmetro opcional para recortar o período por faixa de horário. Sem ele, a API devolve o dia inteiro.

turno	Faixa
todos (padrão)	O período inteiro.
manha	06:00 – 11:59
tarde	12:00 – 16:59
noite	17:00 – 22:00

curl "https://api.ouvixpro.ai/v1/painel?Id_unidade=375&de=2026-10-08&ate=2026-10-08&turno=tarde" \
  -H "Authorization: Bearer $OUVIX_API_KEY"

O filtro vale para todos os blocos do painel: contadores, listas e insights refletem só o turno pedido. A resposta repete o turno aplicado no campo turno.

Período em /v1/atendimentos/{id} e no áudio

O id de um atendimento só é resolvido dentro do Id_unidade e do período informados. Use o mesmo de / ate (e turno) da chamada ao /v1/painel que devolveu o atendimento; fora desse recorte a resposta é 404 atendimento_nao_encontrado.

Erros relacionados

HTTP	code	Causa
400	data_obrigatoria	de ou ate não informados.
400	periodo_invalido	Data inválida, de maior que ate, ou intervalo acima de 31 dias.
400	turno_invalido	Valor fora de todos, manha, tarde, noite.