Componente predefinito per la registrazione della carta di credito

Il componente predefinito Registrazione carta di credito consente ai clienti nuovi ed esistenti di richiedere una nuova carta di credito.

Il componente inizia raccogliendo il numero di telefono dell'utente finale per identificare se è un cliente nuovo o esistente. Per un nuovo utente, il componente raccoglierà i dettagli richiesti, tra cui il reddito mensile e la categoria di spese o i vantaggi della carta richiesti dall'utente. Una volta raccolte tutte le informazioni richieste, il componente organizza un richiamo e fornisce all'utente il numero della richiesta.

Per un cliente esistente, il componente recupererà le informazioni dell'utente registrato e presenterà le opzioni di carta disponibili all'utente finale in base alle sue preferenze e alle informazioni recuperate, incluso il suo punteggio di credito. Una volta che il cliente ha selezionato un'opzione per la carta, il componente invierà un link per completare la procedura di registrazione tramite i canali registrati, inclusi WhatsApp o SMS.

Questo componente utilizza i componenti predefiniti Raccolta del numero di telefono e Raccolta del codice postale per raccogliere e convalidare i dettagli dell'utente.

Limitazioni

Oltre alle limitazioni comuni dei componenti predefiniti, questo componente predefinito presenta le seguenti limitazioni:

• Questo componente non cripta alcun dato.

Esempi di dialoghi

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, il che attiva l'intent di benvenuto predefinito e la prima risposta dell'agente all'inizio della conversazione.

Nuovo utente

Il componente verifica se l'utente sta chiamando utilizzando un numero di telefono registrato e lo identifica come nuovo utente. Il componente raccoglie la categoria di carta per cui l'utente vuole registrarsi e raccoglie informazioni per identificare l'utente, inclusi codice postale e numero di telefono. Il componente quindi organizza un richiamo e fornisce all'utente il numero della richiesta.

Input utente	Risposta dell'agente
	Puoi confermare se sei già cliente della nostra banca?
Non lo sono
	Siamo felici che tu voglia richiedere una carta di credito con noi. Abbiamo un'ampia gamma di carte di credito adatte a te. Per fornirti le migliori carte disponibili, potresti indicarci il tuo reddito mensile in dollari statunitensi?
5000 dollari
	Quali spese o vantaggi ti interessano? Abbiamo a disposizione una serie di opzioni, come viaggi, carburante e acquisti.
Mi piace fare shopping
	La risposta selezionata rientra nella categoria Shopping. Se vuoi procedere, rispondi sì.
Sì
	L'agente raccoglie il codice postale dell'utente utilizzando il componente predefinito Raccolta codice postale
	Hai indicato che il codice postale è 10011, è corretto?
Sì, è corretto
	Ottimo, abbiamo finito di raccogliere il codice postale.
	L'agente raccoglie il numero di telefono dell'utente utilizzando il componente predefinito Raccolta del numero di telefono
	Ok. Il numero che hai menzionato è [phone], è corretto?
Sì
	Ottimo, abbiamo finito di raccogliere il numero di telefono. Uno dei nostri rappresentanti ti richiamerà per le carte correlate in base ai tuoi criteri. Il numero della tua richiesta è 993835.

Cliente esistente

Il componente identifica il cliente registrato utilizzando il suo numero di telefono. Il componente richiede quindi informazioni come la categoria e il tipo di carta che l'utente vorrebbe registrare. Una volta confermate queste informazioni, il componente chiede al cliente di selezionare un canale su cui completare la procedura di registrazione e invia il link al canale registrato del cliente.

Input utente	Risposta dell'agente
	Siamo felici che tu continui a scegliere i nostri prodotti e servizi. Abbiamo una vasta gamma di carte di credito adatte a te. Quali spese o vantaggi ti interessano? Abbiamo a disposizione una serie di opzioni, come viaggi, carburante e acquisti.
Voglio una carta che posso usare quando andrò in vacanza
	La risposta selezionata rientra nella categoria viaggi. Se vuoi procedere, rispondi sì.
Sì
	Esistono tre tipi di carte adatte al tuo tipo di richiesta: carta di viaggio Platinum, carta di viaggio Gold e carta di viaggio Classic. Vuoi informazioni su tutte le carte o su una specifica? Ad esempio, se stai cercando una carta classica, specifica "carta classica".
Puoi parlarmi della carta Platinum?
	Certo, per una carta di credito per viaggi platinum la commissione annuale è di 95 dollari. I vantaggi includono: 10.000 miglia bonus ogni anno, 2 miglia per ogni acquisto, miglia facili da guadagnare e da utilizzare. Puoi trovare maggiori informazioni su vantaggi o bonus sul nostro sito web. Conferma se vuoi richiedere la carta di viaggio Platinum.
Sì, facciamolo.
	Ti invieremo un link con i passaggi della procedura di registrazione. Vuoi che condividiamo i dati della carta con il tuo numero di cellulare tramite SMS o WhatsApp?
SMS, per favore
	Ok, stiamo inviando il link al tuo numero di cellulare registrato. Questa azione potrebbe richiedere alcuni secondi. Puoi confermare se hai ricevuto il link rispondendo sì o no?
Ho capito
	Ottimo, ora puoi aprire il link e controllare i dettagli di registrazione della carta. Una volta completati i dati, verrà avviata l'emissione della nuova carta, che verrà inviata al tuo indirizzo attuale.

Negazione di informazioni

L'utente si rifiuta di fornire le informazioni necessarie per richiedere una carta di credito. Il componente esce con un messaggio di errore.

Input utente	Risposta dell'agente
	Puoi confermare se sei già cliente della nostra banca?
No, non lo sono
	Siamo felici che tu voglia richiedere una carta di credito con noi. Abbiamo un'ampia gamma di carte di credito adatte a te. Per fornirti le migliori carte disponibili, potresti indicarci il tuo reddito mensile in dollari statunitensi?
Non voglio comunicarti queste informazioni
	Grazie per aver chiamato. Siamo spiacenti, ma al momento non possiamo procedere senza le informazioni richieste.

Convenzioni di denominazione

Questo componente predefinito utilizza le seguenti convenzioni di denominazione:

Funzionalità	Formato	Esempio
Flow	[Component Name]	Registrazione della carta di credito
Component Specific Intent	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_cc_enroll_collect_cardtype
Tipo di entità	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_cc_enroll_expense_category
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_credit_card_enrollment:get_available_card

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 il comportamento del componente. I parametri con ambito flusso devono essere impostati nella pagina iniziale del componente come descritto di seguito. I parametri con ambito sessione 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 l'attuale livello di autenticazione dell'utente finale.	integer
$session.params.phone_number	(facoltativo) Numero di telefono dell'utente finale. Se questo parametro non viene fornito, il componente raccoglierà il numero di telefono dall'utente finale.	string
$flow.max_retry_count	Specifica il numero di tentativi concessi all'utente finale. Il valore predefinito è 3.	integer
$flow.currency_name	Specifica la valuta prevista per la raccolta dei dettagli sul reddito mensile. Il valore predefinito è "USD".	string

Per configurare i parametri di input per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Crea.
5. Fai clic sul componente importato nella sezione Flussi.
6. Fai clic su Pagina iniziale nella sezione Pagine.
7. Fai clic sulla route true nella pagina iniziale.
8. Nella finestra Route, modifica i valori di Preset parametri in base alle tue esigenze.
9. 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 valori per i seguenti parametri di output:

Nome parametro	Descrizione	Formato di output
phone_number	Il 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 interrotto, se non è andato a buon fine. Il valore restituito è uno dei seguenti: agent: l'utente finale ha richiesto un operatore umano a un certo punto della conversazione. denial_of_information: l'utente finale si è rifiutato di condividere le informazioni richieste dal componente. max_no_input: la conversazione ha raggiunto il numero massimo di tentativi per gli eventi senza input. Consulta gli eventi integrati senza input. max_no_match: la conversazione ha raggiunto il numero massimo di tentativi per gli eventi senza corrispondenza. Consulta eventi integrati senza corrispondenza. webhook_error: si è verificato un errore webhook. Vedi webhook.error evento integrato. webhook_not_found: un URL webhook non era raggiungibile. Vedi webhook.error.not-found evento integrato.	string

Impostazione di base

Per configurare questo componente predefinito:

1. Importa il componente predefinito.
2. Configura i webhook flessibili forniti con la configurazione che descrive i tuoi servizi esterni. Per informazioni sulla configurazione dei webhook, vedi la sezione Configurazione dei webhook di seguito.

Configurazione webhook

Per utilizzare questo componente, devi configurare i webhook flessibili inclusi per recuperare le informazioni necessarie dai tuoi servizi esterni.

Recuperare i dettagli dell'account

Il webhook prebuilt_components_credit_card_enrollment:get_account_details viene utilizzato dal componente per recuperare i dettagli dell'account dell'utente, se esiste un account.

Parametri della 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 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.	integer
credit_score	Il punteggio di credito registrato dell'utente.	integer

Per configurare il webhook Ottieni dettagli account per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_credit_card_enrollment:get_account_details.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Get card count

Il webhook prebuilt_components_credit_card_enrollment:get_card_count viene utilizzato dal componente per recuperare il numero di carte di credito associate agli account di un utente registrato.

Parametri della 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 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
card_count	Il numero totale di carte di credito negli account di un utente registrato.	integer

Per configurare il webhook Get card count per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_credit_card_enrollment:get_card_count.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Visualizzare le carte disponibili

Il webhook prebuilt_components_credit_card_enrollment:get_available_card viene utilizzato dal componente per recuperare l'elenco delle carte disponibili per l'utente per una categoria specifica in base al punteggio di credito dell'utente.

Parametri della richiesta API

I seguenti parametri vengono forniti dal componente come input per la richiesta API.

Nome parametro	Descrizione	Formato di input
$flow.expense_category	La categoria di spesa a cui l'utente ha scelto di registrarsi. I valori validi sono definiti dall'entità personalizzata prebuilt_components_cc_enroll_expense_category. Per impostazione predefinita, sono supportati fuel, shopping e travel.	string
$flow.credit_score	L'affidabilità creditizia dell'utente, recuperata dal componente utilizzando il webhook Ottieni dettagli account.	integer

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
available_card_names	Elenco delle carte disponibili per l'utente, ad esempio ["gold shopping card","classic shopping card"].	Elenco (stringa)
cards_count	Il numero di carte disponibili per l'utente.	integer

Per configurare il webhook Get available cards per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_credit_card_enrollment:get_available_card.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Visualizzare i dettagli della carta selezionata

Il webhook prebuilt_components_credit_card_enrollment:get_selected_card viene utilizzato dal componente per recuperare le commissioni e i vantaggi annuali della carta selezionata.

Parametri della richiesta API

I seguenti parametri vengono forniti dal componente come input per la richiesta API.

Nome parametro	Descrizione	Formato di input
$flow.card_type	Il tipo di carta che l'utente ha selezionato per la registrazione. I valori validi sono definiti dall'entità personalizzata prebuilt_components_cc_enroll_card_type. Per impostazione predefinita, sono supportati classic, gold e platinum.	string
$flow.expense_category	La categoria di spesa a cui l'utente ha scelto di registrarsi. I valori validi sono definiti dall'entità personalizzata prebuilt_components_cc_enroll_expense_category. Per impostazione predefinita, sono supportati fuel, shopping e travel.	string
$flow.credit_score	L'affidabilità creditizia dell'utente, recuperata dal componente utilizzando il webhook Ottieni dettagli account.	integer

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
selected_card_benefits	Informazioni sui vantaggi della carta selezionata.	string
selected_card_annual_fee	La commissione annuale della carta selezionata.	integer
selected_card_name	Il nome della carta selezionata.	string

Per configurare il webhook Recupera dettagli carta selezionata per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_credit_card_enrollment:get_selected_card.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Invia richiesta di registrazione

Il webhook prebuilt_components_credit_card_enrollment:submit_enroll viene utilizzato dal componente per creare una richiesta di registrazione della carta in base alle preferenze e ai dettagli dell'utente forniti.

Parametri della 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 codice paese, utilizzato per identificare l'utente.	string
$flow.zipcode	Il codice postale fornito dall'utente.	string
$flow.monthly_salary	Lo stipendio mensile fornito dall'utente.	integer
$flow.currency_name	Valuta dello stipendio mensile, configurata nei parametri di input del componente. Vedi i parametri di input.	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
request_number	Numero di richiesta per la registrazione riuscita della richiesta di registrazione della carta.	integer

Per configurare il webhook Invia richiesta di registrazione per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_credit_card_enrollment:submit_enroll.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Invia messaggio

Il webhook prebuilt_components_credit_card_enrollment:send_message viene utilizzato dal componente per inviare un messaggio contenente un link per completare la registrazione della carta di credito per i clienti esistenti.

Parametri della 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 codice paese, utilizzato per identificare l'utente.	string
$flow.channel	Il canale su cui l'utente ha scelto di ricevere il messaggio. I valori validi sono definiti dall'entità personalizzata prebuilt_components_cc_enroll_channel. Per impostazione predefinita, sono supportati SMS e WhatsApp.	string
$flow.selected_card_name	Elenco delle schede selezionate dall'utente, ad esempio ["gold shopping card","classic shopping card"].	Elenco (stringa)

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
message_sent	Indica se il messaggio è stato inviato correttamente al canale specificato dall'utente.	boolean

Per configurare il webhook Invia messaggio per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_credit_card_enrollment:send_message.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Completa

L'agente e i relativi webhook dovrebbero ora essere configurati e pronti per il test.