Llamadas
Consultar llamada
Obtiene el detalle completo de una llamada por su uid, incluyendo la transcripción de la conversación y un enlace a la grabación.
Autenticación
AuthorizationBearerAutentica las solicitudes desde tu servidor con una API Key de Fonema. Créala en la sección de API Keys del Dashboard y envíala en el encabezado Authorization como Bearer <token>. No pongas tus claves en código del navegador ni en repositorios públicos.
Parámetros de ruta
uidstringObligatorioIdentificador único de la llamada. Obtenlo de Listar llamadas o del webhook de fin de llamada.
Respuesta
uidstringagentobjectname y slug).toNumberstringendedReasonstringcustomer-ended-call, voicemail).createdAtstringstartAtstring | nullnull si nunca se conectó.endAtstring | nulldurationSecondsinteger0 si nunca se conectó.successEvaluationbooleaninputDataobjectoutputDataobjectResultados de fin de llamada: summary, successEvaluation y las variables de salida capturadas por el agente.
transcriptarrayTranscripción de la conversación, ordenada por tiempo. Cada elemento tiene role (agent o user), content y secondsFromStart.
audioUrlstring | nullRuta de la grabación de la llamada, relativa a https://api.fonema.ai. null si no hay grabación disponible.
Descargar la grabación
El endpoint de grabación acepta la misma API Key:
GET /v1/calls/:uid/audio.mp3
curl -X GET "https://api.fonema.ai/v1/calls/aBcDeFgHiJkL/audio.mp3" \
-H "Authorization: Bearer TU_API_KEY_AQUI" \
-o grabacion.mp3
Errores
404