Gateway di telefonia Dialogflow

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

La funzionalità del gateway di telefonia Dialogflow fornisce un'interfaccia telefonica per l'agente. Viene utilizzata per creare soluzioni IVR (risposta vocale interattiva) conversazionali 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 del gateway di telefonia, consulta le pagine Prezzi e Quote e limiti.

Limitazioni

Supporto dei linguaggi

Questa integrazione supporta l'utilizzo di una sola lingua per agente.

Se i modelli vocali avanzati sono abilitati per l'agente, questa integrazione supporta solo le seguenti lingue:

• Inglese (en)
• Inglese - Stati Uniti (en-US)

Se i modelli vocali avanzati sono disabilitati per l'agente, consulta la colonna Telefono nella pagina di riferimento della lingua per l'elenco delle lingue supportate.

Supporto dei numeri di telefono

Sono supportati solo i numeri di telefono statunitensi, sia per le chiamate in entrata sia per i trasferimenti di chiamata.

Prima di iniziare

Prima di leggere questa guida, devi:

1. Leggi le nozioni di base su Dialogflow.
2. Esegui i passaggi di configurazione.

Crea un agente

Se non hai ancora creato un agente, creane uno ora:

1. Vai alla console di Dialogflow ES.
2. Se richiesto, accedi alla console di Dialogflow. Per ulteriori informazioni, consulta la panoramica della console di Dialogflow.
3. Fai clic su 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.)
4. Inserisci il nome, la lingua predefinita e il fuso orario predefinito dell'agente.
5. Se hai già creato un progetto, inseriscilo. Se vuoi consentire alla console di Dialogflow di creare il progetto, seleziona Crea un nuovo progetto Google.
6. Fai clic sul pulsante Crea.

Importa il file di esempio nell'agente

I passaggi descritti in questa guida presuppongono che tu abbia un agente, quindi devi importarne uno 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:

1. Scarica il telephony-bot.zip file.
2. Vai alla console di Dialogflow ES.
3. Seleziona l'agente.
4. Fai clic sul pulsante delle impostazioni accanto al nome dell'agente.
5. Seleziona la scheda Esporta e importa.
6. Seleziona Ripristina da ZIP e segui le istruzioni per ripristinare il file ZIP che hai scaricato.

Abilita le funzionalità beta

Assicurati che le funzionalità beta siano abilitate:

1. Vai alla console di Dialogflow ES.
2. Seleziona un agente.
3. Fai clic sul pulsante delle impostazioni accanto al nome dell'agente.
4. Scorri verso il basso nella scheda Generali e assicurati che l'opzione Funzionalità beta sia abilitata.
5. Se hai apportato modifiche, fai clic su Salva.

Configura un gateway di telefonia

Per configurare il gateway:

1. Seleziona un fornitore:
   1. Vai alla console di Dialogflow ES.
   2. Seleziona l'agente.
   3. Fai clic su Integrazioni.
      
   4. Fai clic su Gateway di telefonia Dialogflow.
      
2. Configura il gateway di telefonia:
   1. Seleziona la lingua.
   2. Seleziona il codice paese per il numero di telefono.
   3. (Facoltativo) Seleziona i prefissi preferiti. Fai clic su **Avanti**. 
   4. Fai clic su Avanti.
      
3. Scegli un numero di telefono dall'elenco.
   1. Fai clic su **Crea**. 
   2. Haga clic en Crear.
      
4. Il gateway è ora attivo.
   1. (Facoltativo) Modifica l'ambiente.
   2. Facoltativamente, cambia l'ambiente.
   3. Puoi fare di nuovo clic sul pulsante di integrazione **Gateway di telefonia Dialogflow** per recuperare queste informazioni.  Puoi fare di nuovo clic sul pulsante delle integrazioni Gateway di telefonia Dialogflow per recuperare queste informazioni.
      

Ora puoi chiamare il numero e seguire le semplici istruzioni vocali.

Le interazioni sono definite nell'agente. **Nota:** per questa funzionalità sono previste quote e limiti.

Nota: Sono previste quote e limiti per questa funzionalità. Se ricevi un segnale di occupato o la chiamata cade, potresti aver superato la tua quota.

Nota: Se decidi di eliminare il tuo agente ma continui a utilizzare il tuo Google Cloud progetto, disabilita l'integrazione del gateway telefonico prima dell'eliminazione dell'agente.

Ora che hai un agente del gateway di telefonia funzionante, esaminiamo gli intent che hai importato.

Questo ti aiuterà a capire come creare i tuoi agenti del gateway di telefonia. Dai il benvenuto al chiamante

Quando hai chiamato il numero, l'agente ti ha dato il benvenuto e ti ha fornito un elenco di opzioni.

Segui questi passaggi per vedere come è stata configurata: Vai alla console di Dialogflow ES.

1. Vai alla console di Dialogflow ES.
2. Fai clic su **Intent**.
3. Fai clic su Intent di benvenuto predefinito.
4. Scorri verso il basso fino alla sezione Eventi.
5. Scorri verso il basso fino alla sezione Eventi. Nota che sono presenti sia gli eventi Benvenuto (WELCOME) che Benvenuto telefonico (TELEPHONY_WELCOME) eventi , il che significa che tutti i tipi di eventi di benvenuto attiveranno questo intent. In alternativa, puoi creare intent separati, ciascuno dedicato a un evento di benvenuto specifico.
6. Scorri fino alla sezione Risposte e fai clic sulla scheda Gateway di telefonia Dialogflow.
7. Risposta al comando di test

Dopo aver risposto con "test", l'agente ha presentato un nuovo elenco di opzioni.

Segui questi passaggi per vedere come è stata configurata: Fai clic su **Intent**.

1. Fai clic su Testa intent di telefonia.
2. Scorri verso il basso fino alla sezione Risposte e fai clic sulla scheda GATEWAY DI TELEFONIA DIALOGFLOW.
3. Scorri fino alla sezione Risposte e fai clic sulla scheda Gateway di telefonia Dialogflow.
4. Nota che la risposta Sintetizza voce contiene la risposta che hai sentito dopo aver detto "test".

Dopo aver detto "test", puoi eseguire due possibili comandi: "transfer" o "terminate".

Questa non è una limitazione degli agenti del gateway di telefonia, ma è solo il modo in cui è definito questo intent. Gli intent associati a questi comandi vengono forniti con il contesto. Segui questi passaggi per vedere come è stata configurata: context. Scorri fino alla sezione **Contesto** nella parte superiore.

1. Nota il contesto di output TestTelephonyIntent-followup.
2. Fai clic su Intent.
3. Fai clic sul pulsante di espansione accanto a Testa intent di telefonia.
4. Fai clic su Testa intent di telefonia - Termina.
5. Scorri fino alla sezione Contesto nella parte superiore.
6. Nota il contesto di input TestTelephonyIntent-followup.
7. Termina la chiamata

Quando hai risposto con "terminate", l'agente ha detto "goodbye" e ha terminato la chiamata.

Segui questi passaggi per vedere come è stata configurata: Scorri verso il basso fino alla sezione **Frasi di addestramento** e prendi nota delle frasi utilizzate per terminare la chiamata.

1. Scorri verso il basso fino alla sezione Frasi di addestramento e prendi nota delle frasi utilizzate per terminare la chiamata.
2. Scorri fino alla sezione Risposte e fai clic sulla scheda Gateway di telefonia Dialogflow.
3. Tieni presente che l'opzione Imposta questo intent come fine della conversazione è abilitata.
4. Se questa opzione è abilitata, Dialogflow termina la chiamata telefonica dopo aver riprodotto tutti gli altri prompt audio. **Nota:** se utilizzi il fulfillment, puoi terminare una chiamata impostando il campo `end_interaction` del messaggio WebhookResponse.

Nota: Se utilizzi fulfillment, puoi terminare una chiamata impostando il campo end_interaction del messaggio WebhookResponse.

Gli intent di questo esempio utilizzano messaggi di risposta avanzati per le risposte del gateway di telefonia.

Gli intent per questo esempio utilizzano messaggi di risposta avanzati per le risposte del gateway telefonico. Riproduci audio: riproduce il file audio fornito.

• Riproduci audio: Riproduce il file audio fornito. Ad esempio, "gs://Cloud Storage/object". L'oggetto deve contenere un singolo canale (mono) di audio PCM lineare (2 byte/campione) a 8 kHz. L'oggetto deve contenere un singolo canale (mono) di audio PCM lineare (2 byte / campione) a 8 kHz.
• Sintetizza voce: Sintetizza il testo fornito in audio e lo riproduce. In alternativa, puoi abilitare Utilizza 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 abiliti Utilizza la risposta dalla scheda PREDEFINITA come prima risposta, solo il testo popolato in QueryResult.fulfillment_text (popolato con una risposta di testo selezionata casualmente), viene sintetizzato in audio.
• Trasferisci chiamata: Trasferisce il chiamante a un altro numero. La durata della chiamata trasferita è inclusa nella durata totale della chiamata e gli addebiti di Dialogflow vengono applicati fino al termine della chiamata.

Nota: Quando aggiungi un messaggio avanzato, puoi passare il mouse sopra il ? Impostazioni dell'agente

Puoi controllare vari aspetti della sintesi vocale.

Consulta le impostazioni vocali dell'agente. Vedi le impostazioni vocali dell'agente.

Quando testi o sperimenti con un agente del gateway di telefonia, non devi effettuare una chiamata telefonica.

Puoi interagire con l'agente e ricevere risposte audio tramite il simulatore di Dialogflow: Puoi interagire con l'agente e ricevere risposte audio tramite il simulatore Dialogflow:

1. Modifica **Risposta predefinita** in **GATEWAY DI TELEFONIA DIALOGFLOW**.
2. Modifica Risposta predefinita in Gateway di telefonia Dialogflow
3. Fai clic sul pulsante Riproduci audio per ascoltare la risposta dell'agente
4. Continua la conversazione con l'agente

Puoi richiedere un numero di telefono con prefisso 833.

Tieni presente che i numeri verdi hanno un prezzo più alto. Eventi che i numeri verdi sono prezzati più in alto.

I seguenti eventi vengono richiamati da questa integrazione:

Eventos

Descrizione	Viene attivato quando qualcuno chiama il numero di telefono associato al tuo agente Dialogflow.
TELEPHONY_WELCOME	Riscaldamento 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.

Quando un utente finale chiama un agente del Gateway di telefonia Dialogflow, Dialogflow inizia caricando l'agente per una risposta rapida alla prima espressione dell'utente finale. Dialogflow esegue questa operazione inviando una richiesta di rilevamento dell'intent all'agente. Il testo di questa richiesta è `TELEPHONY_WARMUP`. Il testo di questa richiesta è TELEPHONY_WARMUP

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 viene oscurato.OriginalDetectIntentRequest.payload Nella versione di prova di Dialogflow, il valore caller_id viene oscurato.