Obtener llamada

GET /v2/get-call/{call_id}

Recupera el detalle completo de una llamada, incluyendo transcripción, grabación, análisis post-llamada y métricas de latencia.

---

Parámetros de ruta

Campo	Tipo	Requerido	Descripción
call_id	string	Sí	ID de la llamada a consultar. Ejemplo: 119c3f8e47135a29e65947eeb34cf12d

---

Respuesta — 200 OK

Devuelve el objeto completo de la llamada. Para llamadas telefónicas incluye call_type: "phone_call", from_number, to_number y direction. Para llamadas web incluye call_type: "web_call" y access_token.

Campos principales

Campo	Tipo	Descripción
call_id	string	Identificador único de la llamada.
call_type	string	phone_call o web_call
agent_id	string	ID del agente utilizado.
agent_version	integer	Versión del agente utilizado.
call_status	string	registered | not_connected | ongoing | ended | error
direction	string	inbound o outbound (solo para llamadas telefónicas)
from_number	string	Número de origen (solo para llamadas telefónicas).
to_number	string	Número de destino (solo para llamadas telefónicas).
start_timestamp	integer	Inicio de la llamada en milisegundos (epoch).
end_timestamp	integer	Fin de la llamada en milisegundos (epoch).
duration_ms	integer	Duración total en milisegundos.
transcript	string	Transcripción completa en texto plano.
transcript_object	array	Transcripción con marca de tiempo por utterance (ver estructura abajo).
transcript_with_tool_calls	array	Transcripción entrelazada con llamadas a herramientas.
recording_url	string	URL del audio WAV de la llamada.
disconnection_reason	string	Razón de desconexión.
call_analysis	object	Análisis post-llamada (ver estructura abajo).
call_cost	object	Costo de la llamada (ver estructura abajo).
latency	object	Métricas de latencia (ver estructura abajo).
metadata	object	Metadatos almacenados en la llamada.

---

Estructura: transcript_object

Array de objetos Utterance:

Campo	Tipo	Descripción
role	string	agent | user | transfer_target
content	string	Texto del turno de conversación.
words	array	Detalle palabra a palabra: { "word": string, "start": number, "end": number }

Tipos especiales de utterance:

Tipo	Rol	Campos adicionales
Invocación de herramienta	tool_call_invocation	tool_call_id, name, arguments (JSON string)
Resultado de herramienta	tool_call_result	tool_call_id, content, successful (boolean)
Transición de nodo	node_transition	former_node_id, former_node_name, new_node_id, new_node_name, transition_type
DTMF	dtmf	digit (carácter: "1", "2", "*", "#", etc.)

---

Estructura: call_analysis

Campo	Tipo	Descripción
call_summary	string	Resumen narrativo de la llamada.
call_successful	boolean	Si la llamada alcanzó su objetivo.
user_sentiment	string	Positive | Neutral | Negative | Unknown
in_voicemail	boolean	Si la llamada llegó a buzón de voz.
custom_analysis_data	object	Campos personalizados definidos en el agente.

---

Estructura: latency

Cada métrica (e2e, asr, llm, tts, etc.) contiene:

Campo	Descripción
p50	Percentil 50 en ms
p90	Percentil 90 en ms
p95	Percentil 95 en ms
p99	Percentil 99 en ms
max	Máximo en ms
min	Mínimo en ms
num	Número de mediciones

---

Estructura: call_cost

Campo	Descripción
total_duration_seconds	Duración total facturable en segundos.
combined_cost	Costo total en centavos de dólar.
product_costs	Array de costos por componente (transcripción, LLM, voz, etc.).

---

Ejemplo de solicitud

curl --request GET \
     --url https://calls.anunzi.net/v2/get-call/119c3f8e47135a29e65947eeb34cf12d \
     --header 'Authorization: Bearer TU_API_KEY'

---

Ejemplo de respuesta (parcial)

{
  "call_id": "119c3f8e47135a29e65947eeb34cf12d",
  "call_type": "phone_call",
  "agent_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
  "call_status": "ended",
  "direction": "outbound",
  "from_number": "[phone]",
  "to_number": "[phone]",
  "start_timestamp": 1714500000000,
  "end_timestamp": 1714500180000,
  "duration_ms": 180000,
  "disconnection_reason": "user_hangup",
  "transcript": "Agente: Hola, ¿cómo estás?\nUsuario: Bien, gracias.",
  "call_analysis": {
    "call_summary": "El usuario confirmó interés en el producto.",
    "call_successful": true,
    "user_sentiment": "Positive"
  }
}

---

Códigos de estado

Código	Descripción
200	Llamada encontrada y devuelta correctamente.
400	Formato de solicitud inválido.
401	API Key ausente o inválida.
422	La llamada no existe bajo tu API Key.
500	Error interno del servidor.