Separar métricas de registros de chamadas

As rotas dash são consultas do Dashboard por período. callLog e wavoip/calls consultam registros de chamadas. São famílias com finalidade própria; não combine as respostas sem mapear o schema real de cada versão.

Consultar as famílias do Dashboard

Todas as rotas abaixo usam GET, recebem startDate e endDate e começam em /v2/api/external/{ApiID}/dash/.

  • ticketsAndTimes, ticketsChannels e ticketsEvolution.
  • ticketsEvolutionByValue e ticketsEvolutionChannelsName.
  • ticketsPerUser, ticketsQueue e ticketsReasons.
  • ticketsStatus e ticketsUser.
Dashboard com filtros de período e cartões de indicadores
Compare a resposta com o mesmo período fechado exibido no Dashboard.

Validar período, fuso e significado

  1. 1

    Escolha um período passado, fechado e com volume conhecido.

  2. 2

    Confirme no formulário interativo o formato aceito por startDate e endDate.

  3. 3

    Consulte uma rota por vez e registre internamente as chaves e os tipos retornados.

  4. 4

    Compare o mesmo intervalo com o Dashboard.

  5. 5

    Diferencie resposta vazia de métrica igual a zero.

  6. 6

    Defina nome, unidade, fuso e regra de agregação antes de armazenar o indicador.

  7. 7

    Revalide o contrato após atualizações da plataforma.

Consultar logs gerais e chamadas WaVoIP

  • No exemplo exibido pela versão atual, GET .../callLog/list usa pageNumber como consulta obrigatória e aceita startDate e endDate como filtros opcionais.
  • GET .../callLog/show/{id} consulta um registro geral.
  • No exemplo exibido pela versão atual, GET .../wavoip/calls usa pageNumber como consulta obrigatória e aceita startDate e endDate como filtros opcionais.
  • GET .../wavoip/calls/{id} consulta uma chamada WaVoIP.
Tela de log de ligações com filtros e registros
A interface oferece filtros adicionais; nas duas listagens externas atuais, o recorte publicado é página e período.

Resolver divergências sem alterar os dados

  • Dashboard vazio: confira intervalo e existência de tickets compatíveis.
  • Totais diferentes: compare fuso, interpretação do início e do fim e momento de atualização.
  • Indicador desconhecido: preserve o retorno bruto protegido e valide a semântica antes de usar.
  • Log não encontrado: confira se o ID pertence ao conjunto geral ou ao conjunto WaVoIP.
  • Página vazia: revise pageNumber e o período sem presumir formato de data ou valor inicial diferente do exemplo atual.
  • Gravação ausente: não invente uma URL; use os recursos autorizados da interface.