Grabaciones

Captura flujos de trabajo del usuario desde un navegador (o desde cualquier cliente que construyas), carga los eventos + capturas de pantalla, y deja que el pipeline de IA de SOPFlow redacte pasos SOP. Potencia la extensión Chrome de SOPFlow; la misma interfaz está abierta para tus propios clientes.

Ciclo de vida

1. create — obtén un id de grabación y la sesión comienza.
2. uploadEvents — POST de lotes conforme el usuario interactúa (máximo 100 por llamada).
3. screenshot — multipart POST para cualquier número de secuencia.
4. finalize — el servidor cambia el estado a processing y ejecuta el pipeline de IA.
5. getStatus — sondea hasta ready (o failed); los pasos generados están listos.
6. importToSOP — convierte borradores seleccionados en sop_steps.

{
  "result": {
    "data": {
      "recordingId": "31ab37ce-dce6-4590-a640-b175a1454055"
    }
  }
}

{ "result": { "data": { "inserted": 5 } } }

{ "objectKey": "recording_screenshots/<org>/<rec>/0.webp", "sizeBytes": 12480 }

{ "result": { "data": { "status": "processing", "jobId": "..." } } }

{
  "result": {
    "data": {
      "recording": {
        "id": "31ab37ce-...",
        "status": "ready",
        "eventCount": 42,
        "screenshotCount": 18,
        "durationMs": 65234
      },
      "generatedSteps": [
        {
          "id": "...",
          "stepNumber": 1,
          "title": "Navigate to the Login page",
          "description": "Open the SOPFlow login URL.",
          "screenshotKey": "recording_screenshots/<org>/<rec>/0.webp",
          "sourceEventIds": ["..."]
        }
      ]
    }
  }
}

{ "result": { "data": { "createdSteps": [{ "id": "...", "title": "..." }] } } }

Provisión de una clave para tu cliente

Para uso servidor-a-servidor, genera una clave API en Configuración → Claves API con los alcances read + write y guárdala en tu servidor de confianza. No incluyas una clave de servicio compartida en código público del navegador.

Para extensiones de navegador y clientes de escritorio que actúan en nombre de un usuario final, utiliza el puente post-OAuth:

{ "result": { "data": { "key": "sk_live_…", "prefix": "sk_live_abcd" } } }

Ejemplo de extremo a extremo

# 1. Create a new recording session
curl -X POST https://sopflow.io/trpc/recording.create \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source":"chrome_extension"}'

# 2. Stream events as you capture them (max 100 per call)
curl -X POST https://sopflow.io/trpc/recording.uploadEvents \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recordingId":"<from step 1>",
    "events":[
      {"sequenceNumber":0,"eventType":"click","url":"https://example.com",
       "pageTitle":"Home","target":{"cssSelector":"button.cta",
       "elementType":"BUTTON","textContent":"Sign in"},"timestamp":1730000000000}
    ]
  }'

# 3. Optionally POST a screenshot for any sequenceNumber
curl -X POST \
  https://sopflow.io/api/v1/recordings/<id>/screenshot/0 \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -F "file=@frame.webp;type=image/webp"

# 4. Finalize — kicks off the AI pipeline asynchronously
curl -X POST https://sopflow.io/trpc/recording.finalize \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"recordingId":"<id>","durationMs":65000}'

# 5. Poll for the result (status flips to "ready")
curl "https://sopflow.io/trpc/recording.getStatus?input=%7B%22recordingId%22%3A%22<id>%22%7D" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

Notas

• La privacidad es responsabilidad del cliente. El servidor almacena lo que sea eventData.value que envíes. La extensión Chrome enmascara campos de contraseña y campos de autocompletado de tarjetas de crédito antes de que salgan de la página; si construyes tu propio cliente, haz lo mismo. El pipeline realiza un barrido de expresiones regulares para tarjetas / SSNs / correos como defensa de última línea, pero no confíes en ello.
• Límites de velocidad. tRPC usa el límite general de 300 solicitudes por minuto por IP, no el presupuesto REST por clave. Agrupa hasta 100 eventos y gestiona las respuestas 429.
• Recuperación de reinicio. Si la API se reinicia durante el procesamiento, la grabación se marca automáticamente como failed en el siguiente arranque. Llama a recording.reprocess para reintentar.