Saltar al contenido principal

Guía de Inicio Rápido

Ponte en marcha con CallCov en solo 5 minutos. Esta guía te llevará paso a paso para crear una cuenta, obtener tu clave API y enviar tu primer análisis.

Requisitos Previos​

  • Una dirección de email válida
  • Un archivo de grabación de llamada (WAV, MP3 u otro formato soportado)
  • cURL, Python o Node.js instalado (para solicitudes API)

Paso 1: Crea tu Cuenta​

Regístrate para una cuenta de CallCov en https://callcov.com/register.

Registro vía API
curl -X POST https://api.callcov.com/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "tu@email.com",
    "password": "TuContraseñaSegura123!",
    "phone_number": "+1234567890"
  }'

Paso 2: Verifica tu Email​

Revisa tu bandeja de entrada para un email de verificación y haz clic en el enlace, o verifica vía API:

Verificar Email
curl -X POST https://api.callcov.com/api/v1/auth/verify-email \
  -H "Content-Type: application/json" \
  -d '{
    "token": "tu-token-de-verificacion"
  }'

Paso 3: Inicia Sesión y Obtén tu Token de Acceso​

Iniciar Sesión
curl -X POST https://api.callcov.com/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "tu@email.com",
    "password": "TuContraseñaSegura123!"
  }'

Respuesta:

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "bearer"
}

Paso 4: Crea una Clave API​

Las claves API son recomendadas para integraciones servidor a servidor:

Crear Clave API
curl -X POST https://api.callcov.com/api/v1/api-keys/ \
  -H "Authorization: Bearer TU_TOKEN_DE_ACCESO" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mi Primera Clave API"
  }'

Respuesta:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "key": "sk_live_abc123...",
  "name": "Mi Primera Clave API",
  "key_prefix": "sk_live_abc1",
  "created_at": "2025-01-15T10:30:00Z"
}
Importante

¡Guarda tu clave API de manera segura! Solo se mostrará una vez. Si la pierdes, necesitarás crear una nueva.

Paso 5: Envía tu Primer Análisis​

¡Ahora estás listo para analizar una llamada! Puedes enviar audio vía URL o subiendo un archivo.

Opción A: Enviar vía URL de Audio​

Analizar Llamada vía URL
curl -X POST https://api.callcov.com/api/v1/analysis/ \
  -H "Authorization: Bearer sk_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "audio_url": "https://ejemplo.com/grabacion-llamada.wav",
    "agent_id": "agente_001",
    "contact_id": "cliente_12345",
    "webhook_url": "https://tu-app.com/webhooks/analysis"
  }'

Opción B: Subir Archivo de Audio​

Analizar Llamada vía Subida de Archivo
curl -X POST https://api.callcov.com/api/v1/analysis/ \
  -H "Authorization: Bearer sk_live_abc123..." \
  -F "audio_file=@/ruta/a/grabacion-llamada.wav" \
  -F "agent_id=agente_001" \
  -F "contact_id=cliente_12345"

Ejemplo en Python​

Enviar Análisis en Python
import requests

url = "https://api.callcov.com/api/v1/analysis/"
headers = {
    "Authorization": "Bearer sk_live_abc123..."
}
data = {
    "audio_url": "https://ejemplo.com/grabacion-llamada.wav",
    "agent_id": "agente_001",
    "contact_id": "cliente_12345"
}

response = requests.post(url, headers=headers, json=data)
analysis = response.json()
print(f"ID de Análisis: {analysis['id']}")

Ejemplo en Node.js​

Enviar Análisis en Node.js
const axios = require('axios');

const response = await axios.post(
  'https://api.callcov.com/api/v1/analysis/',
  {
    audio_url: 'https://ejemplo.com/grabacion-llamada.wav',
    agent_id: 'agente_001',
    contact_id: 'cliente_12345'
  },
  {
    headers: {
      'Authorization': 'Bearer sk_live_abc123...'
    }
  }
);

console.log(`ID de Análisis: ${response.data.id}`);

Paso 6: Obtén tus Resultados​

El análisis se ejecuta de manera asíncrona. Puedes hacer polling para los resultados o usar webhooks.

Polling para Resultados​

Obtener Resultados de Análisis
curl -X GET https://api.callcov.com/api/v1/analysis/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer sk_live_abc123..."

Respuesta:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "object": "analysis",
  "created": 1642248000,
  "status": "completed",
  "audio": {
    "url": "https://s3.amazonaws.com/...",
    "duration_seconds": 125.5,
    "format": "wav"
  },
  "transcript": {
    "text": "Agente: Hola, gracias por llamar...",
    "segments": [...]
  },
  "results": {
    "compliance": {
      "identity_verification": {
        "performed": true,
        "confidence": 0.95,
        "evidence": "El agente pidió número de cuenta y verificó fecha de nacimiento"
      },
      "privacy_protection": {
        "performed": true,
        "confidence": 0.92,
        "evidence": "Se proporcionó divulgación de política de privacidad"
      }
    },
    "quality": {
      "sentiment_analysis": {
        "overall_sentiment": "positive",
        "customer_sentiment": "satisfied",
        "agent_sentiment": "professional"
      },
      "call_resolution": {
        "resolved": true,
        "confidence": 0.88
      }
    },
    "coaching": {
      "customer_effort_score": 2,
      "recommendations": [
        "Excelente trabajo personalizando la interacción",
        "Considera reducir el tiempo de espera"
      ]
    }
  }
}

Usar Webhooks (Recomendado)​

En lugar de hacer polling, recibe notificaciones en tiempo real:

Registrar Webhook
curl -X POST https://api.callcov.com/api/v1/analysis/550e8400-e29b-41d4-a716-446655440000/webhook \
  -H "Authorization: Bearer sk_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_url": "https://tu-app.com/webhooks/analysis"
  }'

Tu endpoint de webhook recibirá el análisis completo cuando esté listo.

Entendiendo los Resultados​

CallCov proporciona tres categorías de insights:

Cumplimiento​

  • Verificación de Identidad: ¿Se verificó apropiadamente la identidad del cliente?
  • Protección de Privacidad: ¿Se proporcionaron divulgaciones de privacidad?
  • Adherencia Regulatoria: ¿La llamada siguió los procedimientos requeridos?

Calidad​

  • Análisis de Sentimiento: ¿Cómo se sintieron el cliente y el agente?
  • Resolución de Llamada: ¿Se resolvió el problema?
  • Profesionalismo: ¿Qué tan profesional fue la interacción?

Entrenamiento​

  • Puntaje de Esfuerzo del Cliente: ¿Qué tan fácil fue para el cliente? (escala 1-5)
  • Recomendaciones: Sugerencias específicas para mejorar
  • Fortalezas: Lo que el agente hizo bien

Próximos Pasos​

¡Felicitaciones! Has enviado y recuperado exitosamente tu primer análisis. Esto es lo que puedes explorar ahora:

🔐 Autenticación

Aprende sobre claves API y tokens JWT

Saber Más

📡 Webhooks

Recibe notificaciones en tiempo real

Saber Más

💳 Facturación

Entiende precios y uso

Saber Más

Soporte​

¿Necesitas ayuda? Estamos aquí para ti: