Reports — Pipelines Dashboard
URL:
/ou/{orgId}/reports/pipelines
1. Date Picker & Filtros
O date picker altera createdAtFrom/createdAtTo em todos os KPIs. Padrão de datas: ver 05-Endpoints.
| Filtro | Query Param | O que faz |
|---|---|---|
| Período | createdAtFrom={ISO}&createdAtTo={ISO} | Janela temporal dos dados |
| Canal | channel={channelId} | Filtra por canal específico |
| Origem | source={source} | Filtra por origem do lead |
| Pipeline | pipeline={pipelineId} | Filtra por pipeline específico |
2. KPIs — O Que Cada Um Mede
Cada card é clicável e abre /contacts com os filtros aplicados.
2.1 Conversas
O que mede: Total de conversas no período, dividido em Em andamento (status Aberto) e Fechadas.
contacts?createdAtFrom={ISO}&createdAtTo={ISO}&from=overview.conversations
| Sub-métrica | Critério |
|---|---|
| Em andamento | Status = "Aberto" — conversas que ainda não terminaram, incluindo as que a IA continua atendendo |
| Fechadas | Status = "Fechado" — conversas já concluídas |
2.2 Contatos
O que mede: Número de contatos únicos que tiveram conversas no período. Diferente de Conversas (que conta cada thread), este conta cada pessoa uma única vez.
contacts?createdAtFrom={ISO}&createdAtTo={ISO}&from=overview.contacts
2.3 Taxa de Transferência Humana
O que mede: Percentual de conversas que foram transferidas para atendimento humano — tanto por escalação (cliente pediu falar com pessoa) quanto por qualificação (lead demonstrou interesse real e foi passado adiante). Exibe como "X de Y conversas".
contacts?forwardedType=escalated,qualified&createdAtFrom={ISO}&createdAtTo={ISO}&from=overview.humanTransfer
2.4 Qualificadas
O que mede: Subconjunto das transferências humanas — apenas as qualificadas (lead com interesse real), excluindo as escaladas. Mostra quantos leads realmente têm potencial de negócio.
contacts?forwardedType=qualified&createdAtFrom={ISO}&createdAtTo={ISO}&from=overview.qualified
2.5 Objetivo Alcançado
O que mede: Conversas que chegaram aos estágios finais do pipeline — o objetivo da conversa foi atingido (ex: venda fechada, visita agendada, contrato assinado). Os estágios considerados "objetivo" são definidos pela configuração do pipeline.
contacts?pipelineStage={stageIds}&createdAtFrom={ISO}&createdAtTo={ISO}&from=overview.goalAchieved
2.6 Mensagens Automáticas Enviadas
O que mede: Quantidade de follow-ups automáticos disparados pela IA no período, e quantos desses receberam resposta do lead ("Respondidas"). Mede a efetividade do follow-up automático.
contacts?hasAutomatedMessage=1&createdAtFrom={ISO}&createdAtTo={ISO}&from=overview.followups
2.7 Conversas 24h
O que mede: Total de conversas nas últimas 24 horas, dividido em Entrada (inbound) e Saída (outbound). Este KPI ignora o date picker — sempre mostra as últimas 24h independente do período selecionado.
3. Funil de Conversas
Mostra a jornada completa dos leads em formato de funil:
Total de Conversas (100%)
│
├── Objetivo Alcançado
│
├── Não Transferidas (resolvidas pela IA)
│
└── Transferência Humana
│
├── Qualificadas (lead com potencial)
│
└── Escaladas (cliente pediu humano)Toggles de visualização:
| Modo | Descrição |
|---|---|
| Entrada + Saída | Visão combinada inbound + outbound |
| Entrada | Apenas conversas inbound |
| Saída | Apenas conversas outbound |
4. Conversas por Data
Gráfico de linha temporal mostrando a evolução das conversas ao longo do período selecionado.
Toggles:
| Modo | O que mostra |
|---|---|
| Conversas e transferências humanas | Volume de conversas + handoffs |
| Detalhe de tráfego ao longo do tempo | Granularidade fina de tráfego |
| Mensagens automáticas | Follow-ups automáticos enviados |
| Entrada & Saída | Segmentação inbound vs outbound |
5. Distribuição por Pipelines
O que mede: Volume total que passa por cada pipeline e suas etapas. Um mesmo contato é contado uma vez em cada etapa por onde passa — é uma medida de volume, não de contatos únicos.
6. Tráfego por Pipeline
Visualização do fluxo de conversas entre diferentes pipelines, mostrando como os leads se movem entre os fluxos de atendimento.
7. Estado Vazio
Todos os gráficos e KPIs mostram "Sem dados para o período e filtros selecionados" quando não há atividade na janela selecionada.