La funzionalità di gateway di telefonia Dialogflow fornisce un'interfaccia telefonica all'agente. Viene utilizzata per creare soluzioni IVR (risposta vocale interattiva) di conversazione che si integrano con il resto della rete del call center. Al momento puoi selezionare un numero di telefono ospitato da Google.
Per informazioni sui prezzi e sulle quote dei gateway per telefoni, consulta le pagine Prezzi e Quote e limiti.
Limitazioni
Supporto dei linguaggi
Questa integrazione supporta l'utilizzo di una sola lingua per agente.
Se per l'agente sono attivati i modelli vocali avanzati, questa integrazione supporta solo le seguenti lingue:
- Inglese (en)
- Inglese - Stati Uniti (en-US)
Se i modelli vocali avanzati sono disattivati per l'agente, consulta la colonna Telefono nella pagina Riferimento alle lingue per l'elenco delle lingue supportate.
Assistenza tramite numero di telefono
Sono supportati solo i numeri di telefono statunitensi, sia per le chiamate in arrivo sia per i trasferimenti di chiamata.
Prima di iniziare
Prima di leggere questa guida, devi:
- Leggi le nozioni di base su Dialogflow.
- Esegui i passaggi di configurazione.
Crea un agente
Se non hai ancora creato un agente, creane uno ora:
- Vai alla console Dialogflow ES.
- Se richiesto, accedi alla console di Dialogflow. Per ulteriori informazioni, consulta la panoramica della console di Dialogflow.
- Fai clic su Crea agente nel menu della barra laterale a sinistra. Se hai già altri agenti, fai clic sul nome dell'agente, scorri verso il basso e fai clic su Crea nuovo agente.
- Inserisci il nome dell'agente, la lingua predefinita e il fuso orario predefinito.
- Se hai già creato un progetto, inseriscilo. Se vuoi consentire alla console Dialogflow di creare il progetto, seleziona Crea un nuovo progetto Google.
- Fai clic su pulsante Crea.
Importa il file di esempio nell'agente
I passaggi descritti in questa guida fanno delle supposizioni sul tuo agente, quindi devi import un agente preparato per questa guida. Durante l'importazione, questi passaggi utilizzano l'opzione restore, che sovrascrive tutte le impostazioni, gli intent e le entità dell'agente.
Per importare il file:
-
Scarica il
file
telephony-bot.zip. - Vai alla console Dialogflow ES.
- Seleziona il tuo agente.
- Fai clic sul pulsante settings delle impostazioni accanto al nome dell'agente.
- Seleziona la scheda Esporta e importa.
- Seleziona Ripristina da file ZIP e segui le istruzioni per ripristinare il file ZIP scaricato.
Attivare le funzionalità beta
Assicurati che le funzionalità beta siano attive:
- Vai alla console Dialogflow ES.
- Seleziona un agente.
- Fai clic sul pulsante delle impostazioni settings accanto al nome dell'agente.
- Scorri verso il basso nella scheda Generali e assicurati che l'opzione Funzionalità beta sia attivata.
- Se hai apportato modifiche, fai clic su Salva.
Configurare un gateway per smartphone
Per configurare il gateway:
- Seleziona un fornitore:
- Vai alla console Dialogflow ES.
- Seleziona il tuo agente.
- Fai clic su Integrations (Integrazioni).
- Fai clic su Gateway di telefonia Dialogflow.
- Configura il gateway per smartphone:
- Seleziona la lingua.
- Seleziona il codice paese per il numero di telefono.
- Facoltativo. Seleziona i prefissi preferiti.
- Fai clic su Avanti.
- Seleziona un numero:
- Scegli un numero di telefono dall'elenco.
- Fai clic su Crea.
- Completamento:
- La porta di accesso è ora attiva.
- (Facoltativo) Modifica l'ambiente.
- Salva il numero di telefono visualizzato e chiudi la finestra di dialogo.
Puoi fare di nuovo clic sul pulsante di integrazione del gateway di telefonia Dialogflow per recuperare queste informazioni.
Chiama il numero di telefono
Ora puoi chiamare il numero e seguire i semplici prompt vocali. Le interazioni sono definite nell'agente.
Esamina le intenzioni
Ora che hai un agente gateway per telefono funzionante, esamina gli intent che hai importato. In questo modo, potrai capire come creare i tuoi agenti gateway per telefono.
Accogliere il chiamante
Quando hai chiamato il numero, l'agente ti ha salutato e fornito un elenco di opzioni. Per scoprire come è stata configurata questa opzione:
- Vai alla console Dialogflow ES.
- Seleziona il tuo agente.
- Fai clic su Intent.
- Fai clic su Intent di benvenuto predefinito.
- Scorri verso il basso fino alla sezione Eventi.
Tieni presente che sono presenti sia gli eventi
di benvenuto (
WELCOME) sia gli eventi di benvenuto per la telefonia (TELEPHONY_WELCOME), il che significa che tutti i tipi di eventi di benvenuto attiveranno questo intento. In alternativa, puoi creare intent separati, ciascuno dedicato a un evento di benvenuto specifico. - Scorri verso il basso fino alla sezione Risposte e fai clic sulla scheda DIALOGFLOW PHONE GATEWAY.
- Tieni presente che la risposta Sintetizza voce contiene il messaggio di benvenuto che hai sentito quando hai chiamato il numero.
Risposta al comando di test
Dopo che hai risposto con "test", l'agente ha presentato un nuovo elenco di opzioni. Per scoprire come è stata configurata questa opzione:
- Fai clic su Intent.
- Fai clic su Testa l'intent di telefonia.
- Scorri verso il basso fino alla sezione Risposte e fai clic sulla scheda DIALOGFLOW PHONE GATEWAY.
- Tieni presente che la risposta Synthesize speech contiene la risposta che hai sentito dopo aver detto "test".
Impostazione del contesto
Dopo aver detto "test", puoi dare due possibili comandi: "transfer" o "terminate". Non si tratta di una limitazione degli agenti di gateway per telefono, ma solo di come è definito questo intento. Gli intent associati a questi comandi sono forniti con il contesto. Per scoprire come è stata configurata questa opzione:
- Scorri fino alla sezione Contesto in alto.
- Nota il contesto di output TestTelephonyIntent-followup.
- Fai clic su Intent.
- Fai clic sul pulsante di espansione accanto a Testa l'intent di telefonia.
- Fai clic su Testa intent di telefonia - Termina.
- Scorri fino alla sezione Contesto in alto.
- Tieni presente il contesto di input TestTelephonyIntent-followup.
Terminare la chiamata
Quando hai risposto con "terminate", l'agente ha detto "arrivederci" e ha terminato la chiamata. Per scoprire come è stata configurata questa opzione:
- Scorri verso il basso fino alla sezione Frasi di addestramento e prendi nota delle frasi utilizzate per terminare la chiamata.
- Scorri verso il basso fino alla sezione Risposte e fai clic sulla scheda DIALOGFLOW PHONE GATEWAY.
- Tieni presente che la risposta di Sintesi vocale contiene "arrivederci".
- Tieni presente che l'opzione Imposta questo intent come fine della conversazione è attivata. Se questa opzione è attivata, Dialogflow termina la chiamata dopo aver riprodotto tutti gli altri prompt audio.
Messaggi di risposta avanzata del gateway di telefonia
Le intenzioni per questo esempio utilizzano messaggi di risposta avanzata per le risposte del gateway telefonico. Ecco i tipi che puoi utilizzare:
- Riproduci audio: riproduce il file audio fornito. Specifica l'URI di un oggetto Cloud Storage contenente l'audio da riprodurre. Ad esempio, "gs://bucket/object". L'oggetto deve contenere un singolo canale (mono) di audio PCM lineare (2 byte / campione) a 8 kHz.
- Sintetizza parlato:
sintetizzano il testo fornito in audio e lo riproducono.
In alternativa, puoi attivare Utilizza la risposta della scheda PREDEFINITO come prima risposta, che utilizzerà la risposta predefinita per sintetizzare una risposta vocale.
Se definisci solo le risposte predefinite e non attivi l'opzione Usa la risposta della scheda PREDEFINITO come prima risposta, viene sintetizzato in audio solo il testo inserito in
QueryResult.fulfillment_text(con una risposta di testo selezionata in modo casuale). - Trasferisci chiamata: trasferisce il chiamante a un altro numero. La durata della chiamata trasferita è inclusa nella durata totale della chiamata e i addebiti di Dialogflow vengono applicati fino al termine della chiamata.
Impostazioni dell'agente
Puoi controllare vari aspetti della sintesi vocale. Consulta le impostazioni vocali dell'agente.
Utilizzare il simulatore di Dialogflow
Quando testi o fai esperimenti con un agente gateway per telefono, non devi effettuare una chiamata. Puoi interagire con l'agente e ricevere risposte audio tramite il simulatore Dialogflow:
- Digita "ciao" e premi Invio
- Modifica Risposta predefinita in DIALOGFLOW PHONE GATEWAY
- Fai clic sul pulsante Riproduci audio per ascoltare la risposta dell'agente.
- Continuare la conversazione con l'agente
Numeri verdi
Puoi richiedere un numero di telefono con prefisso 833. Tieni presente che i numeri a tariffa agevolata hanno un prezzo più elevato.
Eventi
I seguenti eventi vengono richiamati da questa integrazione:
Evento |
Descrizione |
|---|---|
TELEPHONY_WELCOME |
Viene attivato quando qualcuno chiama il numero di telefono associato al tuo agente Dialogflow. |
Pre-avvio dell'agente
Quando un utente finale chiama un agente del Gateway di telefonia Dialogflow, Dialogflow inizia caricando l'agente per una risposta rapida all'espressione iniziale dell'utente finale.
Mentre l'agente viene caricato, lo smartphone continua a squillare.
Dialogflow esegue questa operazione inviando una richiesta di rilevamento dell'intent all'agente.
Il testo di questa richiesta è TELEPHONY_WARMUP.
Recuperare il numero di telefono del chiamante
Puoi recuperare il valore caller_id dal campo OriginalDetectIntentRequest.payload nella richiesta webhook se utilizzi la versione Dialogflow Essentials.
Nella versione di prova di Dialogflow, il valore caller_id è oscurato.