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 completas do dashboard do pipeline.

bash

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

200Dashboard completo

json

{
  "data": {
    "total_deals": 42,
    "open_deals": 28,
    "won_deals": 10,
    "lost_deals": 4,
    "total_value": 850000.00,
    "won_value": 320000.00,
    "avg_deal_value": 32000.00,
    "avg_sales_cycle_days": 18,
    "win_rate": 71.4,
    "pipeline_by_stage": [
      { "stage": "Prospeccao", "count": 12, "value": 180000 },
      { "stage": "Qualificacao", "count": 8, "value": 240000 },
      { "stage": "Proposta", "count": 5, "value": 200000 },
      { "stage": "Negociacao", "count": 3, "value": 230000 }
    ]
  }
}

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
`period`(query)	`string`	Nao	Periodo: week, month, quarter, year
`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)
`period`(query)	`string`	Nao	Periodo: week, month, quarter, year

200Metricas de conversao

json

{
  "data": {
    "stage_conversions": [
      { "from": "Prospeccao", "to": "Qualificacao", "rate": 65.0 },
      { "from": "Qualificacao", "to": "Proposta", "rate": 58.3 },
      { "from": "Proposta", "to": "Negociacao", "rate": 72.0 },
      { "from": "Negociacao", "to": "Fechamento", "rate": 80.0 }
    ],
    "overall_conversion": 21.8
  }
}

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).

200Velocidade de vendas

json

{
  "data": {
    "avg_cycle_days": 18,
    "velocity_index": 42500.00,
    "time_per_stage": [
      { "stage": "Prospeccao", "avg_days": 3.2 },
      { "stage": "Qualificacao", "avg_days": 4.5 },
      { "stage": "Proposta", "avg_days": 5.1 },
      { "stage": "Negociacao", "avg_days": 5.2 }
    ]
  }
}

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

Em Desenvolvimento

Este endpoint esta em desenvolvimento e pode nao retornar dados em todas as instalacoes. Requer que existam deals finalizados (ganhos/perdidos) com agentes atribuidos.

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

Performance por membro da equipe.

200Performance da equipe

json

{
  "data": [
    {
      "user_id": 3,
      "name": "Maria Santos",
      "open_deals": 8,
      "won_deals": 5,
      "total_value": 120000,
      "win_rate": 83.3,
      "avg_cycle_days": 15
    },
    {
      "user_id": 5,
      "name": "Joao Silva",
      "open_deals": 12,
      "won_deals": 3,
      "total_value": 85000,
      "win_rate": 60.0,
      "avg_cycle_days": 22
    }
  ]
}

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

Pipeline individual de um membro.

Motivos de Perda

Em Desenvolvimento

Estes endpoints estao em desenvolvimento. Requerem que existam deals marcados como perdidos com motivos de perda preenchidos para retornar dados.

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

Lista motivos de perda registrados.

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

Motivos mais comuns de perda de deals.

200Motivos comuns

json

{
  "data": [
    { "reason": "Preco acima do orcamento", "count": 12, "percentage": 35.3 },
    { "reason": "Escolheu concorrente", "count": 8, "percentage": 23.5 },
    { "reason": "Projeto cancelado", "count": 6, "percentage": 17.6 },
    { "reason": "Sem resposta", "count": 5, "percentage": 14.7 }
  ]
}