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âmetro | Obrigatório | Descrição |
|---|---|---|
| :id | ✅ | Identificador do atendente |
🔎 Parâmetros da Requisição (query):
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| page | number | ❌ | Página da consulta. Padrão: 1. Valores aceitos: 1 a 200 |
| take | number | ❌ | Quantidade de registros por página. Padrão: 10. Valores aceitos: 1 a 100 |
| types | string | ❌ | Array em JSON com os tipos de status que devem ser retornados. Valores aceitos: online, in-attendance, in-tabulation, away, offline |
| startDate | string | ❌ | Data inicial do período (ISO 8601). Precisa ser enviada junto com finalDate |
| finalDate | string | ❌ | Data final do período (ISO 8601). Precisa ser enviada junto com startDate |
O parâmetrotypesprecisa ser um array em JSON codificado na URL. Exemplo:types=["online","away"]viratypes=%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 deinitialDate, 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"
}
]
}| Campo | Descrição |
|---|---|
| count | Total de registros encontrados com os filtros aplicados, somando todas as páginas |
| statusHistory[].type | Status do atendente no período |
| statusHistory[].previousType | Status anterior do atendente |
| statusHistory[].initialDate | Início do status |
| statusHistory[].finalDate | Fim do status. Não aparece se o status ainda estiver ativo |
| statusHistory[].description | Descrição do status, se houver |
❌ Respostas de erro:
| Código | Mensagem |
|---|---|
401 | Credenciais inválidas |
404 | Atendente não encontrado |
422 | Parâmetros inválidos (ex.: :id fora do formato esperado, take acima de 100) |
500 | Erro interno |

