Requisitos previos: Necesitas credenciales de API (client_id y client_secret).
Contacta a [email protected] para obtenerlas. Paso 1: Obtener Token de Acceso
Autentica tu aplicación para obtener un token de acceso:
curl -X POST https://api.neuracall.com/v1/auth \
-H "Content-Type: application/json" \
-d '{
"client_id": "tu_client_id",
"client_secret": "tu_client_secret"
}'
{
"access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
"expires_at": 1735689600,
"client_id_audience": "https://api.neuracall.com/call-analysis",
"scope": "read:call-analysis-requests write:call-analysis-request ..."
}
Guarda el access_token. Lo necesitaras en todas las llamadas siguientes.
El token expira en la fecha indicada por expires_at.
Paso 2: Subir una Llamada para Análisis
Envia un archivo de audio con la información del agente:
curl -X POST https://api.neuracall.com/v1/call-analysis \
-H "Authorization: Bearer TU_ACCESS_TOKEN" \
-F "[email protected]" \
-F "external_id=CALL-2024-001" \
-F "agent_id=AGT-001" \
-F "agent_name=Juan Perez" \
-F "model_name=Evaluación Servicio Cliente"
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"external_id": "CALL-2024-001",
"agent_id": "AGT-001",
"agent_name": "Juan Perez",
"status": "PENDING",
"created_at": "2024-01-15T10:30:00Z"
}
Formatos soportados: MP3, WAV, M4A, FLAC, OGG, WEBM
Paso 3: Consultar el Resultado
El análisis se procesa de forma asincrona. Consulta el estado hasta qué este completo:
curl https://api.neuracall.com/v1/call-analysis/550e8400-e29b-41d4-a716-446655440000 \
-H "Authorization: Bearer TU_ACCESS_TOKEN"
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"external_id": "CALL-2024-001",
"status": "PROCESS_COMPLETED",
"total_score": 425,
"expected_score": 500,
"score_percentage": 85.0,
"summary": "El agente resolvio eficientemente una consulta de facturación...",
"insights": [
"Excelente manejo del saludo inicial",
"Oportunidad de mejora en el cierre de la llamada"
],
"keywords": ["facturación", "reembolso", "satisfacción"],
"neurascore_result": [
{
"name": "Apertura",
"total_score": 45,
"expected_total_score": 50,
"score_percentage": 90.0,
"variables": [...]
}
]
}
Estados del Análisis
| Estado | Descripción |
|---|
PENDING | Solicitud recibida, esperando procesamiento |
AUDIO_TRANSCRIPTION_IN_PROGRESS | Transcribiendo el audio |
TRANSCRIPTION_ANALYZE_IN_PROGRESS | Analizando la transcripción |
TRANSCRIPTION_SUMMARIZE_IN_PROGRESS | Generando resumen e insights |
PROCESS_COMPLETED | Análisis completado exitosamente |
ERROR | Error durante el procesamiento |
Siguientes Pasos
