Documentación
API de Llamadas (voz).md

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": "+14157774444",
  "to_number": "+12137774445",
  "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.
Esc