Contrato de API · developers

Lo que la API realmente devuelve.

Esta página existe para que tu equipo de ingeniería vea los payloads antes de hablar con ventas. Cinco respuestas con tipos, semántica y caveats — el contrato real, no marketing.

Documentación completa Hablar con ingeniero →

Outputs reales

Lo que la API realmente devuelve.

Cinco respuestas reales del contrato VEXKIO. Cada una indica qué es inferencia probabilística, qué es score derivado y qué es guidance para operador humano.

Engagement score

POST /v1/sessions/{id}/events

score · probabilístico

Score 0–1 por ventana 1 s. Inferencia probabilística — no es una métrica calibrada de salud mental.

{
  "session_id": "ses_3pYg…",
  "window_start_ms": 1690000,
  "window_end_ms": 1691000,
  "engagement": 0.82,
  "vexkio_5": "apertura",
  "confidence": 0.71,
  "source_modalities": ["face", "voice"],
  "produced_at": "2026-04-30T15:33:12.314Z"
}

Friction flag

POST /v1/sessions/{id}/events

flag · derivado

Flag binario que se eleva cuando un score derivado cruza el umbral del tenant. Razón legible incluida.

{
  "session_id": "ses_3pYg…",
  "flag": "friction_high",
  "rose_at_ms": 1773400,
  "evidence_window_ms": [1770000, 1773400],
  "reason": "voice_tension>0.74 sustained 3.4s",
  "threshold": 0.7,
  "advice": "consider reframing"
}

Alerta tipada

Webhook · alerts

alerta · tenant rule

Disparada por reglas de tenant (no clínicas). Llega como webhook al CRM o al sistema de tickets.

{
  "alert_id": "alt_77x…",
  "tenant_id": "ten_acme",
  "session_id": "ses_3pYg…",
  "type": "tension_sustained",
  "severity": "P2",
  "message": "Tension sostenida 18s — considera escalar a senior.",
  "auto_action": null,
  "human_in_the_loop": true
}

Next-best-action

GET /v1/sessions/{id}/copilot

guidance · humano decide

Sugerencia para el agente humano. VEXKIO nunca ejecuta la acción — la recomienda. Tu producto decide.

{
  "session_id": "ses_3pYg…",
  "stage": "discovery",
  "recommendation": {
    "kind": "ask_objection_reframe",
    "prompt": "El cliente bajó apertura tras la pregunta de presupuesto. Sugerimos reformular hacia ROI.",
    "expires_at_ms": 1691200
  },
  "decision": "agent"
}

Resumen de sesión

GET /v1/sessions/{id}/summary

summary · agregado

Resumen estructurado al cierre. Distribuciones de estado VEXKIO-5, momentos de fricción, y métricas agregadas — sin frames.

{
  "session_id": "ses_3pYg…",
  "duration_ms": 1834000,
  "vexkio_5_distribution": {
    "apertura": 0.34,
    "neutral": 0.41,
    "friccion": 0.18,
    "tension": 0.05,
    "desconexion": 0.02
  },
  "friction_moments": 3,
  "alerts_raised": 1,
  "engagement_mean": 0.61,
  "voice_tension_p95": 0.58
}

Ejemplos ilustrativos. Los valores numéricos no provienen de una sesión real — el contrato (claves, tipos, semántica) sí es el del API en producción.