Cibi Meet API backend-only

Si omites meetingUrl, cb-dio llama a n8n para generar un Google Meet (default). Si lo mandas, debe ser un link de Google Meet, Zoom o Microsoft Teams — otros providers (Webex, Whereby, etc.) son rechazados con 400. Si omites scheduledAt, agenda para ahora mismo. customerInfo.contactName es el único campo realmente obligatorio. meetingPassword es opcional: úsalo si pegas un link de Zoom sin el ?pwd=... embebido; se reenvía a Recall y no se persiste en BD.

curl -X POST https://meet.cibi.clickbalance.net/api/meetings/schedule \
  -H "X-API-Key: $SERVICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "salesRepEmail": "desarrollo03@clickbalance.com",
    "salesRepName": "Emmanuel Hernández",
    "customerInfo": {
      "company": "Acme S.A.",
      "contactName": "Pedro García",
      "dealValue": 50000,
      "dealCurrency": "MXN"
    },
    "scheduledAt": "2026-05-15T15:00:00-06:00"
  }'

{
  "meetingId": "8c1b6e2f-...-...-...-c1f2e3a4b5c6",
  "meetUrl": "https://meet.google.com/abc-defg-hij",
  "scheduledAt": "2026-05-15T15:00:00-06:00",
  "status": "SCHEDULED"
}

Wrapper de compatibilidad: scheduledAt fijo en null y meetingUrl obligatorio (Google Meet, Zoom o Microsoft Teams). meetingPassword opcional para links Zoom "limpios". Para nuevos integradores usa /schedule.

curl -X POST https://meet.cibi.clickbalance.net/api/meetings/start \
  -H "X-API-Key: $SERVICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "meetingUrl": "https://meet.google.com/qxb-xdam-uae",
    "salesRepEmail": "desarrollo03@clickbalance.com",
    "customerInfo": { "contactName": "Pedro García" }
  }'

{
  "meetingId": "8c1b6e2f-...-c1f2e3a4b5c6",
  "meetUrl": "https://meet.google.com/qxb-xdam-uae",
  "scheduledAt": null,
  "status": "JOINING"
}

Non-admin ve sus propias + reuniones meeting_type en (general, standup, tecnica, documentacion, planificacion) ajenas (read-only). Admin ve todo. status: SCHEDULED|JOINING|IN_PROGRESS|PROCESSING|COMPLETED|FAILED|CANCELLED. search: busca en title, company y contactName.

curl "https://meet.cibi.clickbalance.net/api/meetings?page=1&limit=20&status=COMPLETED&search=Acme&salesRepEmail=desarrollo03@clickbalance.com" \
  -H "X-API-Key: $SERVICE_API_KEY"

{
  "data": [
    {
      "id": "8c1b6e2f-...",
      "sales_rep_id": "uuid|null",
      "created_by_rep_id": "uuid|null",
      "meeting_url": "https://meet.google.com/abc-defg-hij",
      "platform": "Google Meet",
      "customer_info": {
        "company": "Acme S.A.",
        "contactName": "Pedro García",
        "dealValue": 50000,
        "dealCurrency": "MXN",
        "dealValueDisplay": "$50,000 MXN"
      },
      "status": "COMPLETED",
      "error_code": null,
      "error_message": null,
      "meeting_type": "ventas",
      "started_at": "2026-05-15T15:00:00-06:00",
      "started_at_formatted": "15 may 2026, 15:00",
      "video_duration_minutes": 47,
      "duration": "47 min",
      "sales_reps": { "id": "uuid", "name": "Vendedor", "email": "..." },
      "created_by": { "id": "uuid", "name": "Quien programó", "email": "..." }
    }
  ],
  "total": 1,
  "page": 1
}

Devuelve TODO lo necesario para renderizar la página de detalle del dashboard en una sola request. Las URLs firmadas (video/audio) son válidas por 1h.

curl "https://meet.cibi.clickbalance.net/api/meetings/8c1b6e2f-..." \
  -H "X-API-Key: $SERVICE_API_KEY"

{
  "meeting": { "id": "...", "status": "COMPLETED", "customer_info": {...}, ... },
  "transcript": {
    "id": "...",
    "language": "es",
    "raw_transcript": [
      { "speaker": "Orador 0 (Emmanuel)", "text": "Hola Pedro...", "start_ms": 0, "end_ms": 3200 }
    ],
    "full_text": "Hola Pedro... [transcript completo]"
  },
  "media": {
    "videoUrl": "https://...supabase.co/storage/v1/sign/...",
    "audioUrl": "https://...supabase.co/storage/v1/sign/...",
    "expiresAt": "2026-05-15T16:00:00.000Z"
  },
  "analyses": [
    {
      "summary": "...",
      "action_items": [...],
      "sales_rep_score": 78,
      "score_breakdown": { "scores": {...}, "justifications": {...}, "meeting_type": "ventas" },
      "opportunities": [...],
      "close_probability": 70,
      "key_objections": [...],
      "next_steps": "...",
      "participation": {
        "rep_identified": true,
        "total_speaking_seconds": 1842,
        "participants": [
          { "name": "Juan Pérez",  "email": "juan@clickbalance.com", "role": "rep",   "speaking_seconds": 1102, "percentage": 59.8 },
          { "name": "Pedro García","email": "pedro@acme.com",         "role": "guest", "speaking_seconds": 580,  "percentage": 31.5 },
          { "name": "María López", "email": null,                     "role": "guest", "speaking_seconds": 160,  "percentage": 8.7 }
        ]
      }
    }
  ]
}

Solo funciona en estado SCHEDULED. Si la reunión ya empezó (JOINING/IN_PROGRESS/etc.), responde 409 INVALID_STATE.

curl -X DELETE "https://meet.cibi.clickbalance.net/api/meetings/8c1b6e2f-...?salesRepEmail=desarrollo03@clickbalance.com" \
  -H "X-API-Key: $SERVICE_API_KEY"

{ "ok": true, "status": "CANCELLED" }

Re-corre el pipeline IA contra la customer_info y meeting_type actuales. Body completamente opcional: si se omite, el subtipo se autodetecta. Si se pasa sales_subtype, se usa ese valor en lugar del autodetectado — solo válido cuando meeting_type === 'ventas'. El análisis anterior queda intacto hasta que el cron termina y hace upsert del nuevo.

curl -X POST "https://meet.cibi.clickbalance.net/api/meetings/8c1b6e2f-.../reanalyze" \
  -H "X-API-Key: $SERVICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "sales_subtype": "demostracion" }'

{
  "jobId": "uuid-del-job",
  "meetingId": "8c1b6e2f-...",
  "status": "PROCESSING"
}

curl -X PATCH "https://meet.cibi.clickbalance.net/api/me?salesRepEmail=desarrollo03@clickbalance.com" \
  -H "X-API-Key: $SERVICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Emmanuel Hernández" }'

{
  "id": "uuid-del-rep",
  "email": "desarrollo03@clickbalance.com",
  "name": "Emmanuel Hernández",
  "created_at": "2026-04-29T..."
}

Suma reuniones COMPLETED, promedia scores, estima close rate (close_probability >= 60), y rescata top oportunidades de las 5 reuniones más recientes.

curl "https://meet.cibi.clickbalance.net/api/sales-reps/<rep-id>/performance?salesRepEmail=desarrollo03@clickbalance.com" \
  -H "X-API-Key: $SERVICE_API_KEY"

{
  "salesRepId": "uuid",
  "name": "Emmanuel Hernández",
  "totalMeetings": 12,
  "avgScore": 76,
  "estimatedCloseRate": 58,
  "topOpportunities": ["Cliente abierto a multi-año", "Interés en módulo X", ...],
  "recentMeetings": [...]
}

Vercel lo dispara automáticamente cada minuto. Para probar manualmente desde Postman necesitas el CRON_SECRET como Bearer.

curl https://meet.cibi.clickbalance.net/api/cron/process-queue \
  -H "Authorization: Bearer $CRON_SECRET"

{ "processed": 3, "failed": 0 }

Respuesta en streaming SSE (Content-Type: text/event-stream): cero o más frames data: {"delta":"..."} con los tokens, y un frame final data: {"done":true,"message_id":"uuid"}. El message_id es el source_ref para el feedback 👍/👎. Si el run falla después de abrir el stream, sale data: {"error":true,"code":"..."}. El body lleva question (string).

curl -N -X POST "https://meet.cibi.clickbalance.net/api/meetings/<id>/agents/seguimiento_general/messages?salesRepEmail=desarrollo03@clickbalance.com" \
  -H "X-API-Key: $SERVICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "question": "¿Qué compromisos quedaron pendientes?" }'

data: {"delta":"Quedaron "}
data: {"delta":"dos compromisos: enviar la cotización..."}
data: {"done":true,"message_id":"8c1b6e2f-..."}