Reports — Endpoints & Query Parameters

Base URL: /ou/{orgId}/contacts Cada KPI card tem um link "Abrir estes contatos em uma nova aba" que revela os parâmetros exatos.

---

0. Date Picker & Query Parameters

A seleção de período altera createdAtFrom e createdAtTo em TODOS os endpoints:

Período	createdAtFrom	createdAtTo
Hoje	Hoje T{tzOffset}:00:00.000Z	Hoje+2 T{tzOffset-1}:59:59.999Z
7d	Hoje-7 T{tzOffset}:00:00.000Z	Hoje+1 T{tzOffset-1}:59:59.999Z
30d	Hoje-30 T{tzOffset}:00:00.000Z	Hoje+1 T{tzOffset-1}:59:59.999Z
90d	Hoje-90 T{tzOffset}:00:00.000Z	Hoje+1 T{tzOffset-1}:59:59.999Z
Datas específicas	Data inicial T{tzOffset}:00:00.000Z	Data final+1 T{tzOffset-1}:59:59.999Z

{tzOffset} = offset do fuso horário do workspace (ex: 03 para UTC-3). O date picker altera APENAS createdAtFrom/createdAtTo — todos os outros parâmetros são fixos por KPI.

Exemplo real (7d, UTC-3):createdAtFrom=2026-07-09T03:00:00.000Z&createdAtTo=2026-07-17T02:59:59.999Z

---

1. Pipelines Dashboard (/reports/pipelines)

1.1 Conversas (from=overview.conversations)

O que mede: Total de conversas no período, dividido em Em andamento (Aberto) e Fechadas. Query: contacts?createdAtFrom={ISO}&createdAtTo={ISO}&from=overview.conversations

1.2 Contatos (from=overview.contacts)

O que mede: Contatos únicos com conversas no período. Diferente de Conversas, conta cada contato uma única vez. Query: contacts?createdAtFrom={ISO}&createdAtTo={ISO}&from=overview.contacts

1.3 Taxa de Transferência Humana (from=overview.humanTransfer)

O que mede: % de conversas transferidas para humano (escaladas OU qualificadas). Query: contacts?forwardedType=escalated,qualified&createdAtFrom={ISO}&createdAtTo={ISO}&from=overview.humanTransfer

1.4 Qualificadas (from=overview.qualified)

O que mede: Subconjunto de transferências — apenas as qualificadas (lead com interesse real), sem as escaladas. Query: contacts?forwardedType=qualified&createdAtFrom={ISO}&createdAtTo={ISO}&from=overview.qualified

1.5 Objetivo Alcançado (from=overview.goalAchieved)

O que mede: Conversas que chegaram aos estágios finais do pipeline (ex: venda fechada). Query: contacts?pipelineStage={stageIds}&createdAtFrom={ISO}&createdAtTo={ISO}&from=overview.goalAchievedFixos: pipelineStage={stageIds} — IDs dos estágios considerados "objetivo".

1.6 Mensagens Automáticas (from=overview.followups)

O que mede: Follow-ups automáticos enviados e quantos receberam resposta do lead. Query: contacts?hasAutomatedMessage=1&createdAtFrom={ISO}&createdAtTo={ISO}&from=overview.followupsFixos: hasAutomatedMessage=1

1.7 Conversas 24h

O que mede: Total inbound/outbound nas últimas 24h. NÃO usa o date picker — sempre últimas 24h.

Funil de Conversas

Etapas: Total → Objetivo Alcançado → Não Transferidas → Transferência Humana → Qualificadas → Escaladas

---

2. Desempenho do Equipe (/reports/team)

KPI	Descrição
Atribuídas à equipe	Conversas atribuídas no período
Por resolver	Aguardando ação da equipe
Resolvidas	Concluídas
Tempo 1ª resposta (24/7)	Média em minutos
Tempo médio resposta (24/7)	Média em minutos

Tabela de Membros

Coluna	Descrição
Membro	Nome
Horário	Ex: 09:00-18:00 (dias da semana)
Atribuídas / Por resolver / Resolvidos / Trabalhadas	Contagens
Templates	Templates usados
Fora hr.	Atendimentos fora do horário
1ª resp. / Resp. méd. / Resolução	Tempos

---

3. Canais (/reports/channels)

KPI Card	from=	Params Adicionais
Conversas em canais	channels.conversations	channel={channelId}
Contatos	channels.contacts	channel={channelId}
Transf. Humanas	channels.humanTransfer	forwardedType=escalated,qualified&channel={channelId}
Qualificadas	channels.qualified	forwardedType=qualified&channel={channelId}
Objetivo Alcançado	channels.goalAchieved	pipelineStage={stageIds}&channel={channelId}
Msg Automáticas	channels.followups	hasAutomatedMessage=1&channel={channelId}

Métricas por Canal

Métrica	Descrição
Conversas	Total
Não transferidas	Sem handoff
Transferências humanas	Handoffs
Msg Enviadas	Outbound
Msg Recebidas	Inbound

---

4. Qualidade da IA (/reports/audit)

KPI	Descrição
Conversas Auditadas	Total revisadas
Taxa de Conclusão	% concluídas
Conversas Não Auditadas	Pendentes

Desempenho por Variável (Rating 1-5★)

Variável	Descrição
Informação Correta	Precisão factual
Jornada do Usuário	Adequação ao fluxo
Tom e Estilo da IA	Qualidade do tom

Tabela de Auditoria

Coluna	Descrição
Cliente	ID/telefone
Auditor	AI ou humano
Data da Auditoria	Timestamp
Informação Correta	1-5★
Jornada do Usuário	1-5★
Tom e Estilo da IA	1-5★
Comentários	Observações detalhadas

Grounding (Mensagens Corrigidas)

KPI	Meta
Mensagens corrigidas	—
Total mensagens IA	—
Taxa de correção	< 10%

---

5. Resumo de Query Parameters

Param	Tipo	Valores	Usado em
createdAtFrom	ISO 8601	{ISO}	Todos
createdAtTo	ISO 8601	{ISO}	Todos
from	string	overview.* / channels.*	Todos
forwardedType	string	escalated, qualified	humanTransfer, qualified
pipelineStage	CSV	{stageId1},{stageId2}	goalAchieved
hasAutomatedMessage	1	1	followups
channel	int	{channelId}	Channels report