> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.pandazap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API de Métricas do Dashboard: Volume, Tempos e Evolução de Tickets

> Consulte volume de tickets, tempos de atendimento, evolução histórica, distribuição por canal, fila, motivo, usuário e status para qualquer período via API do PanÐá Zap.

Estes dez endpoints expõem os mesmos dados usados nos gráficos do **Dashboard** do painel do PanÐá Zap. Use-os para construir relatórios personalizados, monitorar SLA ou alimentar uma ferramenta de BI externa (Looker, Power BI, planilhas) sem precisar exportar dados manualmente.

Todas as requisições exigem o cabeçalho `Authorization: Bearer {BearerToken}`.

## Parâmetros Comuns

Todos os endpoints abaixo aceitam os mesmos dois parâmetros de consulta:

| Query param | Tipo   | Obrigatório | Descrição                                                            |
| ----------- | ------ | ----------- | -------------------------------------------------------------------- |
| `startDate` | string | Sim         | Início do período do relatório, no formato `YYYY-MM-DD` (inclusivo). |
| `endDate`   | string | Sim         | Fim do período do relatório, no formato `YYYY-MM-DD` (inclusivo).    |

***

## Volume e Tempos Gerais

Contagens totais de atendimento e médias de tempo de atendimento/espera do período.

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/dash/ticketsAndTimes?startDate=2026-03-01&endDate=2026-03-31
```

**Exemplo de resposta:**

```json theme={null}
{
  "success": true,
  "data": {
    "totalAttendances": 1240,
    "activeDemand": 312,
    "receptiveDemand": 928,
    "newContacts": 184,
    "aht": 420,
    "awt": 95
  }
}
```

| Campo              | Descrição                                     |
| ------------------ | --------------------------------------------- |
| `totalAttendances` | Total de tickets atendidos no período.        |
| `activeDemand`     | Tickets iniciados pela sua equipe (outbound). |
| `receptiveDemand`  | Tickets iniciados pelos contatos (inbound).   |
| `newContacts`      | Novos contatos criados durante o período.     |
| `aht`              | Tempo médio de atendimento em segundos.       |
| `awt`              | Tempo médio de espera em segundos.            |

***

## Tickets por Canal

Distribuição de tickets por canal de origem (WhatsApp, Instagram, Webchat, etc.) no período.

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/dash/ticketsChannels?startDate=2026-03-01&endDate=2026-03-31
```

***

## Evolução de Tickets

Série temporal com a quantidade de tickets criados por dia (ou período) dentro do intervalo informado — base para gráficos de linha/área de evolução.

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/dash/ticketsEvolution?startDate=2026-03-01&endDate=2026-03-31
```

***

## Evolução de Tickets por Valor

Mesma série temporal de evolução, agregada pelo campo `value` (valor monetário) dos tickets em vez da contagem — útil para acompanhar receita/potencial de vendas ao longo do tempo.

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/dash/ticketsEvolutionByValue?startDate=2026-03-01&endDate=2026-03-31
```

***

## Evolução de Tickets por Canal

Série temporal de evolução segmentada por nome de canal — combina as visões de [Evolução de Tickets](#evolução-de-tickets) e [Tickets por Canal](#tickets-por-canal) em uma única resposta.

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/dash/ticketsEvolutionChannelsName?startDate=2026-03-01&endDate=2026-03-31
```

***

## Tickets por Usuário

Contagem de tickets atendidos, agrupada por agente responsável.

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/dash/ticketsPerUser?startDate=2026-03-01&endDate=2026-03-31
```

***

## Tickets por Fila

Contagem de tickets, agrupada por fila de atendimento.

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/dash/ticketsQueue?startDate=2026-03-01&endDate=2026-03-31
```

***

## Tickets por Motivo

Contagem de tickets encerrados, agrupada pelo motivo de encerramento atribuído (veja [Motivos](/api/organization#motivos)).

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/dash/ticketsReasons?startDate=2026-03-01&endDate=2026-03-31
```

***

## Tickets por Status

Contagem de tickets, agrupada por status (`open`, `pending`, `closed`) no período.

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/dash/ticketsStatus?startDate=2026-03-01&endDate=2026-03-31
```

***

## Detalhamento de Tickets por Usuário

Versão detalhada de [Tickets por Usuário](#tickets-por-usuário), trazendo métricas adicionais por agente (por exemplo, tempo médio de atendimento individual) em vez de apenas a contagem.

```http theme={null}
GET https://{BaseUrl}/v2/api/external/{ApiID}/dash/ticketsUser?startDate=2026-03-01&endDate=2026-03-31
```

***

## Resposta Padrão

Todos os endpoints retornam:

```json theme={null}
{
  "success": true,
  "data": { ... }
}
```

A forma exata de `data` varia por endpoint conforme descrito em cada seção acima — desde um objeto agregado único ([Volume e Tempos Gerais](#volume-e-tempos-gerais)) até arrays agrupados por canal, fila, motivo, usuário, status ou período.