Skip to main content

Sviluppi con la nostra API

Integri identitycall.ai senza intoppi.

Autenticazione

  • -

    Autentichi le richieste usando i token Bearer. Tutte le richieste API devono includere l’header 'Authorization: Bearer <YOUR_API_KEY>'.

  • -

    Generi e gestisca le chiavi API dalla dashboard del suo account. Le chiavi sono limitate al suo account e devono essere mantenute segrete.

Registrazioni e trascrizione

  • -

    POST /api/v1/public/recordings: Carichi file audio (MP3, WAV, FLAC, M4A) fino a 2GB. Supporta multipart/form-data.

  • -

    GET /api/v1/public/recordings/{id}: Recuperi stato e metadati della registrazione; GET /api/v1/public/recordings/{id}/audio_url restituisce un URL per la riproduzione dell’audio.

  • -

    GET /api/v1/public/recordings/{id}/transcription: Recuperi la trascrizione completa con diarizzazione dei parlanti e marche temporali.

  • -

    GET /api/v1/public/recordings: Elenchi tutte le registrazioni; GET /api/v1/public/recordings/filters restituisce i valori di filtro disponibili.

Progetti e operatori

  • -

    GET/POST /api/v1/public/projects: Elenchi, crei e gestisca i progetti in cui sono organizzate le sue registrazioni.

  • -

    GET/POST /api/v1/public/operators: Gestisca gli operatori (agenti), le persone di cui registra e attribuisce le chiamate.

  • -

    GET /api/v1/public/app/settings: Legga le impostazioni di elaborazione del suo account.

Risultati dell’analisi

  • -

    GET /api/v1/public/recordings/{id}/results: Punteggi degli obiettivi, categorie, campi estratti e identificazione del parlante per una chiamata elaborata.

  • -

    GET /api/v1/public/recordings/{id}/summary: Il riepilogo della conversazione generato dall’IA.

  • -

    I risultati includono il ragionamento dietro ogni punteggio degli obiettivi, così ogni numero è verificabile.

Numeri virtuali e telefonia

  • -

    GET /api/v1/public/virtual_numbers/available e POST /api/v1/public/virtual_numbers/purchase: Sfogli e acquisti numeri di telefono.

  • -

    PATCH /api/v1/public/virtual_numbers/{id}: Configuri un numero; aggiunga o rimuova operatori con POST {id}/add_operator e DELETE {id}/remove_operator.

Webhook ed eventi

  • -

    Riceva un webhook 'recording.analyzed' in tempo reale al termine dell’elaborazione, con le sezioni del payload che sceglie: metadati, riepilogo, trascrizione, obiettivi, categorie, dati estratti.

  • -

    I webhook vengono recapitati come richieste POST JSON all’endpoint HTTPS che configura.

Limiti di frequenza

  • -

    I limiti di frequenza dell’API sono legati alle quote del suo piano di abbonamento.