Pipeline Analytics

Metricas detalhadas do pipeline de vendas: dashboard, win rate, velocidade de vendas, analise de conversao e performance da equipe.

Dashboard

GET/api/v1/accounts/{account_id}/pipeline/analytics/dashboard

Metricas agregadas do dashboard do pipeline (win rate, velocidade, distribuicao de leads e resumo).

Parametros

Nome	Tipo	Obrigatorio	Descricao
`start_date`(query)	`string`	Nao	Inicio do periodo (ISO 8601). Padrao: 30 dias atras.
`end_date`(query)	`string`	Nao	Fim do periodo (ISO 8601). Padrao: agora.

bash

curl -s "https://chat.seudominio.com/api/v1/accounts/1/pipeline/analytics/dashboard" \
  -H "api_access_token: YOUR_TOKEN" | jq .

200Dashboard agregado (resposta nao envolta em data)

json

{
  "win_rate": { "...": "metricas de WinRateCalculator" },
  "sales_velocity": { "...": "metricas de SalesVelocityCalculator" },
  "lead_distribution": {
    "hot": 8, "warm": 18, "cold": 16,
    "average": 52.3, "total": 42, "filter": "all_time"
  },
  "pipeline_summary": {
    "total_open": 28, "total_won": 10, "total_lost": 4, "total_items": 42,
    "filter": "all_time",
    "all_time": { "total_open": 28, "total_won": 10, "total_lost": 4, "total_items": 42 },
    "in_period": { "total_open": 12, "total_won": 5, "total_lost": 2, "total_items": 19 }
  },
  "period": { "start_date": "2026-01-01T00:00:00Z", "end_date": "2026-01-31T23:59:59Z" }
}

Win Rate

GET/api/v1/accounts/{account_id}/pipeline/analytics/win_rate

Analise de taxa de conversao (ganhos vs perdidos).

Parametros

Nome	Tipo	Obrigatorio	Descricao
`start_date`(query)	`string`	Nao	Inicio do periodo (ISO 8601). Padrao: 30 dias atras.
`end_date`(query)	`string`	Nao	Fim do periodo (ISO 8601). Padrao: agora.
`pipeline_id`(query)	`integer`	Nao	Filtrar por pipeline

Metricas de Conversao

GET/api/v1/accounts/{account_id}/pipeline/analytics/conversion_metrics

Taxa de conversao entre estagios do pipeline.

Parametros

Nome	Tipo	Obrigatorio	Descricao
`pipeline_id`(query)	`integer`	Sim	ID do pipeline (obrigatorio — sem ele retorna 422)
`start_date`(query)	`string`	Nao	Inicio do periodo (ISO 8601)
`end_date`(query)	`string`	Nao	Fim do periodo (ISO 8601)

Resposta direta

A resposta deste endpoint nao e envolta em data — o corpo JSON retornado pelo servico de calculo e renderizado diretamente. O exemplo abaixo e ilustrativo; os campos exatos dependem da versao do ConversionMetricsService.

Velocidade de Vendas

GET/api/v1/accounts/{account_id}/pipeline/analytics/sales_velocity

Analise de velocidade do pipeline (tempo medio por estagio, ciclo de vendas).

Parametros

Nome	Tipo	Obrigatorio	Descricao
`pipeline_id`(query)	`integer`	Nao	Filtrar por pipeline
`start_date`(query)	`string`	Nao	Inicio do periodo (ISO 8601)
`end_date`(query)	`string`	Nao	Fim do periodo (ISO 8601)

Resposta direta

A resposta e o corpo retornado pelo SalesVelocityCalculator, renderizado diretamente (sem wrapper data). Os campos exatos dependem da versao do servico.

Analise Completa

GET/api/v1/accounts/{account_id}/pipeline/analytics/pipeline_analysis

Analise abrangente do pipeline com tendencias e previsoes.

Parametros

Nome	Tipo	Obrigatorio	Descricao
`pipeline_id`(query)	`integer`	Sim	ID do pipeline (obrigatorio)

Performance da Equipe

GET/api/v1/accounts/{account_id}/pipeline/analytics/team_pipeline

Performance por membro da equipe (agentes e administradores da conta).

200Performance da equipe

json

{
  "team": [
    {
      "user_id": 3,
      "user_name": "Maria Santos",
      "avatar_url": "https://...",
      "pipeline_value": 120000.0,
      "deals_count": 8,
      "conversion_rate": 83.3,
      "hot_leads": 5
    }
  ],
  "totals": {
    "total_pipeline_value": 205000.0,
    "total_deals": 20,
    "average_conversion_rate": 71.6,
    "total_hot_leads": 8
  },
  "top_performer": { "user_id": 3, "user_name": "Maria Santos" },
  "team_size": 2,
  "updated_at": "2026-01-31T12:00:00Z"
}

GET/api/v1/accounts/{account_id}/pipeline/analytics/pipeline/{user_id}

Pipeline individual de um membro.

200Pipeline do usuario (resposta direta, sem wrapper data)

json

{
  "user_id": 3,
  "user_name": "Maria Santos",
  "pipeline": { "total_value": 120000.0, "deals_count": 8, "hot_leads": 5, "warm_leads": 2, "cold_leads": 1 },
  "conversion_rate": 83.3,
  "average_deal_size": 15000.0,
  "won_this_month": 45000.0,
  "forecast": 99960.0
}

Motivos de Perda

GET/api/v1/accounts/{account_id}/pipeline/deal_status/lost_reasons

Analise dos motivos de perda registrados no periodo.

Parametros

Nome	Tipo	Obrigatorio	Descricao
`start_date`(query)	`string`	Nao	Inicio do periodo (ISO 8601). Padrao: 30 dias atras.
`end_date`(query)	`string`	Nao	Fim do periodo (ISO 8601). Padrao: agora.

GET/api/v1/accounts/{account_id}/pipeline/deal_status/common_reasons

Motivos comuns de perda de deals.

200Motivos comuns (chave reasons)

json

{
  "reasons": [
    "Preco acima do orcamento",
    "Escolheu concorrente",
    "Projeto cancelado",
    "Sem resposta"
  ]
}