Chuyển tới nội dung chính

7. Phân Tích & Báo Cáo

7.1 Lấy Ph漏斗 Chuyển Đổi​

GET /api/v1/analytics/conversion-funnel

Lấy số liệu ph漏斗 chuyển đổi.

Tham Số Truy Vấn:

  • dateFrom - Ngày bắt đầu
  • dateTo - Ngày kết thúc
  • groupBy - Nhóm theo: day, week, month

Phản hồi:

{
  "period": {
    "from": "2026-06-01T00:00:00Z",
    "to": "2026-06-05T23:59:59Z"
  },
  "stages": [
    {
      "name": "Lead",
      "count": 500,
      "percentage": 100
    },
    {
      "name": "Đã Xác Thực",
      "count": 350,
      "percentage": 70
    },
    {
      "name": "Đề Xuất",
      "count": 100,
      "percentage": 20
    },
    {
      "name": "Khách Hàng",
      "count": 35,
      "percentage": 7
    }
  ],
  "conversionRate": 0.07
}

7.2 Lấy Hiệu Suất Đội​

GET /api/v1/analytics/team-performance

Lấy số liệu và thống kê đội.

Tham Số Truy Vấn:

  • dateFrom - Ngày bắt đầu
  • dateTo - Ngày kết thúc
  • departmentId - Lọc theo phòng ban (tùy chọn)

Phản hồi:

{
  "period": { "from": "2026-06-01", "to": "2026-06-05" },
  "team": [
    {
      "userId": "user-123",
      "name": "Nguyễn Văn A",
      "contactsAssigned": 45,
      "messagesReplied": 120,
      "averageResponseTime": 3.5,
      "conversionRate": 0.11,
      "revenueGenerated": 12500
    }
  ],
  "teamTotal": {
    "contactsAssigned": 450,
    "messagesReplied": 1200,
    "conversionRate": 0.08,
    "revenueGenerated": 95000
  }
}

7.3 Lấy Phân Tích Thời Gian Phản Hồi​

GET /api/v1/analytics/response-time

Lấy số liệu thời gian phản hồi.

Phản hồi:

{
  "averageFirstResponseTime": 4.2,
  "averageResolutionTime": 24.5,
  "medianResponseTime": 3.1,
  "percentile95": 15.2,
  "percentile99": 45.0,
  "onTimeRate": 0.87
}

7.4 Tạo Báo Cáo Tùy Chỉnh​

POST /api/v1/analytics/custom

Tạo báo cáo phân tích tùy chỉnh.

Thân Yêu Cầu:

{
  "name": "Báo Cáo Bán Hàng Q2",
  "metrics": ["revenue", "lead_count", "conversion_rate"],
  "dimensions": ["source", "assignedUser"],
  "dateFrom": "2026-04-01T00:00:00Z",
  "dateTo": "2026-06-30T23:59:59Z",
  "filters": [
    { "field": "status", "operator": "equals", "value": "customer" }
  ]
}

Phản hồi: 201

{
  "id": "report-001",
  "name": "Báo Cáo Bán Hàng Q2",
  "status": "generating",
  "createdAt": "2026-06-05T17:35:00Z",
  "downloadUrl": "https://api.domaincrm.com/reports/report-001"
}