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 cuestionario con answers[], las llamadas con su transcripción, un resumen del paciente y el score calculado. El protocolo y su versión viajan como resumen (protocol, protocol_version): para la definición del cuestionario detrás de una question_key o una option_key, ve a GET /v1/protocols/{idOrKey}.

Campos relevantes del cuestionario:

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 que calculó el motor. No cambian una vez calculadas.
effective_score_class, score_class_overridden	La clasificación en vigor: la última corrección clínica si la hubo, y si no la del motor. Lee ésta para la clasificación actual.
score_unavailable_reason	Por qué no hay puntuación, cuando no la hay.
sequence_number	Número de cuestionario dentro de la inscripción.
scheduled_at, started_at, ended_at	Marcas de tiempo.
reviewed_at, review_note	Revisión clínica, si la hubo.

​

Respuestas

answers[] lleva una entrada por pregunta que el cuestionario alcanzó, en el orden en que el paciente las oyó. Es la misma forma que reciben tus webhooks.

{
  "question_key": "disnea",
  "question_text": "¿Ha tenido dificultad para respirar?",
  "type": "multiple_choice",
  "status": "answered",
  "asked_at": "2026-09-09T10:14:02Z",
  "answered_at": "2026-09-09T10:14:22Z",
  "call_id": "…",
  "value": ["mucha-dificultad"]
}

Campo	Descripción
status	answered la contestó; declined se la puso y no quiso contestar; asked se la puso y la llamada no llegó a recoger respuesta.
value	Tipado por type: número, texto, booleano, fecha ISO, o las option_key elegidas en una pregunta de selección. null si no hubo respuesta.
call_id	El intento en el que ocurrió, para atarlo a su transcripción.

Las preguntas y las opciones viajan por clave (question_key, option_key), no por identificador interno: son estables entre versiones y no cambian si alguien reescribe el enunciado.

​

Llamada y transcripción

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

Devuelve la llamada con su transcription: la conversación y sólo la conversación, con quién habló, qué dijo y cuándo. 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.