Il componente predefinito Saldo dell'account controlla il livello di autenticazione di un cliente e fornisce informazioni sul saldo dell'account a un cliente autenticato. Se il cliente ha più account, il componente conferma l'account specifico per cui il cliente vuole recuperare il saldo dell'account.
Questo componente utilizza il componente predefinito Autenticazione per autenticare gli utenti.
Limitazioni
Oltre alle limitazioni comuni dei componenti predefiniti, questo componente predefinito include le seguenti limitazioni:
- Questo componente non cripta i dati.
Esempi di dialoghi
Le finestre di dialogo di esempio mostrano gli scenari comuni gestiti da questo componente predefinito. Mostrano il comportamento quando l'utente chiama il componente utilizzando la telefonia, che attiva l'intent di benvenuto predefinito e la prima risposta dell'agente all'inizio della conversazione.
Un solo account
L'utente ha un solo account e gli viene fornito il saldo dell'account.
| Input utente | Risposta dell'agente |
|---|---|
| L'agente autentica l'utente utilizzando il componente predefinito Autenticazione. | |
| Grazie, l'autenticazione è stata completata. | |
| Attendi il recupero dei dettagli dell'account. Il saldo associato all'account che termina con 4567 è di 50,00 $. |
Più account
Se l'utente ha più account, l'agente richiede e conferma le ultime quattro cifre del numero di conto bancario e fornisce il saldo dell'account.
| Input utente | Risposta dell'agente |
|---|---|
| L'agente autentica l'utente utilizzando il componente predefinito Autenticazione. | |
| Grazie, l'autenticazione è riuscita. | |
| Attendi mentre recuperiamo i dettagli del tuo account. Abbiamo rilevato che al tuo numero sono associati due account. Puoi fornirci le ultime quattro cifre dell'account a cui fai riferimento? |
|
| 2002 | |
| Le ultime quattro cifre del numero di conto bancario che abbiamo ricevuto sono 2002, è corretto? | |
| sì | |
| Il saldo associato al numero di conto bancario che termina con 2002 è di 5000 $. |
Più account con contesto
Se l'utente ha più account, il numero di conto bancario a cui si fa riferimento viene conservato dall'intent precedente e all'utente viene fornito il saldo dell'account.
| Input utente | Risposta dell'agente |
|---|---|
| Attendi mentre recuperiamo i dettagli del tuo account. Abbiamo rilevato che al tuo numero sono associati tre account. Stai cercando il numero di conto bancario che termina con 4567? |
|
| Sì | |
| Il saldo associato al numero di conto bancario che termina con 4567 è di 50 $. |
Convenzioni di denominazione
Questo componente predefinito utilizza le seguenti convenzioni di denominazione:
| Funzionalità | Formato | Esempio |
|---|---|---|
| Flow | Nome componente | Saldo dell'account |
| Component Specific Intent | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_account_number_collection_four_digit_account_number |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_account_balance:get_account_balance |
Parametri di input
I parametri di input configurano determinati comportamenti del componente. Una o più condizioni all'interno del flusso utilizzano questi parametri per determinare il comportamento del componente. Devi impostare i parametri con ambito del flusso nella pagina iniziale del componente. Puoi impostare i parametri con ambito sessione utilizzando un flusso di chiamata o nella pagina iniziale di questo componente.
Questo componente predefinito accetta i seguenti parametri di input:
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $session.params.auth_level | (Facoltativo) Indica il livello di autenticazione del chiamante. | integer |
| $session.params.auth_level_req | Indica il livello di autenticazione necessario prima che un utente possa accedere al saldo dell'account. Questo valore è configurato nei valori preimpostati dei parametri del fulfillment di ingresso della pagina nella pagina check auth level. Per impostazione predefinita, questo valore è 1. |
integer |
| $session.params.account_auth_enabled | Indica se l'utente deve essere autenticato come proprietario dell'account, come descritto in Tipi di autenticazione. Questo valore è configurato nei valori preimpostati dei parametri del fulfillment di ingresso della pagina nella pagina check auth level. Per impostazione predefinita, questo valore è true. |
boolean |
| $session.params.card_auth_enabled | Indica se l'utente deve essere autenticato come titolare della carta, come descritto in Tipi di autenticazione. Questo valore è configurato nei valori preimpostati dei parametri del fulfillment di ingresso della pagina nella pagina check auth level. Per impostazione predefinita, questo valore è false. |
boolean |
| $session.params.phone_number | (Facoltativo) Il numero di telefono registrato del cliente utilizzato per l'autenticazione. | string |
| $session.params.account_count | (Facoltativo) Il numero di account associati all'utente autenticato. | integer |
| $session.params.last_four_digit_of_account_number | (Facoltativo) Le ultime quattro cifre del numero di conto bancario del cliente per cui deve essere fornito il saldo. Se il cliente ha un solo account, queste informazioni vengono recuperate automaticamente dopo l'autenticazione. Se il cliente ha più account, il numero di conto bancario specifico viene raccolto dal cliente. | string |
| $flow.max_retry_acc_number | Specifica il numero di nuovi tentativi consentiti durante la raccolta delle ultime quattro cifre del numero di conto bancario dell'utente. Il valore predefinito è 3. |
integer |
Per configurare i parametri di input per questo componente, espandi per visualizzare le istruzioni.
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Crea.
- Fai clic sul componente importato nella sezione Flussi.
- Fai clic sulla pagina iniziale nella sezione Pagine.
- Fai clic sulla route true nella pagina iniziale.
- Nella finestra Route (Percorso), modifica i valori di Parameter Presets (Preset dei parametri) in base alle tue esigenze.
- Fai clic su Salva.
Parametri di output
I parametri di output sono parametri di sessione che rimangono attivi dopo l'uscita dal componente. Questi parametri contengono informazioni importanti raccolte dal componente.
Questo componente predefinito fornisce i valori per i seguenti parametri di output:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| auth_level | Indica il livello di autenticazione del chiamante. | integer |
| phone_number | Il numero di telefono locale del chiamante, senza il prefisso internazionale, utilizzato per identificare l'utente. | string |
| account_count | Il numero di account associati al numero di telefono registrato. Questi account includono account personali e account per i quali l'utente dispone di una procura. | integer |
| last_four_digit_of_account_number | Se l'utente ha un solo account, vengono restituite le ultime quattro cifre del numero di conto bancario. Se un utente ha più di un account, il valore di questo parametro corrisponde alle ultime quattro cifre del numero di conto bancario selezionato dall'utente per ricevere informazioni sul saldo dell'account. | string |
| transfer_reason | Indica il motivo per cui il flusso è stato interrotto, se non è andato a buon fine. Il valore restituito è uno dei seguenti:agent: l'utente ha richiesto un agente umano in un momento della conversazione.denial_of_information: l'utente ha rifiutato di condividere le informazioni richieste dal componente.max_no_input: la conversazione ha raggiunto il numero massimo di nuovi tentativi per gli eventi senza input. Consulta gli eventi integrati di assenza di input.max_no_match: la conversazione ha raggiunto il numero massimo di nuovi tentativi per gli eventi di mancata corrispondenza. Consulta gli eventi integrati no-match.webhook_error: si è verificato un errore del webhook. Consulta l'evento integrato webhook.error. webhook_not_found: un URL webhook non era raggiungibile. Consulta l'evento integrato webhook.error.not-found. |
string |
Impostazione di base
Per configurare il componente predefinito, completa i seguenti passaggi:
- Importa il componente predefinito.
- Configura i webhook flessibili forniti con le impostazioni che descrivono i tuoi servizi esterni. Per saperne di più, consulta la sezione Configurazione del webhook.
Configurazione del webhook
Per utilizzare questo componente, devi configurare i webhook flessibili inclusi per recuperare le informazioni necessarie dai tuoi servizi esterni ed eseguire le azioni richieste dal componente.
Autenticazione
Se non hai configurato in precedenza i servizi esterni richiesti per l'autenticazione, configurali per abilitare l'autenticazione degli utenti per questo componente. Per saperne di più sulla configurazione del webhook, consulta Configurazione del webhook di autenticazione.
Convalida l'account
Il componente utilizza il webhook prebuilt_components_account_services:validate_account per verificare l'esistenza di un account in base al numero di telefono registrato dell'utente e alle ultime quattro cifre del numero di conto bancario fornito. Il webhook restituisce anche il saldo dell'account, se esiste.
Parametri di richiesta API
Il componente fornisce i seguenti parametri come input per la richiesta API:
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $session.params.phone_number | Il numero di telefono locale del chiamante, senza il prefisso internazionale, utilizzato per identificare l'utente. | string |
| $session.params.last_four_digit_of_account_number | Le ultime quattro cifre del numero di conto bancario selezionato e confermato dall'utente per ricevere informazioni sul saldo dell'account. | string |
Parametri di risposta dell'API
Il componente estrae i seguenti parametri dalla risposta dell'API:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| account_found | Indica se esiste un account con le ultime quattro cifre fornite per l'account registrato dell'utente. | boolean |
| saldo | L'importo del saldo attuale dell'account, se presente. | numero |
Per configurare il webhook Convalida account per questo componente, espandi per visualizzare le istruzioni.
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook prebuilt_components_account_services:validate_account.
- Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo appropriato nel menu a discesa.
- Esamina e aggiorna il corpo della richiesta per formare il formato di richiesta appropriato per il webhook.
- Esamina e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, poiché sono richiesti dal componente per accedere ai valori dei campi restituiti.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Completa
Il componente predefinito e i relativi webhook sono ora configurati e pronti per il test.