Relatorios da conta e metricas de atendimento

A API de relatorios permite consumir indicadores da operacao de atendimento quando o usuario autenticado tem permissao.

Rotas principais

Recurso	Rota
Relatorios gerais	`/api/v2/accounts/:account_id/reports`
Sumario	`/api/v2/accounts/:account_id/reports/summary`
Conversas	`/api/v2/accounts/:account_id/reports/conversations`
Eventos de reporting	`/api/v1/accounts/:account_id/reporting_events`
Sumario por agente	`/api/v2/accounts/:account_id/summary_reports/agent`
Sumario por time	`/api/v2/accounts/:account_id/summary_reports/team`
Sumario por inbox	`/api/v2/accounts/:account_id/summary_reports/inbox`
Sumario por canal	`/api/v2/accounts/:account_id/summary_reports/channel`

Exemplo

curl -X GET "$BASE_URL/api/v2/accounts/$ACCOUNT_ID/reports?type=account&metric=conversations_count" \
  -H "api_access_token: $API_TOKEN"

Relatorios complementares

A documentacao oficial tambem traz relatorios como distribuicao de primeira resposta por canal, matriz inbox-label e mensagens enviadas agrupadas por agente, time, inbox ou etiqueta.

Boas praticas

Extraia em janelas de data, consolide em banco proprio para BI e evite chamar relatorios pesados em toda abertura de dashboard.