Il componente predefinito di autenticazione per la vendita al dettaglio raccoglie informazioni per autenticare il cliente al livello di autenticazione richiesto. Questo componente predefinito copre i requisiti di autenticazione comuni, ma non esclusivi, del settore della vendita al dettaglio. Utilizza il componente predefinito Raccolta di numeri di telefono per raccogliere e convalidare i dettagli del numero di telefono del cliente.
Livelli di autenticazione
I diversi componenti predefiniti richiedono più livelli di autenticazione, con livelli più elevati che richiedono più informazioni sull'utente. Il componente di autenticazione per la vendita al dettaglio consente all'utente di autenticarsi al livello 0 (corrispondenza ANI) o al livello 1 (di base), come descritto nella tabella seguente.
| Livello di autenticazione | Requisiti |
|---|---|
| Livello 0: corrispondenza ANI | L'utente viene autenticato chiamando da un numero di telefono o fornendo un numero di telefono che corrisponde a un account registrato. Un utente può essere autenticato al Livello 0 utilizzando il componente predefinito Saluto. |
| Livello 1: Di base | L'utente viene autenticato tramite la verifica di un codice di password monouso (OTP) inviato al suo indirizzo email o numero di telefono. |
Tipi di utenti supportati
Il componente di autenticazione per la vendita al dettaglio supporta gli utenti con un numero di telefono e un indirizzo email registrati.
Limitazioni
Oltre alle limitazioni comuni dei componenti predefiniti, questo componente predefinito presenta le seguenti limitazioni:
- Le OTP vengono inviate solo a un numero di cellulare o a un indirizzo email precedentemente registrato dal cliente. Il componente non utilizzerà la OTP per autenticare i clienti che chiamano da un numero di telefono alternativo non registrato nell'account. Quando l'utente chiama da un numero di telefono alternativo, il sistema utilizza le domande di sicurezza per autenticarlo.
- Questo componente non cripta i dati.
Finestre di dialogo di esempio
Queste finestre di dialogo di esempio mostrano scenari comuni gestiti dal componente predefinito. 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.
Autenticazione di livello 0 riuscita: corrispondenza ANI
L'utente chiama da un numero di telefono registrato su un account esistente, conferma la propria identità e si autentica correttamente al Livello 0.
| Input utente | Risposta dell'agente |
|---|---|
| Ciao, il numero che hai composto è collegato all'account di Giovanni. Stai richiedendo informazioni sull'ordine di un'altra persona? Rispondi "sì" se è così, altrimenti rispondi "no". | |
| No | |
| Grazie, John. L'identificazione è stata completata. |
Autenticazione di livello 1 riuscita: OTP
- L'utente chiama da un numero di telefono non riconosciuto.
- Il componente raccoglie il numero di telefono registrato dell'utente, quindi invia e chiede all'utente di confermare una password OTP inviata al canale scelto.
- L'utente fornisce una OTP valida e si autentica correttamente al Livello 1.
| Input utente | Risposta dell'agente |
|---|---|
| Non siamo riusciti a trovare questo numero di telefono associato a noi. Ti invitiamo a fornirci il numero di telefono registrato. | |
| L'agente raccoglie il numero di telefono utilizzando il componente predefinito Raccolta del numero di telefono. | |
| Ottimo, abbiamo finito di raccogliere il numero di telefono. Per motivi di sicurezza, dobbiamo convalidare la tua identità, quindi ti invieremo un codice. Preferisci ricevere il codice via telefono o via email? |
|
| telefono | |
| Giusto per confermare, vuoi ricevere la password OTP sul tuo smartphone? Rispondi "Sì" o "No". | |
| sì | |
| Abbiamo inviato un codice al tuo numero di telefono registrato che termina con 0000. L'operazione potrebbe richiedere alcuni secondi. Puoi confermare il codice? | |
| 123457 | |
| Grazie, John. L'identificazione è stata completata. |
Convenzioni di denominazione
Questo componente predefinito utilizza le seguenti convenzioni di denominazione:
| Funzionalità | Formato | Esempio |
|---|---|---|
| Flow | [Component Name] | Autenticazione per la vendita al dettaglio |
| Intent specifico del componente | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_retail_authentication_incorrect_phone_number |
| Tipo di entità | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_channel_email_phone |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_retail_authentication:verify_user_details |
Parametri di input
I parametri di input configurano il comportamento del componente. Una o più condizioni all'interno del flusso utilizzano i parametri per determinare il comportamento del componente. L'utente deve impostare i parametri con ambito del flusso nella pagina iniziale di questo componente. Possono impostare i parametri con ambito sessione tramite 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_req | Definisce il livello di autenticazione con cui l'utente verrà autenticato. I valori validi sono 0 o 1. |
integer |
| $session.params.auth_level | (Facoltativo) Indica l'attuale livello di autenticazione dell'utente. | integer |
| $session.params.phone_number | (Facoltativo) Numero di telefono dell'utente. Se questo parametro non viene fornito, il componente raccoglierà il numero di telefono dell'utente. | string |
| $flow.max_retry_phone_number | Specifica il numero di tentativi consentiti per la raccolta del numero di telefono dell'utente. Il valore predefinito è 3. |
integer |
| $flow.max_retry_otp | Specifica il numero di tentativi consentiti per la raccolta della password monouso (OTP). Il valore predefinito è 3. |
integer |
| $flow.max_retry_otp_not_received | Specifica il numero di nuovi tentativi consentiti quando la password monouso (OTP) non viene ricevuta. Il valore predefinito è 1. |
integer |
| $flow.max_retry_otp_confirm_channel | Specifica il numero di nuovi tentativi consentiti durante la raccolta del canale per ricevere la password monouso (OTP). Il valore predefinito è 3. |
integer |
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 Build.
- 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 che l'utente esce 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 |
|---|---|---|
| auth_level | Indica il livello di autenticazione corrente dell'utente. | integer |
| all_recent_order_id | Questo parametro elenca gli ID ordine associati all'utente autenticato, ordinati in base alla data di invio dell'ordine in ordine decrescente. Il primo elemento dell'array rappresenta l'ordine più recente. Se un utente non ha ordini, il valore di questo parametro è null. |
Elenco (stringa) |
| phone_number | Il numero di telefono locale dell'utente, senza il prefisso internazionale, utilizzato per identificare l'utente. | string |
| L'indirizzo email registrato con l'account. | string | |
| user_first_name | Nome dell'utente, utilizzato per salutare e confermare la proprietà dell'account. | 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 mancato input. Consulta gli eventi integrati di assenza di input.max_no_match: la conversazione ha raggiunto il numero massimo di nuovi tentativi per gli eventi di mancata corrispondenza. Consulta gli eventi integrati no-match.webhook_error: si è verificato un errore del webhook. Consulta l'evento integrato webhook.error. webhook_not_found: un URL webhook non era raggiungibile. Consulta l'evento integrato webhook.error.not-found. |
string |
Impostazione di base
Per configurare questo componente predefinito:
- Importa il componente predefinito.
- Configura i webhook flessibili forniti con la configurazione che descrive i tuoi servizi esterni, consulta Configurazione dei webhook.
Configurazione del webhook
Per utilizzare questo componente, l'utente deve configurare i webhook flessibili inclusi per recuperare le informazioni necessarie dai propri servizi esterni.
Verifica i dettagli dell'utente
Il webhook prebuilt_components_retail_authentication:verify_user_details recupera i dettagli dell'account utente in base al numero di telefono fornito.
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 prefisso internazionale, utilizzato per identificare l'utente. | string |
Parametri di risposta dell'API
Il componente estrae i seguenti parametri dalla risposta dell'API:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| L'indirizzo email registrato con l'account. | string | |
| all_recent_order_id | Elenco degli ID ordine associati all'utente autenticato, ordinati in base alla data di invio dell'ordine in ordine decrescente. Il primo elemento dell'array rappresenta l'ordine più recente. Se un utente non ha ordini, il valore di questo parametro è null. |
Elenco (stringa) |
| user_first_name | Nome dell'utente, utilizzato per salutare e confermare la proprietà dell'account. | string |
Per configurare il webhook Verifica i dettagli dell'utente 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_retail_authentication:verify_user_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.
Invia OTP
Il componente utilizza il webhook prebuilt_components_retail_authentication:send_otp per inviare una password monouso (OTP) a un canale registrato selezionato dall'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 prefisso internazionale, utilizzato per identificare l'utente. | string |
| $flow.channel | Il canale selezionato dall'utente per ricevere la OTP. I valori validi sono definiti dall'entità personalizzata prebuilt_components_channel_email_phone. Per impostazione predefinita, sono supportati email e phone. |
string |
Parametri di risposta dell'API
Il componente estrae i seguenti parametri dalla risposta dell'API:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| generated_otp | Il valore della OTP generata e inviata all'utente tramite il canale selezionato. | string |
Per configurare il webhook Invia OTP 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_retail_authentication:send_otp.
- 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
Questo componente predefinito e i relativi webhook sono ora configurati e pronti per il test.