Skip to main content

​
Formas de Integrar

Neuracall ofrece múltiples formas de integrarse con tus sistemas:

API REST

Integración directa via HTTP para control total.

Aplicación Web

Interfaz grafica para uso manual y supervision.

​
Arquitectura de Integración

​
Casos de Integración Comunes

​
1. Integración con CRM

Envia llamadas automáticamente cuando se completan en tu CRM: 
# Cuando una llamada termina en tu CRM
def on_call_completed(call_record):
    # Descargar grabacion
    audio_file = download_recording(call_record.recording_url)

    # Enviar a Neuracall
    analysis = neuracall.create_analysis(
        audio_file=audio_file,
        external_id=call_record.id,
        agent_id=call_record.agent_id,
        agent_name=call_record.agent_name,
        model_name="Evaluación Servicio"
    )

    # Guardar referencia
    call_record.neuracall_id = analysis.id
    call_record.save()

​
2. Integración con Telefonia

Conecta tu PBX o sistema de telefonia:
  • Asterisk: Usa AMI para detectar fin de llamada
  • Twilio: Webhook al completar recording
  • Amazon Connect: Lambda trigger post-call

​
3. Proceso Batch

Analiza llamadas historicas en lote: 
# Procesar llamadas del dia anterior
calls = get_calls_from_yesterday()

for call in calls:
    neuracall.create_analysis(
        audio_file=call.recording,
        external_id=call.id,
        ...
    )

​
Flujo Tipico

1

Autenticar

Obtener token de acceso con credenciales.
2

Enviar Llamada

POST a /v1/call-analysis con audio y metadatos.
3

Monitorear

GET periodico o webhook para saber cuando termina.
4

Obtener Resultados

GET /v1/call-analysis/ para datos completos.
5

Usar Datos

Guardar scores, mostrar en dashboard propio, etc.

​
Consideraciones Tecnicas

​
Autenticación

  • Los tokens tienen expiración
  • Implementa renovacion automática
  • Almacena credenciales de forma segura

​
Manejo de Errores

  • Implementa reintentos para errores 5xx
  • Valida datos antes de enviar
  • Loguea errores para debugging

​
Rendimiento

  • El procesamiento es asíncrono (2-5 min tipico)
  • Puedes enviar múltiples llamadas en paralelo
  • Respeta los rate limits

​
Seguridad

Nunca expongas credenciales en código cliente o repositorios publicos.
Recomendaciones:
  • Usa variables de entorno
  • Implementa rotacion de secretos
  • Monitorea uso de API

Primeros Pasos

Guía paso a paso

Ejemplos de Código

Ver implementaciones