Saltar al contenido principal

Webhooks para Análisis

Sin Endpoint de Webhook Separado

No hay un endpoint separado para registrar webhooks. Las URLs de webhook se configuran cuando creas un análisis.

Cómo Configurar Webhooks​

Los webhooks se configuran pasando el parámetro webhook_url cuando creas un análisis vía POST /api/v1/analysis/.

Ejemplo​

curl -X POST https://api.callcov.com/api/v1/analysis/ \
  -H "X-API-Key: sk_live_abc123..." \
  -F "audio_file=@/path/to/call.wav" \
  -F "agent_id=agent_001" \
  -F "contact_id=customer_12345" \
  -F "webhook_url=https://your-app.com/webhooks/analysis"

Cuando el análisis se complete, CallCov enviará un request POST a tu URL de webhook con los resultados completos del análisis.

Documentación de Webhooks​

Para una guía completa de implementación de webhooks, consulta:

  • Guía de Webhooks - Guía comprensiva sobre implementación de webhooks
    • Formato de payload de webhook
    • Seguridad con validación de firma
    • Lógica de reintentos
    • Prueba de webhooks localmente
    • Mejores prácticas

Referencia Rápida​

Cuándo Usar Webhooks​

✅ Usar webhooks cuando:

  • Estás construyendo aplicaciones de producción
  • Procesas muchos análisis
  • Quieres notificaciones en tiempo real
  • Quieres evitar polling

❌ No usar webhooks cuando:

  • Pruebas localmente sin ngrok
  • Procesas análisis únicos de forma interactiva
  • Construyes prototipos rápidos

Payload del Webhook​

Cuando el análisis se complete, recibes el objeto AnalysisResponse completo:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "results": {
    "compliance": {...},
    "quality": {...},
    "summary": "..."
  },
  ...
}

Relacionado​