Il componente predefinito di registrazione della 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 capire se si tratta di 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 una chiamata e fornisce il numero della richiesta all'utente.
Per un cliente esistente, il componente recupererà le informazioni dell'utente registrato e presenterà all'utente finale le opzioni disponibili per le carte in base alle sue preferenze e alle informazioni recuperate, inclusa la sua affidabilità creditizia. Una volta che il cliente ha selezionato un'opzione per la carta, il componente invia un link per completare la procedura di registrazione tramite i canali registrati, tra cui WhatsApp o SMS.
Questo componente utilizza i componenti predefiniti per la raccolta dei numeri di telefono e la raccolta dei codici postali per raccogliere e convalidare i dettagli degli utenti.
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
Il componente verifica se l'utente sta chiamando utilizzando un numero di telefono registrato e identifica che si tratta di un nuovo utente. Il componente raccoglie la categoria di carta a cui l'utente desidera registrarsi e raccoglie informazioni per identificare l'utente, inclusi codice postale e numero di telefono. Il componente organizza quindi una chiamata e fornisce all'utente il numero di richiesta.
| Input utente | Risposta dell'agente |
|---|---|
| Puoi confermare di essere già cliente della nostra banca? | |
| No | |
| Siamo lieti 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 indicare il tuo reddito mensile in USD? |
|
| 5000 dollari | |
| Quali spese o vantaggi ti interessano? Abbiamo una vasta gamma di opzioni disponibili, come viaggi, carburante e shopping. | |
| 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 codici postali | |
| Hai detto che il codice postale è 10011, giusto? | |
| Sì, esatto | |
| Bene, abbiamo raccolto il codice postale. | |
| L'agente raccoglie il numero di telefono dell'utente utilizzando il componente predefinito Raccolta numeri di telefono | |
| Ok. Il numero che hai menzionato è più 1 6502530000, giusto? | |
| Sì | |
| Bene, abbiamo raccolto il numero di telefono. Uno dei nostri rappresentanti ti richiamerà per ricevere le schede correlate in base ai tuoi criteri. Il tuo numero di richiesta è 993835. |
Cliente esistente
Il componente identifica il cliente registrato tramite il numero di telefono. Il componente richiede quindi informazioni quali la categoria e il tipo di carta per cui l'utente vuole registrarsi. Una volta confermate queste informazioni, il componente chiede al cliente di selezionare un canale su cui completare il processo di registrazione e invia il link al canale registrato del cliente.
| Input utente | Risposta dell'agente |
|---|---|
| Siamo lieti che continui a selezionare i nostri prodotti e servizi. Abbiamo un'ampia gamma di carte di credito adatte a te. Quali spese o vantaggi ti interessano? Abbiamo una vasta gamma di opzioni disponibili, come viaggi, carburante e shopping. |
|
| Voglio una carta da usare per la prossima vacanza | |
| La risposta selezionata rientra nella categoria viaggi. Se vuoi procedere, rispondi "Sì". | |
| Sì | |
| Esistono 3 tipi di carte che si adattano al tuo tipo di richiesta: carta viaggio platino, carta viaggio oro, carta viaggio classica. Vuoi ricevere informazioni su tutte le schede o su una scheda specifica? Ad esempio, se stai cercando una carta classica, specifica una carta classica. | |
| Puoi parlarmi della carta Platino? | |
| Certo, per una carta viaggi Platino la tariffa annuale è di 95 dollari. I vantaggi includono: 10.000 miglia bonus ogni anno, guadagna 2x miglia illimitate su tutti gli altri acquisti, miglia facili da guadagnare e facili da usare. Puoi trovare ulteriori informazioni sui vantaggi o sui bonus sul nostro sito web. Conferma se vuoi registrarti per la carta viaggi Platino. |
|
| Sì, facciamolo | |
| Ti invieremo un link con i passaggi della procedura di registrazione. Vuoi condividere questi dati della carta con il tuo numero di cellulare tramite SMS o WhatsApp? | |
| Invia SMS | |
| Ok, stiamo inviando il link al tuo numero di cellulare registrato. L'operazione potrebbe richiedere alcuni secondi. Puoi confermare di aver ricevuto il link rispondendo sì o no? | |
| Ho capito | |
| Bene, ora puoi aprire il link e controllare i dettagli di registrazione della scheda. Una volta completati i dati, l'emissione della nuova carta verrà avviata e inviata al tuo indirizzo attuale. |
Rifiuto di informazioni
L'utente si rifiuta di fornire le informazioni necessarie per la registrazione di una carta di credito. Il componente esce con un messaggio di errore.
| Input utente | Risposta dell'agente |
|---|---|
| Puoi confermare di essere già cliente della nostra banca? | |
| No, non lo sono | |
| Siamo lieti 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 indicare il tuo reddito mensile in USD? |
|
| Non voglio darti questa informazione | |
| 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 |
|---|---|---|
| Flusso | [Nome componente] | Registrazione carta di credito |
| Intent specifico del componente | 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 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 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 nuovi tentativi assegnati all'utente finale. Il valore predefinito è 3. |
integer |
| $flow.currency_name | Specifica la valuta prevista per la raccolta dei dettagli relativi al reddito mensile. Il valore predefinito è "USD". |
string |
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.
Visualizza 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 esistente.
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. | integer |
| credit_score | L'affidabilità creditizia registrata dell'utente. | integer |
Per configurare il webhook Ottieni dettagli dell'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_credit_card_enrollment:get_account_details.
- 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.
Ottieni numero di carte
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 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 |
|---|---|---|
| card_count | Il numero totale di carte di credito negli account di un utente registrato. | integer |
Per configurare il webhook per il conteggio delle schede 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_credit_card_enrollment:get_card_count.
- 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.
Visualizza le carte disponibili
Il webhook prebuilt_components_credit_card_enrollment:get_available_card viene utilizzato dal componente per recuperare l'elenco di carte disponibili per l'utente per una categoria specifica in base alla sua affidabilità creditizia.
Parametri delle richieste API
I seguenti parametri sono 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 selezionato per la registrazione. I valori validi sono definiti dall'entità personalizzata prebuilt_components_cc_enroll_expense_category. Per impostazione predefinita sono supportati i criteri 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 di 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 Ottieni schede disponibili 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_credit_card_enrollment:get_available_card.
- 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.
Ottieni i dettagli della carta selezionata
Il webhook prebuilt_components_credit_card_enrollment:get_selected_card viene
utilizzato dal componente per recuperare le tariffe e i vantaggi annuali per la scheda selezionata.
Parametri delle richieste API
I seguenti parametri sono forniti dal componente come input per la richiesta API.
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $flow.card_type | Il tipo di carta a cui 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 i criteri classic, gold e platinum. |
string |
| $flow.expense_category | La categoria di spesa a cui l'utente ha selezionato per la registrazione. I valori validi sono definiti dall'entità personalizzata prebuilt_components_cc_enroll_expense_category. Per impostazione predefinita sono supportati i criteri 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 Ottieni dettagli della scheda selezionati 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_credit_card_enrollment:get_selected_card.
- 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.
Invia richiesta di registrazione
Il webhook prebuilt_components_credit_card_enrollment:submit_enroll viene utilizzato dal componente per creare una richiesta di registrazione della scheda in base alle preferenze fornite dal nuovo utente e ai dettagli 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 |
| $flow.zipcode | Codice postale fornito dall'utente. | string |
| $flow.monthly_salary | Retribuzione mensile fornita dall'utente. | integer |
| $flow.currency_name | Valuta dello stipendio mensile, configurata nei parametri di input del componente. Consulta 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 della richiesta di registrazione della carta. | integer |
Per configurare il webhook per l'invio della richiesta di registrazione 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_credit_card_enrollment:submit_enroll.
- 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.
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 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 |
| $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 i criteri SMS e WhatsApp. |
string |
| $flow.selected_card_name | Elenco di carte 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 per l'invio di messaggi 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_credit_card_enrollment:send_message.
- 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.