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 finale per identificare che si tratti di un cliente nuovo o esistente. Per un nuovo utente, il componente raccoglierà i dettagli richiesti, inclusi l'introito mensile e la categoria di spese o i vantaggi della carta richiesti dall'utente. Una volta che tutte le informazioni richieste sono state raccolto, il componente organizza una richiamata e fornisce il numero di richiesta per l'utente.
Per un cliente esistente, il componente recupererà le informazioni dell'utente registrato e presentare all'utente finale le opzioni di schede disponibili in base alle sue preferenze e recuperato informazioni, inclusa l'affidabilità creditizia. Dopo che il cliente ha selezionato un'opzione della scheda, il componente invierà un link per completare la procedura di registrazione tramite canali registrati, tra cui WhatsApp o SMS.
Questo componente utilizza la classe Raccolta numeri di telefono e la raccolta dei codici postali componenti predefiniti per raccogliere e convalidare i dettagli utente.
Limitazioni
Oltre alla sezione limitazioni comuni dei componenti predefiniti, questo componente predefinito presenta le seguenti limitazioni:
- Questo componente non cripta alcun dato.
Dialoghi 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, 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 che si tratta di un nuovo utente. Il componente raccoglie la categoria della carta per la quale l'utente vuole registrarsi e le informazioni per identificarlo, tra cui il codice postale e il numero di telefono. Il componente organizza quindi una chiamata e fornisce all'utente il numero della richiesta.
| Input utente | Risposta dell'agente |
|---|---|
| Puoi confermare se sei già cliente 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 a te. Per fornirti le migliori carte disponibili, potresti indicare il tuo reddito mensile in dollari statunitensi? |
|
| 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 codice postale | |
| Hai detto che il codice postale è 10011, giusto? | |
| Sì, è corretto | |
| Ottimo, 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 menzionato è +1 6502530000, giusto? | |
| Sì | |
| Bene, abbiamo finito di raccogliere il numero di telefono. Uno dei nostri rappresentanti ti richiamerà per chiederti le schede correlate in base ai tuoi criteri. Il numero della richiesta è 993835. |
Cliente esistente
Il componente identifica i clienti registrati tramite il numero di telefono. Il componente poi richiede informazioni come la categoria e il tipo di scheda che desidera. per la registrazione. 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.
| Input utente | Risposta dell'agente |
|---|---|
| Siamo lieti 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 una vasta gamma di opzioni disponibili, come viaggi, carburante e shopping. |
|
| Voglio una carta che possa usare per la mia prossima vacanza | |
| La risposta selezionata rientra nella categoria dei viaggi. Se vuoi procedere, rispondi sì. | |
| Sì | |
| Esistono 3 tipi di carte in base al tipo di richiesta: carta viaggio platino, carta viaggio oro, carta viaggio classica. Vuoi conoscere le informazioni su tutte le schede o su una specifica? Ad esempio, se cerchi specificamente una carta classica, di' una carta classica. | |
| Puoi parlarmi della carta di platino? | |
| Certo, per un biglietto di viaggio Platino la tariffa annuale è di 95 dollari. I vantaggi includono: 10.000 miglia bonus all'anno, miglia illimitate 2x su tutti gli altri acquisti, miglia facili da guadagnare e da usare. Puoi trovare ulteriori informazioni sui vantaggi o sui bonus sul nostro sito web. Conferma se vuoi registrarti per la carta di viaggio Platinum. |
|
| Sì, facciamo così | |
| Condivideremo 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? | |
| Invia un 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 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, l'emissione della nuova carta verrà avviata e inviata al tuo indirizzo attuale. |
Negazione di informazioni
L'utente rifiuta di fornire le informazioni necessarie per registrarsi per una carta di credito. La viene chiuso con un messaggio di errore.
| Input utente | Risposta dell'agente |
|---|---|
| Puoi confermare se sei già cliente della nostra banca? | |
| No | |
| Siamo lieti di aver richiesto una carta di credito. Abbiamo un'ampia gamma di carte di credito adatte a te. Per fornirti le migliori carte disponibili, potresti indicare il tuo reddito mensile in dollari statunitensi? |
|
| Non voglio darti queste informazioni | |
| Grazie per aver chiamato. 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 | [Component Name] | Registrazione carta di credito |
| Intent specifico per 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 utilizzati per configurare determinati comportamenti del componente. I parametri verranno utilizzati da una o più condizioni all'interno di per determinare il comportamento del componente. I parametri basati sul flusso devono essere impostati nella pagina iniziale del componente come descritto di seguito. Con ambito sessione possono essere impostati da un flusso di chiamata o all'inizio pagina 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 concessi all'utente finale. Il valore predefinito è 3. |
integer |
| $flow.currency_name | Specifica la valuta prevista per la raccolta dei dettagli degli utili mensili. Il valore predefinito è "USD". |
string |
Per configurare i parametri di input per questo componente, espandi per visualizzare le istruzioni.
- Apri la console di Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona il tuo agente.
- Seleziona la scheda Crea.
- Fai clic sul componente importato nella sezione Flussi.
- Fai clic sulla home page nella sezione Pagine.
- Fai clic su true nella pagina iniziale.
- Nella finestra Percorso, modifica i valori di Preimpostazioni dei 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 del 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 identificarlo. | 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 determinato momento durante la 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 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 di mancata corrispondenza. Vedi gli eventi integrati senza corrispondenza.webhook_error: si è verificato un errore relativo al webhook. Consulta l'evento integrato webhook.error. webhook_not_found: l'URL webhook non è 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 webhook
Per utilizzare questo componente, dovrai configurare i webhook flessibili inclusi per recuperare le informazioni necessarie dai tuoi servizi esterni.
Ottieni 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 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 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 l'webhook Get account details per questo componente, espandi la sezione per visualizzare le istruzioni.
- Apri la console di Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona l'webhook prebuilt_components_credit_card_enrollment:get_account_details.
- Sostituisci l'URL nel campo URL webhook degli agenti conversazionali (Dialogflow CX) con l'endpoint del servizio. con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto dal menu a discesa.
- Esamina e aggiorna il corpo della richiesta per creare il formato di richiesta corretto per l'webhook.
- Rivedi e aggiorna la configurazione della risposta per estrarre campi specifici dal tuo webhook la risposta corretta. 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 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 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 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 l'webhook Get card count 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 Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook prebuilt_components_credit_card_enroll:get_card_count.
- Sostituisci l'URL nel campo URL webhook degli agenti conversazionali (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 creare il formato di richiesta corretto per l'webhook.
- Rivedi e aggiorna la configurazione della risposta per estrarre campi specifici dal tuo webhook la risposta corretta. 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.
Ricevi le carte disponibili
Il webhook prebuilt_components_credit_card_enrollment:get_available_card è
utilizzata dal componente per recuperare l'elenco di schede a disposizione dell'utente per
una categoria specifica in base all'affidabilità creditizia 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 |
|---|---|---|
| $flow.expense_category | La categoria di spesa per la quale l'utente ha selezionato 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 Ottieni i dettagli dell'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 schede a disposizione dell'utente, ad esempio ["gold shopping card","classic shopping card"]. |
Elenco (stringa) |
| cards_count | Il numero di schede disponibili per l'utente. | integer |
Per configurare l'webhook Get available cards per questo componente, espandi la sezione per visualizzare le istruzioni.
- Apri la console di 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_enroll:get_available_card.
- Sostituisci l'URL nel campo URL webhook degli agenti conversazionali (Dialogflow CX) con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto dal menu a discesa.
- Esamina e aggiorna il corpo della richiesta per creare il formato di richiesta corretto per l'webhook.
- Rivedi e aggiorna la configurazione della risposta per estrarre campi specifici dal tuo webhook la risposta corretta. 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.
Visualizzare i dettagli della carta selezionata
Il webhook prebuilt_components_credit_card_enrollment:get_selected_card viene utilizzato dal componente per recuperare le commissioni annuali e i vantaggi della carta selezionata.
Parametri di 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 per la quale l'utente ha selezionato 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 | Il punteggio di credito dell'utente, recuperato dal componente utilizzando l'webhook Get account details. | 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 scheda selezionata. | string |
| selected_card_annual_fee | La tariffa annuale della carta selezionata. | integer |
| selected_card_name | Il nome della scheda selezionata. | string |
Per configurare l'webhook Get selected card details 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 Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook prebuilt_components_credit_card_enroll:get_selected_card.
- Sostituisci l'URL nel campo URL webhook degli agenti conversazionali (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 creare il formato di richiesta corretto per l'webhook.
- Rivedi e aggiorna la configurazione della risposta per estrarre campi specifici dal tuo webhook la risposta corretta. 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.
Inviare la 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 forniti dal nuovo 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 codice paese, utilizzato per identificare l'utente. | string |
| $flow.zipcode | 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 corretta della richiesta di registrazione della carta. | integer |
Per configurare l'webhook Invia richiesta di registrazione 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 Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook prebuilt_components_credit_card_enroll:submit_enroll.
- Sostituisci l'URL nel campo URL webhook degli agenti conversazionali (Dialogflow CX) con l'endpoint del servizio. con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto dal menu a discesa.
- Esamina e aggiorna il corpo della richiesta per creare il formato di richiesta corretto per l'webhook.
- Rivedi e aggiorna la configurazione della risposta per estrarre campi specifici dal tuo webhook la risposta corretta. 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 webhook prebuilt_components_credit_card_enrollment:send_message è in uso
dal componente per inviare un messaggio contenente un link per completare la carta
per i clienti esistenti.
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 codice paese, utilizzato per identificare l'utente. | string |
| $flow.channel | Il canale su cui l'utente ha selezionato 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.
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona l'webhook prebuilt_components_credit_card_enrollment:send_message.
- Sostituisci l'URL nel campo URL webhook degli agenti conversazionali (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 creare il formato di richiesta corretto per l'webhook.
- Rivedi e aggiorna la configurazione della risposta per estrarre campi specifici dal tuo webhook la risposta corretta. 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
L'agente e i relativi webhook dovrebbero essere configurati e pronti per il test.