Questo articolo mostra come utilizzare le Azioni Personalizzate (Custom Actions) di Voice AI per abilitare integrazioni webhook in tempo reale durante le chiamate attive. Questa potente funzionalità consente agli agenti AI di interagire con sistemi esterni a metà conversazione—recuperando dati, eseguendo processi e migliorando l'automazione senza dover attendere la fine della chiamata.
- Cosa sono le Custom Actions di Voice AI?
- Vantaggi principali delle Custom Actions di Voice AI
- Trigger di Conversazione Voice AI
- Webhook Custom Action
- Raccolta Dinamica dei Parametri
- Come configurare le Custom Actions di Voice AI
- Voice AI - Test in Tempo Reale
- Domande Frequenti
- Articoli Correlati
Cosa sono le Custom Actions di Voice AI?
Le Custom Actions di Voice AI consentono agli agenti AI di attivare chiamate POST webhook personalizzate verso API esterne durante una conversazione in corso. Queste azioni possono includere autenticazione, intestazioni (header) e parametri dinamici raccolti in tempo reale dalla chiamata. Questo permette agli agenti di recuperare o inviare informazioni istantaneamente in base a ciò che dice il chiamante.
Vantaggi principali delle Custom Actions di Voice AI
Le Custom Actions di Voice AI abilitano integrazioni fluide con sistemi esterni direttamente durante una chiamata attiva. Questo migliora la capacità dell'agente di personalizzare le risposte e risolvere i problemi più rapidamente.
Esegui chiamate API in tempo reale attivate da segnali della conversazione.
Automatizza ricerche dati o invii di informazioni a metà chiamata.
Ad esempio: Se un cliente chiede "Qual è lo stato del mio ordine recente?", l'AI può richiamare immediatamente il sistema di gestione ordini e recuperare lo stato in tempo reale—senza mettere il chiamante in attesa.
Configura richieste POST con autenticazione e intestazioni.
Trasmetti dinamicamente i dati della chiamata, come numeri di telefono o ID ordine.
Testa le risposte webhook prima di andare in produzione.
Riduci le attività di follow-up risolvendo le esigenze durante la chiamata.
Trigger di Conversazione Voice AI
I Trigger definiscono le condizioni in base alle quali una Custom Action viene eseguita durante la chiamata. Puoi creare trigger semplici basati su frasi o configurare logiche più complesse. I trigger possono essere combinati con condizioni come "esegui solo se il parametro X è presente".
Esempi di trigger:
Quando un utente dice: "Voglio controllare il mio appuntamento."
Quando viene menzionata un'e-mail.
Quando viene pronunciata una sequenza di cifre (es. un numero d'ordine).
Webhook Custom Action
L'integrazione webhook è il nucleo delle Custom Actions di Voice AI. Consente ai tuoi agenti di interagire con qualsiasi sistema esterno che supporti API—CRM, strumenti di pianificazione, database e altro ancora.
Ogni Custom Action è definita da una richiesta POST, che può includere:
Un URL endpoint webhook.
Intestazioni (es. chiavi API, token).
Un corpo della richiesta con parametri dinamici.
Autenticazione (Bearer token, Basic Auth, ecc.).
Esempio: Se stai integrando un CRM come Salesforce, l'URL webhook potrebbe puntare a un endpoint come /api/v1/lookupContact e includere parametri come l'e-mail o il numero di telefono del contatto.
Raccolta Dinamica dei Parametri
Voice AI è in grado di estrarre ed etichettare i dati rilevanti in tempo reale durante le conversazioni. Questi valori vengono assegnati automaticamente ai parametri utilizzati nella richiesta webhook. Questo è utile quando, ad esempio, l'AI deve estrarre sia un numero d'ordine che un indirizzo e-mail prima di avviare la ricerca dello stato di spedizione. Puoi assegnare questi valori estratti al payload webhook, garantendo che l'integrazione sia contestuale e personalizzata.
Tipi di dati supportati:
Testo (String)
Numero (Numeric)
E-mail
Numero di telefono
Data
Come configurare le Custom Actions di Voice AI
Le Custom Actions di Voice AI possono essere configurate dall'interfaccia dell'Agente Voice AI in pochi passaggi. Ecco come iniziare:
Passo 1: Accedi al tuo Agente Voice AI
Vai su Voice AI > Obiettivi dell'Agente (Agent Goals) > Passa alla Modalità Avanzata (Switch to Advanced Mode) (Se non già abilitata) > Azioni Personalizzate (Custom Actions).
Passo 2: Crea una Custom Action
Clicca su + Nuova Azione (+ New Action) per aprire la finestra di configurazione della custom action.
Passo 3: Configura la Custom Action
Inserisci tutti i dettagli necessari per la custom action. Non tutti sono obbligatori.
Nome
Imposta le condizioni del trigger di conversazione
Ad esempio: Se un utente chiede "controlla il saldo del mio conto", puoi impostare un trigger con la frase "controlla il saldo" e definire un parametro per il numero di telefono da passare alla tua API bancaria.
Aggiungi il tuo URL Webhook e seleziona POST come metodo.
Aggiungi eventuali intestazioni (header) personalizzate se necessario.
Inserisci i dati di autenticazione richiesti (es. Bearer token).
Definisci i parametri estratti dinamicamente dalla conversazione.
Usa la funzione Test Webhook per validare la configurazione.
Voice AI - Test in Tempo Reale
Prima di salvare una Custom Action, puoi utilizzare lo strumento integrato Test Webhook. Questo ti consente di simulare uno scenario di chiamata, passare dati di test e visualizzare la risposta del tuo sistema esterno in tempo reale. Puoi usare lo strumento di test per simulare un cliente che chiede di "riprogrammare un appuntamento" e verificare se il webhook recupera e invia correttamente la data e l'ora fornite al tuo sistema di Calendari.
Potrai:
Visualizzare la richiesta completa (intestazioni + corpo).
Vedere la risposta grezza (200 OK, 404 Not Found, ecc.). Ad esempio, se la risposta webhook include una data di consegna stimata, il tuo agente AI può informare immediatamente il chiamante: "Il tuo pacco è previsto in arrivo entro giovedì."
Identificare e correggere eventuali errori di configurazione prima di salvare.
Domande Frequenti
D: Posso usare GET o altri tipi di richiesta?
No, attualmente per le Custom Actions sono supportate solo le richieste POST.
D: Dove posso accedere alle Custom Actions di Voice AI?
Puoi accedervi tramite Voice AI > Obiettivi dell'Agente (Agent Goals) > Passa alla Modalità Avanzata (Switch to Advanced Mode) (Se non già abilitata) > Azioni Personalizzate (Custom Actions).
D: L'autenticazione è supportata nei webhook?
Sì, puoi utilizzare Bearer token, Basic Auth, oppure passare chiavi nelle intestazioni.
D: Cosa succede se il mio webhook fallisce durante la chiamata?
Il sistema registra il fallimento e può essere definito un comportamento di fallback nel caso in cui non vengano restituiti dati o il webhook vada in timeout.
D: Posso attivare più webhook durante una singola chiamata?
Sì. Ogni Custom Action può essere attivata in modo indipendente in base alle proprie condizioni.
D: Ho bisogno di uno sviluppatore per configurare queste azioni?
Non necessariamente. Finché hai accesso alla documentazione API del sistema esterno, puoi configurarlo con competenze tecniche minime.