Resultados

Leer el resultado de un cuestionario: respuestas, score, transcripción y grabación

Los resultados de cada llamada —tanto de seguimiento como de triaje— se consultan con los endpoints de lectura.

​

Cuestionario (protocol run)

curl "https://{your-prod-endpoint}/v1/protocol-runs/{runId}" \
  -H "Authorization: Bearer oc_sk_..."

Devuelve el run con su versión de protocolo, answers[], calls[], notas, un resumen del paciente y el score calculado. Campos relevantes del run:

Campo	Descripción
questionnaire_status	pending, in_progress, completed, rejected, call_failed, wrong_number, no_answer, unresolved, cancelled.
score, score_class	Puntuación y banda de riesgo calculadas (cuando aplica).
sequence_number	Número de cuestionario dentro de la inscripción.
scheduled_at, started_at, ended_at	Marcas de tiempo del run.
reviewed_at, review_note	Revisión clínica, si la hubo.

​

Llamada y transcripción

curl "https://{your-prod-endpoint}/v1/calls/{callId}" \
  -H "Authorization: Bearer oc_sk_..."

Devuelve la llamada con su transcripción (timeline_events, solo las intervenciones de la conversación). Campos relevantes:

Campo	Descripción
status	pending, dialing, in_progress, completed, failed, no_answer, cancelled, transferred.
call_direction	outbound (seguimiento) o inbound (triaje).
disconnect_reason	Motivo de cierre de la llamada.
has_recording	Si existe grabación disponible.
started_at, ended_at, scheduled_at	Marcas de tiempo.

​

Grabación

Si has_recording es true, obtén un enlace firmado de corta duración:

curl "https://{your-prod-endpoint}/v1/calls/{callId}/recording" \
  -H "Authorization: Bearer oc_sk_..."

{ "data": { "url": "https://{your-prod-endpoint}/v1/calls/{callId}/recording/stream?expires=…&token=…" } }

Ese enlace redirige al audio (audio/ogg); OlivIA lee el fichero del almacenamiento del lado del servidor, de modo que tu sistema nunca recibe una credencial de almacenamiento. Devuelve 404 si no hay grabación y 503 si el almacenamiento no está disponible.