Questo articolo spiega come usare le Azioni Personalizzate per Voice AI per inviare richieste POST webhook in tempo reale durante le chiamate attive. Le Azioni Personalizzate consentono agli agenti Voice AI di interagire con sistemi esterni nel corso della conversazione — ad esempio per cercare dati, inviare informazioni o avviare processi esterni prima che la chiamata termini.

INDICE

Cosa sono le Azioni Personalizzate per Voice AI?

Le Azioni Personalizzate per Voice AI consentono agli agenti di inviare richieste POST webhook personalizzate verso API esterne durante una conversazione in corso. Queste azioni possono includere URL webhook, header, autenticazione e parametri dinamici raccolti dal chiamante in tempo reale. In questo modo l'agente può recuperare o inviare informazioni in base a ciò che il chiamante dice durante la chiamata.

Vantaggi principali

Le Azioni Personalizzate per Voice AI permettono agli agenti di connettersi con sistemi esterni durante una chiamata attiva, personalizzare le risposte, recuperare informazioni e completare i task più rapidamente.

  • Invia richieste POST webhook in tempo reale in base all'intenzione del chiamante o ai segnali della conversazione.

  • Cerca o invia informazioni durante la chiamata.

    (Esempio: se un chiamante chiede "Qual è lo stato del mio ordine recente?", l'AI può interrogare il tuo sistema di gestione ordini e recuperare lo stato senza mettere il chiamante in attesa.)

  • Configura URL webhook, header e autenticazione.

  • Passa dati dinamici della chiamata, come numeri di telefono, indirizzi email, date o ID ordine.

  • Testa le richieste e le risposte webhook prima di salvare l'azione.

  • Riduci i follow-up manuali risolvendo più richieste direttamente durante la chiamata.

Trigger di conversazione Voice AI

I trigger di conversazione definiscono quando un'Azione Personalizzata deve essere eseguita durante una chiamata. Un Trigger può basarsi su ciò che dice il chiamante, sulle informazioni che fornisce o sull'intenzione rilevata dall'agente Voice AI.

Esempi di Trigger:

  • Quando un chiamante dice: "Voglio controllare il mio appuntamento."
  • Quando il chiamante fornisce un indirizzo email.
  • Quando il chiamante fornisce una sequenza di cifre, come un numero d'ordine, un ID prenotazione o un numero di conto.

Schermata 1 — Azioni Personalizzate per Voice AI

Azione Personalizzata Webhook

L'integrazione webhook è il nucleo delle Azioni Personalizzate per Voice AI. Consente al tuo agente Voice AI di interagire con sistemi esterni che supportano le richieste API, come CRM, strumenti di pianificazione, database, sistemi di gestione ordini e altre applicazioni aziendali.

Ogni Azione Personalizzata è definita da una richiesta POST che può includere:

  • Un URL endpoint webhook
  • Header, come chiavi API o token
  • Autenticazione, come Bearer token o Basic Auth
  • Un corpo della richiesta con parametri dinamici raccolti durante la chiamata

Esempio: se stai integrando un CRM, il tuo URL webhook potrebbe puntare a un endpoint come /api/v1/lookupContact e includere parametri come l'indirizzo email o il numero di telefono del chiamante.

Esempio: Se stai integrando un CRM come Salesforce, il tuo URL webhook potrebbe puntare a un endpoint come /api/v1/lookupContact e includere parametri come l'email o il numero di telefono del contatto.

Schermata 2 — Azioni Personalizzate per Voice AI

Raccolta dinamica dei parametri

Voice AI può estrarre e classificare le informazioni rilevanti durante una conversazione in corso. Questi valori possono essere assegnati ai parametri nel corpo della richiesta webhook. Questa funzione è utile quando l'AI deve raccogliere dettagli come un numero d'ordine, un indirizzo email, un numero di telefono o una data di appuntamento prima di inviare la richiesta webhook.

Tipi di dati supportati:

  • Testo / Stringa
  • Numero / Numerico
  • Email
  • Numero di telefono
  • Data

Schermata 3 — Azioni Personalizzate per Voice AI

Come configurare le Azioni Personalizzate per Voice AI

Le Azioni Personalizzate per Voice AI si configurano dall'interfaccia dell'agente Voice AI in pochi passaggi. Ecco come iniziare:

Step 1: Accedi al tuo agente Voice AI

Vai su Voice AI > Agent Goals > Switch to Advanced Mode (se non è già attivo) > Custom Actions.

Schermata 4 — Azioni Personalizzate per Voice AI

Step 2: Aggiungi un'Azione Personalizzata

Nella sezione "Setup your Actions", clicca su Custom Action per aprire la finestra di configurazione dell'azione personalizzata.

Schermata 5 — Azioni Personalizzate per Voice AI

Step 3: Configura l'Azione Personalizzata

Inserisci i dettagli richiesti per l'Azione Personalizzata. Alcuni campi potrebbero essere opzionali a seconda della configurazione del tuo webhook.

  1. Inserisci un nome per l'Azione Personalizzata.

  2. Imposta le condizioni del Trigger di conversazione.

    Esempio: se un chiamante chiede di "controllare il saldo del conto", puoi impostare un Trigger per quella richiesta e definire un parametro numero di telefono da passare alla tua API esterna.

  3. Aggiungi il tuo URL webhook.

  4. Verifica che il metodo di richiesta sia POST.

  5. Aggiungi eventuali header necessari.

  6. Inserisci i dettagli di autenticazione se richiesto, come un Bearer token o Basic Auth.

  7. Definisci i parametri dinamici da raccogliere dalla conversazione.

  8. Usa la funzione Test Webhook per validare la configurazione prima di salvare.

Schermata 6 — Azioni Personalizzate per Voice AISchermata 7 — Azioni Personalizzate per Voice AI

Voice AI – Test in tempo reale

Prima di salvare un'Azione Personalizzata, usa lo strumento Test Webhook integrato per validare la richiesta e la risposta. Questo ti consente di passare dati di test, verificare la richiesta webhook e confermare che il tuo sistema esterno restituisca la risposta attesa.

Potrai:

  • Esaminare la richiesta completa, inclusi header e corpo.
  • Visualizzare la risposta grezza del webhook, come 200 OK, 400 Bad Request o 404 Not Found.
  • Verificare che i dati restituiti possano essere usati dall'agente Voice AI durante la chiamata.
  • Identificare e correggere problemi di configurazione prima di salvare.

Schermata 8 — Azioni Personalizzate per Voice AI

Domande frequenti

D: Posso usare GET o altri tipi di richiesta?

No, per le Azioni Personalizzate sono attualmente supportate solo le richieste POST.

D: Dove accedo alle Azioni Personalizzate per Voice AI?

Puoi accedere alle Azioni Personalizzate andando su AI Agents > Voice AI, quindi creando o modificando un agente Voice AI. Nell'area di configurazione dell'agente, vai su "Setup your Actions" e seleziona Custom Action.

D: L'autenticazione è supportata nei webhook?

Sì, puoi usare Bearer token, Basic Auth o passare chiavi negli header.

D: Cosa succede se il webhook fallisce durante la chiamata?

Il sistema registra il fallimento. Puoi definire un comportamento di fallback per i casi in cui non vengono restituiti dati, la richiesta fallisce o il webhook va in timeout.

D: Posso attivare più webhook durante una singola chiamata?

Sì. Ogni Azione Personalizzata può essere attivata in modo indipendente in base alle proprie condizioni.

D: Ho bisogno di uno sviluppatore per configurare queste azioni?

Non sempre. Le configurazioni webhook di base possono essere impostate da utenti che dispongono della documentazione API del sistema esterno. Casi d'uso più avanzati, requisiti di autenticazione o payload personalizzati potrebbero richiedere l'aiuto di uno sviluppatore.

D: Quale metodo di richiesta è supportato?

Le Azioni Personalizzate supportano attualmente le richieste POST.

Articoli correlati

  • Panoramica degli agenti Voice AI
  • Creazione di agenti Voice AI
  • Orari di lavoro per i dipendenti AI
  • Flusso delle chiamate in entrata per Voice AI
  • Azioni Personalizzate per Voice AI