Il componente predefinito per la 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 per identificare se si tratta di un cliente nuovo o esistente. Per un nuovo utente, il componente raccoglie i dettagli richiesti, tra cui il reddito mensile e la categoria di spese o i vantaggi della carta di credito che desidera. Dopo aver raccolto tutte le informazioni richieste, il componente organizza un callback e fornisce il numero della richiesta all'utente.
Per un cliente esistente, il componente recupera le informazioni dell'utente registrato e presenta le opzioni di carta di credito disponibili all'utente in base alle sue preferenze e alle informazioni recuperate, inclusa l'affidabilità creditizia. Dopo che il cliente ha selezionato un'opzione di carta di credito, il componente invia un link per completare la procedura di registrazione utilizzando i canali registrati, tra cui WhatsApp o SMS.
Questo componente utilizza i componenti Raccolta di numeri di telefono e Raccolta di codici postali per raccogliere e convalidare i dettagli dell'utente.
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.
Nuovo utente
- Il componente controlla se l'utente sta chiamando utilizzando un numero di telefono registrato per identificare se si tratta di un nuovo utente.
- Il componente raccoglie la categoria di carta di credito per cui l'utente vuole registrarsi e raccoglie informazioni per identificare l'utente, tra cui il codice postale e il numero di telefono.
- Il componente organizza una richiamata e fornisce il numero della richiesta.
| Input utente | Risposta dell'agente |
|---|---|
| Puoi confermare se sei un cliente esistente 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 alle tue esigenze. Per fornirti le migliori carte di credito disponibili, potresti indicare il tuo reddito mensile in USD? |
|
| 5000 $ | |
| Quali spese o benefit ti interessano? Abbiamo una gamma di opzioni disponibili, come viaggi, carburante e acquisti. | |
| Mi piace fare acquisti | |
| La risposta selezionata rientra nella categoria Shopping. Se vuoi procedere, di' sì. | |
| Sì | |
| L'agente raccoglie il codice postale dell'utente utilizzando il componente predefinito Raccolta del codice postale. | |
| Hai detto che il codice postale è 10011, è corretto? | |
| Sì, esatto | |
| Bene, abbiamo finito di raccogliere il codice postale. | |
| L'agente raccoglie il numero di telefono dell'utente utilizzando il componente predefinito Raccolta di numeri di telefono. | |
| Ok. Il numero che hai indicato è +16502530000, è corretto? | |
| Sì | |
| Ottimo, abbiamo raccolto 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 un cliente registrato utilizzando il suo numero di telefono e poi richiede informazioni come la categoria e il tipo di carta per cui l'utente vuole registrarsi.
- Una volta che l'utente conferma queste informazioni, il componente gli chiede di selezionare un canale per completare la procedura di registrazione e invia il link al canale registrato.
| Input utente | Risposta dell'agente |
|---|---|
| Siamo felici che tu continui a scegliere i nostri prodotti e servizi. Abbiamo un'ampia gamma di carte di credito adatte alle tue esigenze. Quali spese o vantaggi ti interessano? Abbiamo una gamma di opzioni disponibili, come viaggi, carburante e acquisti. |
|
| Voglio una carta che posso usare quando vado in vacanza | |
| La risposta selezionata rientra nella categoria Viaggi. Se vuoi procedere, di' sì. | |
| Sì | |
| Esistono tre tipi di carte per soddisfare le tue esigenze: 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, di' "carta classica". | |
| Puoi parlarmi della carta Platinum? | |
| Certo, per una carta di viaggio Platinum la commissione annuale è di 95 $. I vantaggi includono: 10.000 miglia bonus ogni anno, miglia doppie illimitate su tutti gli altri acquisti, miglia facili da guadagnare e da utilizzare. Puoi trovare ulteriori informazioni su vantaggi o bonus sul nostro sito web. Conferma se vuoi registrarti per la carta di viaggio Platinum. |
|
| Sì, facciamolo | |
| Condivideremo un link con i passaggi della procedura di registrazione. Vuoi che condividiamo questi 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 di aver ricevuto il link dicendo "Sì" o "No"? | |
| Ho capito | |
| Ottimo, ora puoi aprire il link e controllare i dettagli della 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
Quando l'utente rifiuta di fornire le informazioni richieste per la registrazione di una carta di credito, il componente esce con un messaggio di errore.
| Input utente | Risposta dell'agente |
|---|---|
| Puoi confermare se sei un cliente esistente della nostra banca? | |
| No | |
| Siamo felici che tu voglia richiedere una carta di credito con noi. Abbiamo un'ampia gamma di carte di credito adatte alle tue esigenze. Per fornirti le migliori carte di credito disponibili, potresti indicare il tuo reddito mensile in USD? |
|
| Non voglio darti 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 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 l'attuale livello di autenticazione dell'utente. | integer |
| $session.params.phone_number | (Facoltativo) Il numero di telefono dell'utente. Se questo parametro non viene fornito, il componente raccoglie il numero di telefono dell'utente. | string |
| $flow.max_retry_count | Specifica il numero di tentativi concessi all'utente. 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.
- 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 |
|---|---|---|
| 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 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 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 (consulta Importa il componente predefinito).
- Configura i webhook flessibili forniti per descrivere i tuoi servizi esterni. Per saperne di più, consulta la sezione Configurazione del webhook.
Configurazione del webhook
Per utilizzare questo componente, configura i webhook flessibili inclusi per recuperare le informazioni necessarie dai tuoi servizi esterni.
Recupera i dettagli dell'account
Il componente utilizza il webhook prebuilt_components_credit_card_enrollment:get_account_details per recuperare i dettagli dell'account dell'utente, se esiste un account.
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 dell'utente, senza il codice paese, utilizzato per identificare l'utente. | string |
Parametri di risposta dell'API
Il componente recupera i seguenti parametri dalla risposta dell'API:
| 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 Recupera i 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 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.
Ottieni il numero di carte
Il componente utilizza il webhook prebuilt_components_credit_card_enrollment:get_card_count per recuperare il numero di carte di credito associate all'account utente registrato.
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 dell'utente, senza il codice paese, utilizzato per identificare l'utente. | string |
Parametri di risposta dell'API
Il componente recupera i seguenti parametri dalla risposta dell'API:
| 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 Recupera il numero di carte di credito 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 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.
Recupera le carte di credito disponibili
Il componente utilizza il webhook prebuilt_components_credit_card_enrollment:get_available_card per recuperare l'elenco delle carte di credito disponibili per l'utente per una categoria di spesa specifica in base alla sua affidabilità creditizia.
Parametri di richiesta API
Il componente fornisce i seguenti parametri come input per la richiesta API:
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $flow.expense_category | La categoria di spesa che 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 fuel, shopping e travel. |
string |
| $flow.credit_score | L'affidabilità creditizia dell'utente, recuperata dal componente utilizzando il webhook Recupera i dettagli dell'account. | integer |
Parametri di risposta dell'API
Il componente recupera i seguenti parametri dalla risposta dell'API:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| available_card_names | Un elenco di carte di credito disponibili per l'utente, ad esempio ["gold shopping card","classic shopping card"]. |
Elenco (stringa) |
| cards_count | Il numero di carte di credito disponibili per l'utente. | integer |
Per configurare il webhook Recupera carte 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 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.
Recupera i dettagli della carta di credito selezionata
Il componente utilizza il webhook prebuilt_components_credit_card_enrollment:get_selected_card per recuperare le commissioni annuali e i vantaggi della carta di credito selezionata.
Parametri di richiesta API
Il componente fornisce i seguenti parametri come input per la richiesta API:
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $flow.card_type | Il tipo di carta di credito 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 che 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 fuel, shopping e travel. |
string |
| $flow.credit_score | L'affidabilità creditizia dell'utente, recuperata dal componente utilizzando il webhook Recupera i dettagli dell'account. | integer |
Parametri di risposta dell'API
Il componente recupera i seguenti parametri dalla risposta dell'API:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| selected_card_benefits | Informazioni sui vantaggi della carta di credito selezionata. | string |
| selected_card_annual_fee | La quota annuale della carta di credito selezionata. | integer |
| selected_card_name | Il nome della carta di credito selezionata. | string |
Per configurare il webhook Recupera i dettagli della carta di credito selezionata 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 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.
Invia richiesta di registrazione
Il componente utilizza il webhook prebuilt_components_credit_card_enrollment:submit_enroll per creare una richiesta di registrazione della carta di credito in base alle preferenze e ai dettagli utente forniti dal nuovo utente.
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 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. Consulta i parametri di input. | string |
Parametri di risposta dell'API
Il componente recupera i seguenti parametri dalla risposta dell'API:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| request_number | Il numero della richiesta di registrazione della carta di credito andata a buon fine. | integer |
Per configurare il webhook Invia 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 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.
Invia messaggio
Il componente utilizza il webhook prebuilt_components_credit_card_enrollment:send_message per inviare un messaggio contenente un link per completare la registrazione della carta di credito per i clienti esistenti.
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 dell'utente, senza il codice paese, utilizzato per identificare l'utente. | string |
| $flow.channel | Il canale selezionato dall'utente per 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 | Un elenco di carte di credito selezionate dall'utente, ad esempio ["gold shopping card","classic shopping card"]. |
Elenco (stringa) |
Parametri di risposta dell'API
Il componente recupera i seguenti parametri dalla risposta dell'API:
| 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.
- 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 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 per la registrazione della carta di credito e i relativi webhook sono ora configurati e pronti per il test.