HITLEAD mette a disposizione API Pubbliche per Voice AI, così puoi gestire agenti e azioni in modo programmatico, recuperare log e trascrizioni delle chiamate e collegare webhook in tempo reale ai tuoi Workflow. Questo articolo offre una panoramica generale e rimanda alla documentazione API ufficiale per i dettagli tecnici.

INDICE DEI CONTENUTI

Cosa sono le API Pubbliche Voice AI?

Le API Pubbliche Voice AI ti danno accesso diretto per configurare agenti, gestire azioni, recuperare dati sulle chiamate e integrare webhook nei tuoi Workflow. Questo eleva Voice AI da semplice funzionalità di prodotto a una capacità estensibile, integrabile direttamente nei tuoi Workflow e nelle tue applicazioni.

Invece di limitare Voice AI ai controlli in-app, puoi:

  • Gestire Agenti e Azioni: Crea, aggiorna e organizza agenti e i loro comportamenti tramite API.

  • Recuperare Dati sulle Chiamate: Accedi a log e trascrizioni per reportistica, conformità o analytics.

  • Sfruttare i Webhook: Ricevi in tempo reale esiti delle chiamate, trascrizioni e riepiloghi nei tuoi sistemi.

Link alla documentazione API

Vantaggi principali delle API Pubbliche Voice AI

  • Accesso ai dati: Estrai esiti delle chiamate, trascrizioni e metriche per un tracciamento e una reportistica dettagliata

  • Integrazione con i Workflow: Automatizza la configurazione e adatta Voice AI alle tue applicazioni e alle tue esigenze operative

  • Estensibilità: Le API Pubbliche rendono Voice AI non solo utilizzabile, ma anche personalizzabile e costruibile

Documentazione API Voice AI

La documentazione API per le API Pubbliche Voice AI include dettagli su log chiamate, agenti e azioni. I requisiti di accesso, gli ambienti e i dettagli di autenticazione possono evolversi. Fai sempre riferimento alla documentazione API per le informazioni più aggiornate.

Clicca qui per accedere alla documentazione API Voice AI

Voci (Catalog APIs)

Ora puoi sfogliare il catalogo Voice AI usando le API pubbliche:

Get Voices: Recupera un elenco paginato e filtrabile di voci. Puoi filtrare per lingua e, facoltativamente, passare un agentId per ottenere solo le voci compatibili.

Fetch Voice Details: Recupera i metadati dettagliati di una voce specifica, incluso un URL di anteprima per i test.

Per i dettagli tecnici completi, consulta la documentazione API Voice AI nel Developer Portal.

API Log Chiamate

Le API Log Chiamate forniscono accesso alle chiamate gestite da Voice AI, supportando analytics, revisioni della qualità e conformità. Usale per elencare le chiamate con filtri o per recuperare i dettagli di una singola chiamata, incluse le trascrizioni quando disponibili. Consulta la documentazione di riferimento API per ulteriori dettagli.

  • List Call Logs: Restituisce i log delle chiamate degli agenti Voice AI associati a una location. Supporta il filtraggio per agente, contatto, tipo di chiamata, tipi di azione e intervallo di date (interpretato nel fuso orario IANA fornito). Supporta anche l'ordinamento e la paginazione a base 1.

  • Get Call Log: Restituisce un log di chiamata tramite ID chiamata

Clicca qui per accedere alla documentazione API Voice AI sui Log Chiamate

Schermata 1 — API Pubbliche Voice AI

API Agenti

Le API Agenti ti permettono di creare, elencare, leggere, aggiornare ed eliminare agenti Voice AI in modo programmatico, così puoi distribuire configurazioni coerenti in tutte le location e gli ambienti. Consulta la documentazione di riferimento API per ulteriori dettagli.

  • Create Agent: Crea una nuova configurazione e le impostazioni di un agente Voice AI

  • Patch Agent: Aggiorna parzialmente un agente Voice AI esistente

  • List Agents: Recupera un elenco paginato di agenti per una determinata location

  • Get Agent: Recupera la configurazione dettagliata e le impostazioni di uno specifico agente Voice AI

  • Delete Agent: Elimina un agente Voice AI e tutte le sue configurazioni

Clicca qui per accedere alla documentazione API Voice AI sugli Agenti

Schermata 2 — API Pubbliche Voice AI

API Azioni

Le azioni definiscono cosa può fare un agente, come invocare un webhook, recuperare dati o pubblicare risultati. Le API Azioni ti permettono di creare e aggiornare questi comportamenti in modo programmatico e di mantenerli sincronizzati con i tuoi sistemi. Consulta la documentazione di riferimento API per ulteriori dettagli.

  • Create Agent Action: Crea una nuova azione per un agente Voice AI. Le azioni definiscono comportamenti e capacità specifiche dell'agente durante le chiamate.

  • Update Agent Action: Aggiorna un'azione esistente per un agente Voice AI. Modifica il comportamento e la configurazione di un'azione dell'agente.

  • Get Agent Action: Recupera i dettagli di un'azione specifica tramite il suo ID. Restituisce la configurazione dell'azione inclusi i parametri actionParameters.

  • Delete Agent Action: Elimina un'azione esistente da un agente Voice AI. Rimuove definitivamente l'azione e la sua configurazione.

Clicca qui per accedere alla documentazione API Voice AI sulle Azioni

Schermata 3 — API Pubbliche Voice AI

Domande frequenti

D: Posso gestire le voci tramite API?

Sì. Puoi usare le Voices APIs per recuperare le voci disponibili e ottenere metadati dettagliati, inclusi gli URL di anteprima, per scegliere la voce giusta per il tuo agente.

D: Ho bisogno di permessi speciali per usare queste API?

Devi avere un accesso HITLEAD appropriato per gestire Voice AI e leggere i dati delle chiamate. Coordina con l'amministratore del tuo account se non riesci ad accedere a determinate risorse.

D: Dove trovo gli endpoint e gli schemi di richiesta/risposta più aggiornati?

Usa sempre la documentazione API ufficiale: Clicca qui per visualizzare la documentazione API

Articoli correlati

  • API HITLEAD

  • Integrazioni Private: tutto quello che devi sapere

  • Come usare Webhook.site per diagnosticare le richieste API

  • Panoramica degli Agenti Voice AI

  • Log delle Chiamate per gli Agenti Voice AI

  • Dashboard Agenti Voice AI