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 entero es opcional: la reunión puede nacer sin cliente —es lo que hace el botón «Grabar reunión» del panel, porque al entrar a la llamada el contacto muchas veces todavía no existe en HubSpot— y se completa después por PATCH. Si lo mandas, dentro son obligatorios contactName y al menos uno de contactEmail o phone: es con lo que la reunión se liga a su cliente en HubSpot, y sin ninguno de los dos se quedaría sin cliente para siempre. El phone es la salida para el contacto de mensajería, que no tiene correo — se guarda tal cual llega (basta con que traiga diez dígitos; no hace falta forzar +52). 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",
      "contactEmail": "pedro@acme.com",
      "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. Mismas reglas de customerInfo que /schedule: es opcional entero, y si lo mandas van contactName y al menos uno de contactEmail o phone — el ejemplo usa el teléfono, que es el caso del contacto de mensajería.

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/abc-defg-hij",
    "salesRepEmail": "desarrollo03@clickbalance.com",
    "customerInfo": { "contactName": "Pedro García", "phone": "+52 33 1020 0206" }
  }'

{
  "meetingId": "8c1b6e2f-...-c1f2e3a4b5c6",
  "meetUrl": "https://meet.google.com/abc-defg-hij",
  "scheduledAt": null,
  "status": "JOINING"
}

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

Polling incremental — ?analysisUpdatedSince=<valor>: el mismo parámetro acepta dos cosas: (a) un ISO 8601 (offset permitido) en la primera llamada, o (b) el cursor opaco nextSince devuelto por una llamada anterior — se manda tal cual, sin interpretarlo. Cualquier otro valor responde 400 VALIDATION_ERROR, nunca filtra en silencio.

Devuelve, en orden ASCENDENTE por effectiveUpdatedAt (el campo que se agrega a cada item en este modo), las reuniones cuyo analyses.updated_at avanzó desde ese instante, más las FAILED cuyo ended_at cae en la ventana (esas no tienen fila en analyses; effectiveUpdatedAt en ese caso ES el ended_at). Las FAILED sin ended_at quedan afuera: no hay timestamp que comparar.

Semántica de borde: con un ISO 8601, la comparación es >= (inclusiva). Con un cursor nextSince, es ESTRICTAMENTE POSTERIOR al par (effectiveUpdatedAt, meetingId) que codifica — así un backfill con miles de filas con el mismo updated_at avanza igual en vez de repetir siempre el mismo lote.

nextSince en la respuesta: viene SOLO cuando hay más por traer. Ausente o null significa "estás al día" — no hace falta comparar nada más, sólo repetir la consulta más tarde con el mismo analysisUpdatedSince. No hay un tope fijo de candidatos: el pre-filtro pide limit + 1 filas a cada fuente (analyses / FAILED), así que el .in() de la query principal nunca lleva más de limit ids — esto es a propósito: con un tope fijo de 500 el .in() podía superar el límite de tamaño de headers de PostgREST (~16 KB) y la respuesta era 500 DB_ERROR en vez de datos.

?updatedSince=<valor>: la variante que además detecta cambios de la FILA de la reunión (título, customer_info, status, responsable) vía meetings.updated_at. Mismo formato de valor, mismo cursor, misma respuesta. analysisUpdatedSince se queda como está —sólo análisis y fallos— para no cambiarle el resultado en silencio a quien ya lo usa; mandar los dos a la vez responde 400. Si una reunión cambió en más de una fuente se fecha con el timestamp más ANTIGUO, así que puede repetirse entre pasadas. La garantía es «nunca se salta una reunión», no «sale una sola vez»: el consumidor tiene que ser idempotente.

Sin ninguno de los dos, el listado no cambia: sigue ordenado por created_at DESC y sin effectiveUpdatedAt ni nextSince.

Verificado contra producción el 2026-08-12 con el algoritmo anterior: una ventana de 517 reuniones cambiadas se recorrió en 3 llamadas encadenadas (limit=200: 200 + 200 + 117, la última con nextSince ausente), sin ids faltantes. El «sin ids repetidos» de esa corrida ya no es una promesa del contrato: la regla de dedupe cambió para no saltarse reuniones, y el precio es que una puede repetirse entre pasadas.

curl "https://meet.cibi.clickbalance.net/api/meetings?analysisUpdatedSince=2026-08-10T00:00:00Z&limit=200" \
  -H "X-API-Key: $SERVICE_API_KEY"

# Siguiente llamada: reusar nextSince tal cual, sin interpretarlo
curl "https://meet.cibi.clickbalance.net/api/meetings?analysisUpdatedSince=eyJ2IjoxLCJ1IjoiMjAyNi0wOC0xMFQxNjoyOToyOC43MTU5NTUrMDA6MDAiLCJpZCI6ImZkZGUyNDM0LTkyY2MtNDE0Ni04NjYwLWRkYjFkZDg5NmExYyJ9" \
  -H "X-API-Key: $SERVICE_API_KEY"

// Capturada contra producción el 2026-08-12 (limit=2). customer_info y
// los datos de los reps y las URLs de Meet están anonimizados a mano; ids, timestamps,
// effectiveUpdatedAt y nextSince son exactamente lo que devolvió el servidor.
{
  "data": [
    {
      "id": "45e74186-5275-4cab-8068-078a4d52660c",
      "sales_rep_id": "af5abdee-6da5-4b1c-b157-429c61d94802",
      "created_by_rep_id": "af5abdee-6da5-4b1c-b157-429c61d94802",
      "meeting_url": "https://meet.google.com/abc-defg-hij",
      "platform": "Google Meet",
      "customer_info": {
        "company": "Acme S.A.",
        "contactName": "Persona de Contacto",
        "contactEmail": "contacto@ejemplo.com",
        "dealValue": 0,
        "dealCurrency": "MXN",
        "dealValueDisplay": "$0 MXN"
      },
      "status": "COMPLETED",
      "error_code": null,
      "error_message": null,
      "meeting_type": "general",
      "started_at": "2026-08-10T15:58:02.432161+00:00",
      "sales_reps": { "id": "af5abdee-...", "name": "Vendedor Ejemplo", "email": "vendedor@clickbalance.com" },
      "created_by": { "id": "af5abdee-...", "name": "Vendedor Ejemplo", "email": "vendedor@clickbalance.com" },
      "analyses": { "sales_subtype": null, "sales_rep_score": null, "close_probability": null },
      "effectiveUpdatedAt": "2026-08-10T16:14:18.56274+00:00"
    },
    {
      "id": "fdde2434-92cc-4146-8660-ddb1dd896a1c",
      "sales_rep_id": "60a84387-e134-4eb6-80b5-1d9c4dd47402",
      "created_by_rep_id": "60a84387-e134-4eb6-80b5-1d9c4dd47402",
      "meeting_url": "https://meet.google.com/klm-nopq-rst",
      "platform": "Google Meet",
      "customer_info": { "dealCurrency": "MXN", "dealValueDisplay": "$0 MXN" },
      "status": "COMPLETED",
      "error_code": null,
      "error_message": null,
      "meeting_type": "planificacion",
      "title": "Reunión de planificación semanal",
      "started_at": "2026-08-07T17:22:10.261504+00:00",
      "sales_reps": { "id": "60a84387-...", "name": "Organizador Ejemplo", "email": "organizador@clickbalance.com" },
      "created_by": { "id": "60a84387-...", "name": "Organizador Ejemplo", "email": "organizador@clickbalance.com" },
      "analyses": { "sales_subtype": null, "sales_rep_score": null, "close_probability": null },
      "effectiveUpdatedAt": "2026-08-10T16:29:28.715955+00:00"
    }
  ],
  "total": 2,
  "page": 1,
  "nextSince": "eyJ2IjoxLCJ1IjoiMjAyNi0wOC0xMFQxNjoyOToyOC43MTU5NTUrMDA6MDAiLCJpZCI6ImZkZGUyNDM0LTkyY2MtNDE0Ni04NjYwLWRkYjFkZDg5NmExYyJ9"
}

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. Aplica a cualquier meeting_type: el único requisito es que la reunión ya tenga transcripción. Body completamente opcional: si se omite —o si se manda sales_subtype: "auto"— el subtipo se autodetecta. Si se pasa un subtipo concreto, se usa ese en lugar del autodetectado, y eso sí requiere 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-..."}