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

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.

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

Exemplo de resposta:

{
  "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.

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.

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.

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 e Tickets por Canal em uma única resposta.

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.

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.

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).

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.

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, trazendo métricas adicionais por agente (por exemplo, tempo médio de atendimento individual) em vez de apenas a contagem.

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

Resposta Padrão

Todos os endpoints retornam:

{
  "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) até arrays agrupados por canal, fila, motivo, usuário, status ou período.

Primeiros Passos

Mensagens

Mensagens Interativas

Tickets e Contatos

Campanhas e CRM

Canais e Recursos

Organização e Produtividade

Dados e Relatórios

Administração da Plataforma

Webhooks e Eventos

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

Parâmetros Comuns

Volume e Tempos Gerais

Tickets por Canal

Evolução de Tickets

Evolução de Tickets por Valor

Evolução de Tickets por Canal

Tickets por Usuário

Tickets por Fila

Tickets por Motivo

Tickets por Status

Detalhamento de Tickets por Usuário

Resposta Padrão

​Parâmetros Comuns

​Volume e Tempos Gerais

​Tickets por Canal

​Evolução de Tickets

​Evolução de Tickets por Valor

​Evolução de Tickets por Canal

​Tickets por Usuário

​Tickets por Fila

​Tickets por Motivo

​Tickets por Status

​Detalhamento de Tickets por Usuário

​Resposta Padrão

Parâmetros Comuns

Volume e Tempos Gerais

Tickets por Canal

Evolução de Tickets

Evolução de Tickets por Valor

Evolução de Tickets por Canal

Tickets por Usuário

Tickets por Fila

Tickets por Motivo

Tickets por Status

Detalhamento de Tickets por Usuário

Resposta Padrão