# 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

```bash
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.