La funzionalità gateway telefonico Dialogflow fornisce un'interfaccia telefonica al tuo agente. Viene utilizzato per creare soluzioni di IVR conversazionale (risposta vocale interattiva) che si integrano con il resto della rete dei call center. Al momento puoi selezionare un numero di telefono ospitato da Google.
Per informazioni su prezzi e quote del gateway telefonico, consulta Prezzi e Quote e limiti pagine.
Limitazioni
Supporto dei linguaggi
Questa integrazione supporta solo l'utilizzo di una lingua per agente.
Se modelli vocali avanzati sia abilitato per l'agente, questa integrazione supporta solo le seguenti lingue:
- Inglese (en)
- Inglese - US (en-US)
Se i modelli vocali avanzati sono disabilitati per l'agente, vedi la colonna Phone (Telefono) nella Pagina Riferimento lingua per l'elenco di lingue supportate.
Assistenza tramite numero di telefono
Sono supportati solo i numeri di telefono degli Stati Uniti, sia per le chiamate in arrivo che per le chiamate trasferimenti.
Prima di iniziare
Prima di leggere questa guida, devi procedere nel seguente modo:
- Leggi le nozioni di base su Dialogflow.
- Esegui la procedura 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 Dialogflow. Per ulteriori informazioni, consulta la panoramica della console Dialogflow.
- Fai clic su Create Agent (Crea agente) nel menu della barra laterale 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, la lingua e il fuso orario predefiniti dell'agente.
- Se hai già creato un progetto, inseriscilo. Se vuoi consentire alla console di 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 in questa guida fanno delle ipotesi sul tuo agente, quindi devi importa un agente preparato per questa guida. Durante l'importazione, questi passaggi utilizzano l'opzione ripristina, che sovrascrive tutte le impostazioni, gli intent e le entità dell'agente.
Per importare il file:
-
Scarica il
telephony-bot.zip
. - Vai alla console Dialogflow ES.
- Seleziona l'agente.
- Fai clic sull' pulsante impostazioni settings accanto al nome dell'agente.
- Seleziona la scheda Esporta e importa.
- Seleziona Ripristina da ZIP e segui le istruzioni per ripristinare il file ZIP che hai scaricato.
Attiva le funzionalità beta
Assicurati che le funzionalità beta siano attivate:
- Vai alla console Dialogflow ES.
- Seleziona un agente.
- Fai clic sul pulsante delle impostazioni settings accanto al nome dell'agente.
- Scorri verso il basso mentre ti trovi nella scheda Generali e assicurati che l'opzione Funzionalità beta sia attiva.
- Se hai apportato modifiche, fai clic su Salva.
Configurare un gateway telefonico
Per configurare il gateway, segui questi passaggi:
- Seleziona un fornitore:
- Vai alla console Dialogflow ES.
- Seleziona l'agente.
- Fai clic su Integrations (Integrazioni).
- Fai clic su Gateway telefonica Dialogflow.
- Configura Phone Gateway:
- Seleziona la lingua.
- Seleziona il prefisso internazionale per il numero di telefono.
- Facoltativo. Seleziona i prefissi preferiti.
- Fai clic su Next (Avanti).
- Seleziona un numero:
- Scegli un numero di telefono dall'elenco.
- Fai clic su Crea.
- Completamento:
- Ora il gateway è attivo.
- Se vuoi, modifica l'ambiente.
- Salva il numero di telefono visualizzato e chiudi la finestra di dialogo.
Puoi fare di nuovo clic sul pulsante delle integrazioni Dialogflow Phone Gateway per recuperare queste informazioni.
Chiama il numero di telefono
Ora puoi chiamare il numero e seguire semplici comandi vocali. Le interazioni sono definite nell'agente.
Esamina gli intent
Ora che hai un agente gateway telefonico funzionante, diamo un'occhiata agli intent che hai importato. In questo modo, potrai capire come creare i tuoi agenti gateway telefonici.
Dai il benvenuto al chiamante
Quando hai chiamato il numero, l'agente ti ha accolto e ti ha fornito un elenco di opzioni. Per verificare la configurazione, segui questi passaggi:
- Vai alla console Dialogflow ES.
- Seleziona l'agente.
- Fai clic su Intent.
- Fai clic su Intent di benvenuto predefinito.
- Scorri verso il basso fino alla sezione Eventi.
Tieni presente che sia Benvenuto (
WELCOME
) sia Benvenuto nella telefonia (TELEPHONY_WELCOME
) eventi sono presenti, il che significa che tutti i tipi di eventi di benvenuto attiveranno questo intent. In alternativa, puoi creare intent distinti, ciascuno dedicato a uno specifico evento di benvenuto. - Scorri verso il basso fino alla sezione Risposte e fai clic sulla scheda GATEWAY TELEFONALE DI DIALOGFLOW.
- Tieni presente che la risposta Sintetizza parlato contiene il messaggio di benvenuto sentito durante la chiamata al numero.
Risposta al comando di prova
Dopo che hai risposto con "test", l'agente ha presentato un nuovo elenco di opzioni. Per verificare la configurazione, segui questi passaggi:
- Fai clic su Intent.
- Fai clic su Test Telephony Intent.
- Scorri verso il basso fino alla sezione Risposte e fai clic sulla scheda GATEWAY TELEFONALE DI DIALOGFLOW.
- Tieni presente che la risposta Sintetizza vocale contiene la risposta che hai ascoltato dopo aver detto "test".
Impostazione del contesto
Dopo aver detto "test", puoi eseguire due comandi: "transfer" o "terminare". Questo non è un limite degli agenti gateway telefonici, ma è solo come viene definito questo intent. Gli intent associati a questi comandi sono forniti contesto. Per verificare la configurazione, segui questi passaggi:
- Scorri fino alla sezione Contesto in alto.
- Osserva il contesto di output TestTelephonyIntent-followup.
- Fai clic su Intent.
- Fai clic sul pulsante di espansione accanto a Test Telephony Intent.
- Fai clic su Testa intent di telefonia - Termina.
- Scorri fino alla sezione Contesto in alto.
- Nota il contesto di input del contesto di input TestTelephonyIntent-followup.
Termina la chiamata
Se hai risposto con "terminate", l'agente ha detto "arrivederci" e hai terminato la chiamata. Per verificare la configurazione, segui questi passaggi:
- 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 GATEWAY TELEFONALE DI DIALOGFLOW.
- Tieni presente che la risposta Sintetizza parlato contiene "addio".
- Tieni presente che l'opzione Imposta questo intent come fine della conversazione è attiva. Se questa opzione è abilitata, Dialogflow termina la telefonata dopo aver riprodotto tutti gli altri prompt audio.
Messaggi di risposta avanzata per il gateway telefonico
Per questo esempio, gli intent 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 il parlato:
Sintetizza il testo fornito in audio e lo riproduce.
In alternativa, puoi attivare
Usa la risposta della scheda PREDEFINITA come prima risposta,
che utilizzerà la risposta predefinita per sintetizzare una risposta vocale.
Se definisci solo risposte predefinite,
e non attivi
Usa la risposta della scheda PREDEFINITA come prima risposta,
solo il testo compilato in
QueryResult.fulfillment_text
(compilata con una risposta di testo selezionata casualmente), viene sintetizzato in audio. - Trasferisci chiamata: Trasferisce il chiamante a un altro numero. Il tempo trascorso nella chiamata trasferita è incluso nella durata totale della chiamata e Dialogflow addebiti vengono applicati fino al termine della chiamata.
Impostazioni dell'agente
Puoi controllare diversi aspetti della sintesi vocale. Visualizza le impostazioni vocali dell'agente.
Utilizzare il simulatore Dialogflow
Quando esegui test o sperimenta con un agente gateway telefonico, non serve fare una telefonata. Puoi interagire con l'agente e ricevere risposte audio tramite il Simulatore Dialogflow:
- Digita "ciao" e premi il tasto Invio
- Cambia Risposta predefinita in DIALOGFLOW PHONE GATEWAY.
- Fai clic sul pulsante Riproduci audio per ascoltare la risposta dell'agente.
- Continua la conversazione con l'agente
Numeri verdi
Puoi richiedere un numero di telefono con un prefisso 833. Tieni presente che i numeri verdi a un prezzo più alto.
Eventi
I seguenti eventi sono richiamati da questa integrazione:
Evento |
Descrizione |
---|---|
TELEPHONY_WELCOME |
Si attiva quando qualcuno chiama il numero di telefono associato all'agente Dialogflow. |
Riscaldamento agente
Quando un utente finale chiama un agente Gateway di telefonia Dialogflow,
Dialogflow avvia il caricamento dell'agente
per una rapida risposta all'espressione iniziale dell'utente finale.
Durante il caricamento dell'agente, il telefono continua a squillare.
Dialogflow consente di farlo inviando una richiesta di rilevamento di intent al tuo agente.
Il testo di questa richiesta è TELEPHONY_WARMUP
.
Recuperare il numero di telefono del chiamante
Puoi recuperare il valore caller_id
dal
OriginalDetectIntentRequest.payload
nella richiesta webhook
se utilizzi la versione di Dialogflow Essentials.
Nella versione di prova di Dialogflow, il valore caller_id
è oscurato.