Listar o histórico de status de um atendente

Listar o histórico de status de um atendente, com paginação e filtros por tipo de status e período.

📌 Por que consultar o histórico de status de um atendente?


O histórico mostra cada mudança de status do atendente e quanto tempo ele ficou em cada um.

  • Acompanhamento da jornada do atendente (online, em atendimento, em tabulação, ausente e offline).
  • Cálculo de indicadores de produtividade e de tempo em pausa.
  • Auditoria da disponibilidade da equipe em um período.


🔗 Endpoint:


Método: GET

URL: https://api.nuvidio.com/v1/api/attendant/:id/status-history


🔎 Parâmetros da URL:


ParâmetroObrigatórioDescrição
:id✅Identificador do atendente

🔎 Parâmetros da Requisição (query):


ParâmetroTipoObrigatórioDescrição
pagenumber❌Página da consulta. Padrão: 1. Valores aceitos: 1 a 200
takenumber❌Quantidade de registros por página. Padrão: 10. Valores aceitos: 1 a 100
typesstring❌Array em JSON com os tipos de status que devem ser retornados. Valores aceitos: online, in-attendance, in-tabulation, away, offline
startDatestring❌Data inicial do período (ISO 8601). Precisa ser enviada junto com finalDate
finalDatestring❌Data final do período (ISO 8601). Precisa ser enviada junto com startDate

💡

O filtro de período só é aplicado quando startDate e finalDate são enviados juntos.


💡

O parâmetro types precisa ser um array em JSON codificado na URL. Exemplo: types=["online","away"] vira types=%5B%22online%22%2C%22away%22%5D.


📦 Exemplo de Requisição:


GET https://api.nuvidio.com/v1/api/attendant/:id/status-history?page=1&take=10&types=%5B%22online%22%2C%22away%22%5D&startDate=2026-09-01T00:00:00.000Z&finalDate=2026-09-30T23:59:59.999Z

💡

Os registros são retornados em ordem decrescente de initialDate, do mais recente para o mais antigo.


✅ Resposta de Sucesso:


200 - OK

{
  "count": 2,
  "statusHistory": [
    {
      "id": "651a0f0c9b1e8a0012a3b4c5",
      "attendant": "651a0e7f9b1e8a0012a3b4a1",
      "company": "651a0d2a9b1e8a0012a3b490",
      "description": "",
      "type": "away",
      "previousType": "online",
      "initialDate": "2026-09-29T14:10:00.000Z",
      "finalDate": "2026-09-29T14:25:00.000Z",
      "createdAt": "2026-09-29T14:10:00.000Z"
    },
    {
      "id": "651a0e9d9b1e8a0012a3b4b2",
      "attendant": "651a0e7f9b1e8a0012a3b4a1",
      "company": "651a0d2a9b1e8a0012a3b490",
      "description": "",
      "type": "online",
      "previousType": "offline",
      "initialDate": "2026-09-29T13:00:00.000Z",
      "finalDate": "2026-09-29T14:10:00.000Z",
      "createdAt": "2026-09-29T13:00:00.000Z"
    }
  ]
}

CampoDescrição
countTotal de registros encontrados com os filtros aplicados, somando todas as páginas
statusHistory[].typeStatus do atendente no período
statusHistory[].previousTypeStatus anterior do atendente
statusHistory[].initialDateInício do status
statusHistory[].finalDateFim do status. Não aparece se o status ainda estiver ativo
statusHistory[].descriptionDescrição do status, se houver

❌ Respostas de erro:


CódigoMensagem
401Credenciais inválidas
404Atendente não encontrado
422Parâmetros inválidos (ex.: :id fora do formato esperado, take acima de 100)
500Erro interno