Panel de ClientFlow

REST API — Todos los endpoints requieren autenticación mediante Bearer token. Incluye Authorization: Bearer {token} en cada solicitud. Los tokens se gestionan en Configuración de GitScrum → API. Base URL: https://services.gitscrum.com — Todas las rutas de solicitud en esta documentación son relativas a esta URL base.

Accede al panel de ClientFlow CRM para pipeline de ingresos, análisis de riesgo de clientes, salud de proyectos e informes cross-workspace.

URL base: https://services.gitscrum.com

Todos los endpoints requieren el header Authorization: Bearer {token}.

Resumen del dashboard

GET /client-flow/dashboard/overview?company_slug={slug}

Devuelve el resumen principal del dashboard de ClientFlow con métricas clave de CRM.

Respuesta

{
  "data": {
    "total_clients": 24,
    "active_projects": 12,
    "revenue_this_month": 45000,
    "pending_invoices": 8,
    "pending_proposals": 3
  }
}

Pipeline de ingresos

GET /client-flow/dashboard/revenue-pipeline?company_slug={slug}

Devuelve el pipeline de ingresos con desglose por estado y datos de pronóstico.

Respuesta

{
  "data": {
    "pipeline": {
      "draft": 25000,
      "sent": 85000,
      "approved": 120000,
      "paid": 340000
    },
    "forecast": {
      "next_30_days": 65000,
      "next_90_days": 180000
    }
  }
}

Clientes en riesgo

GET /client-flow/dashboard/clients-at-risk?company_slug={slug}

Devuelve clientes con facturas vencidas, proyectos inactivos o participación en declive.

Respuesta

{
  "data": [
    {
      "client": {
        "uuid": "client-abc-123",
        "name": "Acme Corp"
      },
      "risk_factors": ["overdue_invoice", "stale_project"],
      "overdue_amount": 12000,
      "last_activity": "2026-01-15T10:00:00Z"
    }
  ]
}

Aprobaciones pendientes

GET /client-flow/dashboard/pending-approvals?company_slug={slug}

Devuelve propuestas y solicitudes de cambio que esperan aprobación.

Salud de proyectos

GET /client-flow/dashboard/projects-health?company_slug={slug}

Devuelve el estado de salud de los proyectos orientados a clientes.

Respuesta

{
  "data": [
    {
      "project": {
        "slug": "web-app-redesign",
        "name": "Web App Redesign"
      },
      "health": "at_risk",
      "budget_usage": 92,
      "overdue_tasks": 5,
      "velocity_trend": "declining"
    }
  ]
}

Insights

GET /client-flow/dashboard/insights?company_slug={slug}

Devuelve insights generados por IA sobre relaciones con clientes y tendencias de ingresos.

Tabla de clasificación

GET /client-flow/dashboard/leaderboard?company_slug={slug}

Devuelve el ranking de rendimiento de los miembros del equipo para trabajo con clientes.

Respuesta

{
  "data": [
    {
      "username": "johndoe",
      "name": "John Doe",
      "revenue_generated": 85000,
      "tasks_completed": 142,
      "client_satisfaction": 4.8
    }
  ]
}

Análisis

GET /client-flow/dashboard/analytics?company_slug={slug}

Devuelve análisis detallados de CRM incluyendo tendencias, tasas de conversión y métricas de retención.

Informes cross-workspace

Agrega datos de todos los workspaces del usuario autenticado.

Los informes cross-workspace requieren una suscripción Pro.

Facturas

GET /client-flow/all-workspaces/invoices

Devuelve informe de facturas de todos los workspaces.

Propuestas

GET /client-flow/all-workspaces/proposals

Devuelve propuestas de todos los workspaces.

Clientes

GET /client-flow/all-workspaces/clients

Devuelve clientes de todos los workspaces.

Solicitudes de cambio

GET /client-flow/all-workspaces/change-requests

Devuelve solicitudes de cambio de todos los workspaces.

Parámetros de query (todos los endpoints cross-workspace)

Respuesta

{
  "data": [],
  "meta": {
    "current_page": 1,
    "per_page": 50,
    "total": 120
  },
  "stats": {
    "total_value": 850000,
    "by_workspace": []
  }
}