Llamadas de Voz

Interacciones de voice bot con IA incluyendo IVR y campanas de salida.

Endpoints

Metodo	Endpoint	Alcance	Descripcion
GET	/api/v1/voice-calls	voice:read	Listar llamadas de voz con filtros
GET	/api/v1/voice-calls/{id}	voice:read	Obtener una llamada de voz con transcripcion completa
GET	/api/v1/voice-calls/{id}/recording-url	audio:download	Generar URL SAS de grabacion (expira en 15 min)
GET	/api/v1/voice-calls/{id}/epa-results	voice:read	Obtener resultados de encuesta post-llamada

Parametros de Consulta (Endpoint de Listado)

Parametro	Tipo	Descripcion
campaignId	string	Filtrar por ID de campana
state	string	Filtrar por estado de llamada (ej., Completed, Busy, NoAnswer)
direction	string	Filtrar por direccion (Inbound o Outbound)
dateFrom	datetime	Inicio del rango de fechas
dateTo	datetime	Fin del rango de fechas
page	int	Numero de pagina para paginacion
pageSize	int	Numero de resultados por pagina

Objeto de Llamada de Voz

{
  "id": "vc_abc123",
  "campaignId": "camp_456",
  "direction": "Outbound",
  "state": "Completed",
  "startTime": "2024-01-15T10:30:00Z",
  "endTime": "2024-01-15T10:35:12Z",
  "durationSeconds": 312,
  "talkTimeSeconds": 287,
  "outcome": "Successful",
  "transcript": [
    { "role": "agent", "text": "Hello, this is...", "timestamp": "00:00:01" },
    { "role": "customer", "text": "Hi, yes...", "timestamp": "00:00:04" }
  ],
  "epaResults": {
    "state": "Completed",
    "completionReason": "AllAnswered",
    "totalQuestions": 3,
    "questionsAnswered": 3,
    "calculatedScore": 85.5,
    "responses": [
      { "question": "How satisfied are you?", "answer": "Very satisfied", "score": 5 }
    ]
  },
  "createdAt": "2024-01-15T10:30:00Z"
}

Resultados EPA (Encuesta Post-Atencion)

Los resultados EPA (Encuesta Post-Atencion) estan disponibles cuando se configura una encuesta post-llamada para la campana. Usa el endpoint /epa-results o accede a ellos en linea a traves del objeto de llamada de voz.

Campo	Tipo	Descripcion
state	string	Estado de la encuesta (ej., Completed, Partial, NotStarted)
completionReason	string	Razon de finalizacion de la encuesta (ej., AllAnswered, HangUp, Timeout)
totalQuestions	int	Numero total de preguntas de la encuesta
questionsAnswered	int	Numero de preguntas respondidas por el llamante
calculatedScore	number	Puntaje de satisfaccion agregado
responses	array	Entradas individuales de pregunta/respuesta/puntaje

Flujo de Descarga de Grabaciones

Las grabaciones de audio se acceden mediante URLs firmadas temporales. Sigue este proceso de tres pasos:

# 1. Get voice call list
GET /api/v1/voice-calls?state=Completed&direction=Outbound
Authorization: Bearer <token>

# 2. Request a recording SAS URL (valid for 15 minutes)
GET /api/v1/voice-calls/vc_abc123/recording-url
Authorization: Bearer <token>

Response:
{
  "recordingUrl": "https://storage.blob.core.windows.net/recordings/vc_abc123.wav?sv=...&se=...",
  "expiresAt": "2024-01-15T10:45:00Z"
}

# 3. Download the recording (no auth required, URL is pre-signed)
GET https://storage.blob.core.windows.net/recordings/vc_abc123.wav?sv=...&se=...

Documentacion completa de llamadas de voz proximamente

Esquemas detallados de transcripciones, eventos de webhook para cambios de estado de llamadas y capacidades de exportacion masiva estan siendo documentados.

Solicitar Acceso API