Skip to main content

Construye con nuestra API

Integra identitycall.ai sin fricciones.

Autenticación

  • -

    Autentica las solicitudes con tokens Bearer. Todas las solicitudes a la API deben incluir el encabezado 'Authorization: Bearer <YOUR_API_KEY>'.

  • -

    Genera y administra las claves de API desde el panel de tu cuenta. Las claves están limitadas a tu cuenta y deben mantenerse en secreto.

Grabaciones y transcripción

  • -

    POST /api/v1/public/recordings: Sube archivos de audio (MP3, WAV, FLAC, M4A) de hasta 2GB. Admite multipart/form-data.

  • -

    GET /api/v1/public/recordings/{id}: Consulta el estado y los metadatos de la grabación; GET /api/v1/public/recordings/{id}/audio_url devuelve una URL para reproducir el audio.

  • -

    GET /api/v1/public/recordings/{id}/transcription: Obtén la transcripción completa con diarización de hablantes y marcas de tiempo.

  • -

    GET /api/v1/public/recordings: Lista todas las grabaciones; GET /api/v1/public/recordings/filters devuelve los valores de filtro disponibles.

Proyectos y operadores

  • -

    GET/POST /api/v1/public/projects: Lista, crea y administra los proyectos en los que se organizan tus grabaciones.

  • -

    GET/POST /api/v1/public/operators: Administra operadores (agentes) - las personas cuyas llamadas grabas y atribuyes.

  • -

    GET /api/v1/public/app/settings: Consulta la configuración de procesamiento de tu cuenta.

Resultados de análisis

  • -

    GET /api/v1/public/recordings/{id}/results: Puntuaciones de objetivos, categorías, campos extraídos e identificación de hablantes de una llamada procesada.

  • -

    GET /api/v1/public/recordings/{id}/summary: El resumen de la conversación generado por IA.

  • -

    Los resultados incluyen el razonamiento detrás de cada puntuación de objetivo, así que cada número es auditable.

Números virtuales y telefonía

  • -

    GET /api/v1/public/virtual_numbers/available y POST /api/v1/public/virtual_numbers/purchase: Explora y compra números de teléfono.

  • -

    PATCH /api/v1/public/virtual_numbers/{id}: Configura un número; añade o elimina operadores con POST {id}/add_operator y DELETE {id}/remove_operator.

Webhooks y eventos

  • -

    Recibe un webhook 'recording.analyzed' en tiempo real cuando termina el procesamiento, con las secciones del payload que elijas: metadata, summary, transcription, goals, categories, extracted data.

  • -

    Los webhooks se entregan como solicitudes POST en JSON al endpoint HTTPS que configures.

Límites de solicitudes

  • -

    Los límites de solicitudes de la API están vinculados a las cuotas de tu plan de suscripción.

Obtén acceso a la API

Regístrate