Skip to main content
POST
https://sac-waffle-v2.theo-110.workers.dev
/
support
/
relatorios
/
detalhado
curl -X POST "https://sac-waffle-v2.theo-110.workers.dev/support/relatorios/detalhado" \
  -H "Authorization: Bearer seu_token_jwt" \
  -H "Content-Type: application/json" \
  -d '{
    "data_inicio": "2024-01-01",
    "data_fim": "2024-01-31"
  }'

{
  "success": true,
  "data": {
    "dashboard": {
      "totalTickets": 342,
      "ticketsByStatus": {"open": 44, "in_progress": 23, "resolved": 198, "closed": 77},
      "ticketsByCategory": {...},
      "resolutionMetrics": {...},
      "ticketTrend": [...]
    },
    "agentPerformance": [
      {
        "agente": "[email protected]",
        "ticketsRespondidos": 89,
        "ticketsResolvidos": 72,
        "tempoMedioResposta": "45min",
        "tempoMedioResolucao": "3h 20min",
        "taxaResolucao": 80.9,
        "mensagensEnviadas": 234
      }
    ],
    "issueTrends": [
      {
        "issue": "Não recebi meus pontos",
        "main": "Programa de indicação e prêmios",
        "total": 78,
        "tendencia": "subindo",
        "variacaoPercentual": 15.3
      }
    ],
    "distribution": {
      "porHora": [...],
      "porDiaSemana": [...],
      "porNewsletter": [...]
    },
    "filters": {
      "dataInicio": "2024-01-01",
      "dataFim": "2024-01-31",
      "main": "Programa de indicação e prêmios"
    },
    "metadata": {
      "geradoEm": "2024-01-15T10:30:00.000Z",
      "versao": "2.0"
    }
  },
  "cache": {
    "hit": false
  }
}

​
Descrição

Gera um relatório detalhado com todos os filtros disponíveis, incluindo opcionalmente métricas por agente, tendências de issues e análise de cohorts. Este endpoint utiliza cache KV com TTL de 2 horas.

​
Headers

​
Authorization
string
required
Bearer token JWT para autenticação

​
Body Parameters

​
data_inicio
string
required
Data de início do período (formato: YYYY-MM-DD)
​
data_fim
string
required
Data de fim do período (formato: YYYY-MM-DD)
​
main
string
Filtrar por categoria principal
​
issue
string
Filtrar por issue específico
​
status
string
Filtrar por status do ticket
​
newsletter
string
Filtrar por newsletter relacionada
​
agente
string
Filtrar por email do agente responsável
​
tag_id
number
Filtrar por ID da tag
​
agrupar_por
string
default:"dia"
Agrupamento temporalValores aceitos: hora, dia, semana, mes, ano
​
incluir_agentes
boolean
default:"false"
Incluir métricas de performance por agente
​
incluir_tendencias
boolean
default:"false"
Incluir tendências de issues ao longo do tempo
​
incluir_cohorts
boolean
default:"false"
Incluir análise de cohorts
​
comparar_periodo_anterior
boolean
default:"false"
Comparar com período anterior equivalente

​
Response

​
success
boolean
required
Indica se a operação foi bem-sucedida
​
data
object
​
cache
object
Informações de cache (hit, age, expiresIn)
curl -X POST "https://sac-waffle-v2.theo-110.workers.dev/support/relatorios/detalhado" \
  -H "Authorization: Bearer seu_token_jwt" \
  -H "Content-Type: application/json" \
  -d '{
    "data_inicio": "2024-01-01",
    "data_fim": "2024-01-31"
  }'

{
  "success": true,
  "data": {
    "dashboard": {
      "totalTickets": 342,
      "ticketsByStatus": {"open": 44, "in_progress": 23, "resolved": 198, "closed": 77},
      "ticketsByCategory": {...},
      "resolutionMetrics": {...},
      "ticketTrend": [...]
    },
    "agentPerformance": [
      {
        "agente": "[email protected]",
        "ticketsRespondidos": 89,
        "ticketsResolvidos": 72,
        "tempoMedioResposta": "45min",
        "tempoMedioResolucao": "3h 20min",
        "taxaResolucao": 80.9,
        "mensagensEnviadas": 234
      }
    ],
    "issueTrends": [
      {
        "issue": "Não recebi meus pontos",
        "main": "Programa de indicação e prêmios",
        "total": 78,
        "tendencia": "subindo",
        "variacaoPercentual": 15.3
      }
    ],
    "distribution": {
      "porHora": [...],
      "porDiaSemana": [...],
      "porNewsletter": [...]
    },
    "filters": {
      "dataInicio": "2024-01-01",
      "dataFim": "2024-01-31",
      "main": "Programa de indicação e prêmios"
    },
    "metadata": {
      "geradoEm": "2024-01-15T10:30:00.000Z",
      "versao": "2.0"
    }
  },
  "cache": {
    "hit": false
  }
}