Saltar al contenido principal

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​

AuthorizationBearer

Autentica 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​

uidstringObligatorio

Identificador único de la llamada. Obtenlo de Listar llamadas o del webhook de fin de llamada.

Respuesta​

uidstring
Identificador único de la llamada.
agentobject
El agente que atendió la llamada (name y slug).
toNumberstring
Número telefónico al que se llamó, en formato E.164.
endedReasonstring
Motivo por el que terminó la llamada (p. ej. customer-ended-call, voicemail).
createdAtstring
Cuándo se creó la llamada (se encoló).
startAtstring | null
Cuándo se contestó la llamada. null si nunca se conectó.
endAtstring | null
Cuándo terminó la llamada.
durationSecondsinteger
Duración de la llamada en segundos. 0 si nunca se conectó.
successEvaluationboolean
Si la llamada cumplió los criterios de éxito del agente.
inputDataobject
Las variables enviadas al crear la llamada.
outputDataobject

Resultados de fin de llamada: summary, successEvaluation y las variables de salida capturadas por el agente.

transcriptarray

Transcripción de la conversación, ordenada por tiempo. Cada elemento tiene role (agent o user), content y secondsFromStart.

audioUrlstring | null

Ruta 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
Llamada no encontrada o esta API Key no tiene acceso a ella.