Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.neuracall.com/llms.txt

Use this file to discover all available pages before exploring further.

Requisitos previos: Necesitas credenciales de API (client_id y client_secret). Contacta a support@neuracall.com 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"
  }'
Respuesta: 
{
  "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 "audio_file=@llamada.mp3" \
  -F "external_id=CALL-2024-001" \
  -F "agent_id=AGT-001" \
  -F "agent_name=Juan Perez" \
  -F "model_name=Evaluación Servicio Cliente"
Respuesta (201 Created): 
{
  "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"
Respuesta (completado): 
{
  "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

EstadoDescripción
PENDINGSolicitud recibida, esperando procesamiento
AUDIO_TRANSCRIPTION_IN_PROGRESSTranscribiendo el audio
TRANSCRIPTION_ANALYZE_IN_PROGRESSAnalizando la transcripción
TRANSCRIPTION_SUMMARIZE_IN_PROGRESSGenerando resumen e insights
PROCESS_COMPLETEDAnálisis completado exitosamente
ERRORError durante el procesamiento

​
Siguientes Pasos

Entender NeuraScore

Aprende a interpretar las puntuaciónes

Configurar Modelos

Personaliza los criterios de evaluación

Ver el Dashboard

Explora las métricas agregadas

API Reference

Documentación completa de la API