Il componente predefinito per l'apertura di un conto consente agli utenti nuovi ed esistenti di aprire un nuovo conto o di controllare lo stato delle richieste esistenti. Questo componente utilizza i componenti predefiniti Raccolta della data di nascita, Raccolta del nome e Raccolta del numero di telefono per raccogliere i dati utente per la registrazione di un nuovo account.
Tipi di account
Per impostazione predefinita, questo componente supporta i seguenti tipi di account:
- Depositi di risparmio
- Conti correnti, noti anche come conti di deposito
- Conti Demat
- Conti stipendio
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 i dati.
Esempi di dialoghi
Le seguenti finestre di dialogo di esempio mostrano scenari comuni gestiti da questo componente predefinito. I dialoghi di esempio mostrano il comportamento quando il componente viene chiamato tramite telefonia, il 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 una richiesta 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 del numero di telefono | |
| Ottimo, abbiamo raccolto il numero di telefono. Siamo felici che tu voglia aprire un conto con noi. |
|
| L'agente raccoglie il nome completo dell'utente utilizzando il componente predefinito Raccolta dei nomi | |
| Grazie, Mario Rossi. | |
| L'agente raccoglie il numero di telefono dell'utente utilizzando il componente predefinito Raccolta della data di nascita | |
| Ottimo, abbiamo registrato la tua data di nascita. Che tipo di conto vuoi aprire? Puoi dire risparmio, corrente, stipendio o demat. |
|
| Account attuale | |
| Per conferma: vuoi aprire un nuovo conto corrente, giusto? | |
| Sì | |
| Grazie per aver fornito le informazioni. Attendi mentre generiamo la tua applicazione. Il tuo ID applicazione è 81037. Completa la richiesta facendo clic sul link fornito al tuo numero di cellulare registrato. |
Utente esistente
L'agente identifica che l'utente è stato autenticato in precedenza e conferma il tipo di conto che l'utente vuole aprire. L'agente crea una richiesta per l'utente e invia le istruzioni al numero di telefono registrato dell'utente.
| Input utente | Risposta dell'agente |
|---|---|
| Siamo lieti che tu voglia aprire un nuovo account con noi. Che tipo di account vuoi aprire? Puoi dire risparmio, corrente, stipendio o demat. |
|
| Conto di risparmio, per favore | |
| Per conferma: vuoi aprire un nuovo conto di risparmio, giusto? | |
| Sì, esatto | |
| Grazie per aver fornito le informazioni. Attendi mentre generiamo la tua richiesta. L'ID applicazione è 21430. Completa la richiesta facendo clic sul link fornito al tuo numero di cellulare registrato. |
Applicazione esistente
L'agente identifica che l'utente ha aperto in precedenza una singola domanda e gli presenta lo stato attuale. L'utente rifiuta di aprire un'altra richiesta 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 del numero di telefono | |
| Ottimo, abbiamo finito di raccogliere il numero di telefono. La tua richiesta con ID 12234 per l'apertura di un conto di risparmio è in corso. 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 |
|---|---|---|
| Flow | [Component Name] | Apri account |
| Component Specific Intent | 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 vengono utilizzati per configurare determinati comportamenti del componente. I parametri verranno utilizzati da una o più condizioni all'interno del flusso per determinare il comportamento del componente. I parametri con ambito di flusso devono essere impostati nella pagina iniziale del componente, come descritto di seguito. I parametri con ambito sessione possono essere impostati da un flusso chiamante o nella pagina di avvio 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 tentativi consentiti per raccogliere una data di nascita valida. Il valore predefinito è 2. |
integer |
| $flow.max_retry_account_type | Specifica il numero di nuovi tentativi consentiti durante la raccolta del tipo di conto 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 la sezione per visualizzare le istruzioni.
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Build.
- Fai clic sul componente importato nella sezione Flussi.
- Fai clic sulla pagina iniziale nella sezione Pagine.
- Fai clic sul percorso 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 rimarranno 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 |
|---|---|---|
| phone_number | Il numero di telefono locale dell'utente, senza il prefisso internazionale, 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 in un momento 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 nuovi tentativi per gli eventi di assenza di 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 questo componente predefinito:
- Importa il componente predefinito.
- Configura i webhook flessibili forniti con la configurazione che descrive i tuoi servizi esterni. Consulta la sezione Configurazione dei webhook di seguito.
Configurazione del webhook
Per utilizzare questo componente, devi configurare i webhook flessibili inclusi per recuperare le informazioni necessarie dai tuoi 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 di richiesta API
I seguenti parametri vengono forniti dal componente come input per la richiesta API.
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $session.params.phone_number | Il numero di telefono locale dell'utente, senza il prefisso internazionale, 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 account personali e account per i quali l'utente dispone di una procura. Se non sono presenti account associati al numero di telefono specificato, questo valore è null. |
integer |
| user_first_name | Il nome dell'utente registrato. Se il numero di telefono non è associato a un account registrato, questo valore è null. |
string |
| user_last_name | Il cognome dell'utente registrato. Se il numero di telefono non è associato a un account registrato, questo 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, questo valore è null. |
string |
| application_count | Il numero di applicazioni associate al numero di telefono registrato. Se non sono presenti applicazioni associate al numero di telefono specificato, questo valore è null. |
integer |
| application_id | Elenco contenente l'ID applicazione di ogni applicazione 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 non sono presenti applicazioni associate al numero di telefono specificato, questo 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 non sono presenti applicazioni associate al numero di telefono specificato, questo valore è null. |
Elenco (stringa) |
| application_status | Elenco contenente lo stato di ogni applicazione 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 non sono presenti applicazioni associate al numero di telefono specificato, questo 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 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.
Genera applicazione
Il webhook prebuilt_components_open_account:generate_application viene utilizzato dal componente per generare una richiesta per un nuovo account.
Parametri di richiesta API
I seguenti parametri vengono forniti dal componente come input per la richiesta API.
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $session.params.phone_number | Il numero di telefono locale dell'utente, senza il prefisso internazionale, 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 nuova richiesta di account. | string |
Per configurare il webhook Genera 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 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
Ora l'agente e i relativi webhook dovrebbero essere configurati e pronti per essere testati.