Atendimentos

Leia a fila, atendimentos em andamento e histórico, e escale sessões para humano via OAuth2.

Visão Geral

Endpoints da API Externa para automações lerem o estado do atendimento e acionarem escalações sem precisar do JWT admin. A aplicação destino é inferida do claim aplicacao_id do token.

Base URL: /api/external/v2/atendimentos

Autenticação: OAuth2 Bearer Token — escopos atendimentos:read (GET) e atendimentos:escalar (POST)

Listar Fila

GET /api/external/v2/atendimentos/fila

Escopo: atendimentos:read. Retorna a lista de sessões aguardando operador humano (status NA_FILA).

curl https://api.avizuai.com.br/api/external/v2/atendimentos/fila \
  -H "Authorization: Bearer eyJhbGciOi..."

Atendimentos em Andamento

GET /api/external/v2/atendimentos/em-andamento

Escopo: atendimentos:read. Sessões em status EM_ATENDIMENTO (operador humano atuando).

Histórico

GET /api/external/v2/atendimentos/historico

Escopo: atendimentos:read. Sessões finalizadas, paginadas, com filtros opcionais — útil para exportar para BI/CRM via n8n/Zapier.

Parâmetro	Tipo	Obrigatório	Descrição
`operadorId`	`long`	Opcional	Filtro por operador
`telefone`	`string`	Opcional	Filtro por telefone do paciente
`dtInicio`	`datetime`	Opcional	Início do período (ISO-8601)
`dtFim`	`datetime`	Opcional	Fim do período (ISO-8601)
`page`	`int`	Opcional	Página (default `0`)
`size`	`int`	Opcional	Itens por página (default `20`, máx `100`)

curl https://api.avizuai.com.br/api/external/v2/atendimentos/historico?dtInicio=2026-06-01T00:00:00&page=0&size=50 \
  -H "Authorization: Bearer eyJhbGciOi..."

Resposta (200): formato paginado { content, total, page, size, totalPages }.

Escalar Sessão para Humano

POST /api/external/v2/atendimentos/{sessaoId}/escalar

Escopo: atendimentos:escalar. Marca a sessão como NA_FILA. Idempotente — sessões já na fila ou em atendimento retornam 200 sem alteração. Útil para fluxos n8n que detectam condições externas (paciente VIP, falha em sistema legado, etc.).

Campo	Tipo	Obrigatório	Descrição
`motivo`	`string`	Opcional	Motivo da escalação (registrado em log)
`urgencia`	`string`	Opcional	Nível de urgência

curl -X POST https://api.avizuai.com.br/api/external/v2/atendimentos/123/escalar \
  -H "Authorization: Bearer eyJhbGciOi..." \
  -H "Content-Type: application/json" \
  -d '{"motivo":"Paciente prioritário","urgencia":"HIGH"}'

Resposta de sucesso (200):

{
  "sucesso": true,
  "status": "NA_FILA",
  "motivo": "Paciente prioritário"
}

Retorna 404 se a sessão não existir ou pertencer a outra aplicação. Body é opcional — sem ele, o motivo padrão é "Escalação via API externa".

Próximos Passos

🩺 Pacientes 📅 Agendamentos 🔐 OAuth2 / n8n