Il componente predefinito per l'account aperto consente agli utenti nuovi ed esistenti di aprire un nuovo account o di verificare lo stato delle applicazioni esistenti. Questo componente utilizza i componenti predefiniti Raccolta di data di nascita, Raccolta di nomi e Raccolta di numeri di telefono per raccogliere informazioni sugli utenti al fine di registrare un nuovo account.
Tipi di account
Per impostazione predefinita, questo componente supporta i seguenti tipi di account:
- Conti di risparmio
- Conti correnti, noti anche come conti correnti
- Account Demat
- Conti stipendi
I tipi di account supportati possono essere aggiunti o rimossi modificando l'entità personalizzata prebuilt_components_open_account_account_type.
Limitazioni
Oltre alle limitazioni comuni dei componenti predefiniti, questo componente predefinito presenta le seguenti limitazioni:
- Questo componente non cripta alcun dato.
Finestre di dialogo di esempio
Le seguenti finestre di dialogo di esempio mostrano scenari comuni gestiti da questo componente predefinito. Le finestre di dialogo di esempio mostrano il comportamento quando il componente viene chiamato tramite telefonia, che attiva l'intent di benvenuto predefinito e la prima risposta dell'agente all'inizio della conversazione.
Nuovo utente
L'agente raccoglie il numero di telefono dell'utente e identifica che l'utente non è registrato per un account. L'agente raccoglie quindi i dettagli, tra cui il nome completo e la data di nascita dell'utente, e genera un'applicazione che viene inviata al numero di telefono fornito dall'utente.
| Input utente | Risposta dell'agente |
|---|---|
| Fornisci il numero di telefono per la convalida. | |
| L'agente raccoglie il numero di telefono dell'utente utilizzando il componente predefinito Raccolta numeri di telefono | |
| Bene, abbiamo raccolto il numero di telefono. Siamo lieti che tu voglia aprire un account con noi. |
|
| L'agente raccoglie il nome completo dell'utente utilizzando il componente predefinito Raccolta nomi | |
| Grazie, John Doe. | |
| L'agente raccoglie il numero di telefono dell'utente utilizzando il componente predefinito Raccolta per la data di nascita | |
| Ottimo, abbiamo raccolto la tua data di nascita. Che tipo di account stai cercando di aprire? Puoi dire risparmio, conto corrente, stipendio o demat. |
|
| Conto attuale | |
| Per conferma: vuoi aprire un nuovo conto corrente, giusto? | |
| Sì | |
| Grazie per aver fornito le informazioni. Attendi mentre generiamo la tua richiesta. Il tuo ID applicazione è 81037. Completa la tua richiesta facendo clic sul link fornito sul tuo numero di cellulare registrato. |
Utente esistente
L'agente identifica che l'utente è stato precedentemente autenticato e conferma il tipo di account che l'utente vuole aprire. L'agente crea un'applicazione per l'utente e invia istruzioni al numero di telefono registrato dell'utente.
| Input utente | Risposta dell'agente |
|---|---|
| Siamo lieti che tu voglia aprire un nuovo conto con noi. Che tipo di account stai cercando di aprire? Puoi dire risparmio, conto corrente, stipendio o demat. |
|
| Conto di risparmio | |
| Per conferma: vuoi aprire un nuovo conto di risparmio, giusto? | |
| Sì, esatto | |
| Grazie per aver fornito le informazioni. Attendi mentre generiamo la tua applicazione. Il tuo ID applicazione è 21430. Completa la tua richiesta facendo clic sul link fornito sul tuo numero di cellulare registrato. |
Applicazione esistente
L'agente identifica che l'utente ha aperto in precedenza una singola applicazione e presenta all'utente lo stato attuale. L'utente si rifiuta di aprire un'altra applicazione per un nuovo account.
| Input utente | Risposta dell'agente |
|---|---|
| Fornisci il numero di telefono per la convalida. | |
| L'agente raccoglie il numero di telefono dell'utente utilizzando il componente predefinito Raccolta numeri di telefono | |
| Bene, abbiamo raccolto il numero di telefono. È in corso la richiesta di apertura di un conto di risparmio con ID 12234. Vuoi aprire un altro account? |
|
| No | |
| Ok, grazie per averci chiamato. |
Convenzioni di denominazione
Questo componente predefinito utilizza le seguenti convenzioni di denominazione:
| Funzionalità | Formato | Esempio |
|---|---|---|
| Flusso | [Nome componente] | Apri account |
| Intent specifico del componente | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_open_account_account_type |
| Tipo di entità | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_open_account_account_type |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_open_account:generate_application |
Parametri di input
I parametri di input sono parametri utilizzati per configurare determinati comportamenti del componente. I parametri verranno utilizzati da una o più condizioni all'interno del flusso per determinare come dovrebbe comportarsi il componente. I parametri con ambito di flusso devono essere impostati nella pagina iniziale del componente, come descritto di seguito. I parametri basati sulle sessioni possono essere impostati da 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.phone_number | (Facoltativo) Numero di telefono registrato del cliente utilizzato per l'autenticazione. | string |
| $session.params.min_age_limit | Specifica l'età minima consentita per gli utenti che aprono un nuovo account. Il valore predefinito è 18. |
integer |
| $session.params.max_age_limit | Specifica l'età massima consentita per gli utenti che aprono un nuovo account. Il valore predefinito è 100. |
integer |
| $flow.max_dob_retry_count | Specifica il numero di nuovi tentativi consentiti quando viene raccolta una data di nascita valida. Il valore predefinito è 2. |
integer |
| $flow.max_retry_account_type | Specifica il numero di nuovi tentativi consentiti per la raccolta del tipo di account che l'utente vuole aprire. Il valore predefinito è 2. |
integer |
| $flow.max_retry_another_account | Specifica il numero di nuovi tentativi consentiti quando l'utente vuole modificare il tipo di account selezionato. Il valore predefinito è 2. |
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 su Pagina iniziale nella sezione Pagine.
- Fai clic sul percorso true nella pagina iniziale.
- Nella finestra Percorso, modifica i valori di Preset parametri in base alle esigenze.
- Fai clic su Salva.
Parametri di output
I parametri di output sono parametri di sessione che rimarranno attivi dopo l'uscita dal componente. Questi parametri contengono importanti informazioni raccolte dal componente. Questo componente predefinito fornisce valori per i seguenti parametri di output:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| phone_number | Numero di telefono locale dell'utente, senza il codice paese, utilizzato per identificare l'utente. | string |
| transfer_reason | Questo parametro indica il motivo per cui il flusso è stato chiuso, se non è andato a buon fine. Il valore restituito è uno dei seguenti:agent: l'utente finale ha richiesto un agente umano a un certo punto della conversazione.denial_of_information: l'utente finale ha rifiutato di condividere le informazioni richieste dal componente.max_no_input: la conversazione ha raggiunto il numero massimo di tentativi per eventi senza input. Vedi gli eventi integrati senza input.max_no_match: la conversazione ha raggiunto il numero massimo di nuovi tentativi per eventi senza corrispondenza. Consulta gli eventi integrati senza corrispondenza.webhook_error: si è verificato un errore webhook. Vedi evento integrato webhook.error. webhook_not_found: l'URL di un webhook non è raggiungibile. Vedi evento integrato webhook.error.not-found. |
string |
Configurazione di base
Per configurare questo componente predefinito:
- Importa il componente predefinito.
- Configura i hook flessibili forniti con la configurazione che descrive i servizi esterni Dialogflow. Consulta la sezione Configurazione webhook di seguito.
Configurazione webhook
Per utilizzare questo componente, devi configurare i webhook flessibili inclusi per recuperare le informazioni necessarie dai servizi esterni.
Verifica telefonica
Il webhook prebuilt_components_open_account:telephone_verification viene utilizzato dal componente per ottenere informazioni sugli account registrati e sulle applicazioni precedenti associate al numero di telefono dell'utente.
Parametri delle richieste API
I seguenti parametri sono forniti dal componente come input per la richiesta API.
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $session.params.phone_number | Numero di telefono locale dell'utente, senza il codice paese, utilizzato per identificare l'utente. | string |
Parametri di risposta dell'API
I seguenti parametri vengono estratti dalla risposta dell'API per essere utilizzati dal componente.
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| account_count | Il numero di account associati al numero di telefono registrato. Questi account includono gli account individuali e gli account per i quali l'utente dispone di una procura. Se non esistono account associati al numero di telefono specificato, il valore è null. |
integer |
| user_first_name | Il nome dell'utente registrato. Se il numero di telefono non è associato a un account registrato, il valore è null. |
string |
| user_last_name | Il cognome dell'utente registrato. Se il numero di telefono non è associato a un account registrato, il valore è null. |
string |
| user_dob | La data di nascita dell'utente registrato nel formato "AAAA-MM-GG". Se il numero di telefono non è associato a un account registrato, il valore è null. |
string |
| application_count | Il numero di applicazioni associate al numero di telefono registrato. Se al numero di telefono specificato non sono presenti applicazioni, il valore è null. |
integer |
| application_id | Elenco contenente lID applicazione di ogni domanda associata al numero di telefono specificato, ad esempio ["00000", "11111", "22222"]. Ogni elemento di questo elenco rappresenta la stessa applicazione dell'elemento con lo stesso indice in account_type e application_status. Se al numero di telefono specificato non sono presenti applicazioni, il valore è null. |
Elenco (stringa) |
| account_type | Elenco contenente il tipo di account di ogni applicazione associata al numero di telefono specificato, ad esempio ["savings", "checking", "demat"]. Ogni elemento di questo elenco rappresenta la stessa applicazione dell'elemento con lo stesso indice in application_id e application_status. Se al numero di telefono specificato non sono presenti applicazioni, il valore è null. |
Elenco (stringa) |
| application_status | Elenco contenente lo stato di ogni domanda associata al numero di telefono specificato, ad esempio ["in progress", "on hold", "completed"]. Ogni elemento di questo elenco rappresenta la stessa applicazione dell'elemento con lo stesso indice in application_id e account_type. Se al numero di telefono specificato non sono presenti applicazioni, il valore è null. |
Elenco (stringa) |
Per configurare il webhook di verifica telefonica 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_open_account:telephone_verification.
- Sostituisci l'URL nel campo URL webhook di Dialogflow con l'endpoint per il servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo appropriato nel menu a discesa.
- Esamina e aggiorna il Corpo della richiesta in modo che corrisponda al formato di richiesta corretto 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.
- Rivedi e aggiorna le impostazioni di Autenticazione in base alle esigenze.
- Fai clic su Salva.
Genera applicazione
Il webhook prebuilt_components_open_account:generate_application viene utilizzato dal componente per generare un'applicazione per un nuovo account.
Parametri delle richieste API
I seguenti parametri sono forniti dal componente come input per la richiesta API.
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $session.params.phone_number | Numero di telefono locale dell'utente, senza il codice paese, utilizzato per identificare l'utente. | string |
| user_first_name | Nome utente univoco. | string |
| user_last_name | Cognome dell'utente. | string |
| user_dob | Data di nascita dell'utente nel formato "AAAA-MM-GG". | string |
Parametri di risposta dell'API
I seguenti parametri vengono estratti dalla risposta dell'API per essere utilizzati dal componente.
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| application_id | ID applicazione generato per la richiesta del nuovo account. | string |
Per configurare il pulsante Genera webhook dell'applicazione 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_open_account:generate_application.
- Sostituisci l'URL nel campo URL webhook di Dialogflow con l'endpoint per il servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo appropriato nel menu a discesa.
- Esamina e aggiorna il Corpo della richiesta in modo che corrisponda al formato di richiesta corretto 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.
- Rivedi e aggiorna le impostazioni di Autenticazione in base alle esigenze.
- Fai clic su Salva.
Completa
L'agente e i relativi webhook dovrebbero essere configurati e pronti per i test.