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.

Endpoint

GET /v1/calls/:uid

Parámetros de ruta

Parámetro	Tipo	Descripción
uid	string	Identificador único de la llamada. Obtenlo de Listar llamadas o del webhook de fin de llamada.

Ejemplo de solicitud

curl -X GET "https://api.fonema.ai/v1/calls/aBcDeFgHiJkL" \
  -H "Authorization: Bearer TU_API_KEY_AQUI"

Respuesta

{
  "uid": "aBcDeFgHiJkL",
  "agent": { "name": "Agente de Ventas", "slug": "agente-de-ventas-ab12cd34" },
  "toNumber": "+525599999999",
  "endedReason": "customer-ended-call",
  "createdAt": "2026-08-06T17:00:00.000Z",
  "startAt": "2026-08-06T17:00:05.000Z",
  "endAt": "2026-08-06T17:02:35.000Z",
  "durationSeconds": 150,
  "successEvaluation": true,
  "inputData": {
    "name": "Juan Pérez",
    "montoDeuda": "30000"
  },
  "outputData": {
    "summary": "El cliente acordó pagar el saldo pendiente el viernes.",
    "successEvaluation": "true",
    "fechaPago": "2026-08-08"
  },
  "transcript": [
    { "role": "agent", "content": "¡Hola, gracias por tomar mi llamada!", "secondsFromStart": 0 },
    { "role": "user", "content": "Hola, ¿quién habla?", "secondsFromStart": 4 }
  ],
  "audioUrl": "/v1/calls/aBcDeFgHiJkL/audio.mp3"
}

Campos de la respuesta

Campo	Tipo	Descripción
uid	string	Identificador único de la llamada.
agent	object	El agente que atendió la llamada (name y slug).
toNumber	string	Número telefónico al que se llamó, en formato E.164.
endedReason	string	Motivo por el que terminó la llamada (p. ej. customer-ended-call, voicemail).
createdAt	string	Cuándo se creó la llamada (se encoló).
startAt	string | null	Cuándo se contestó la llamada. null si nunca se conectó.
endAt	string | null	Cuándo terminó la llamada.
durationSeconds	integer	Duración de la llamada en segundos. 0 si nunca se conectó.
successEvaluation	boolean	Si la llamada cumplió los criterios de éxito del agente.
inputData	object	Las variables enviadas al crear la llamada.
outputData	object	Resultados de fin de llamada: summary, successEvaluation y las variables de salida capturadas por el agente.
transcript	array	Transcripción de la conversación, ordenada por tiempo. Cada elemento tiene role (agent o user), content y secondsFromStart.
audioUrl	string | 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

Estado	Descripción
404	Llamada no encontrada o esta API Key no tiene acceso a ella.