Il componente predefinito di autenticazione per la vendita al dettaglio raccoglie le informazioni dell'utente per autenticarlo al livello di autenticazione richiesto. Questo componente copre i requisiti di autenticazione comuni, ma non esclusivi per il settore retail. Questo componente utilizza la classe Raccolta numeri di telefono componente predefinito per raccogliere e convalidare i dettagli utente.
Livelli di autenticazione
Ci sono più livelli di autenticazione richiesti da diverse soluzioni predefinite componenti, con livelli più elevati che richiedono più informazioni dall'utente per l'autenticazione per l'utente. Il componente di autenticazione per la vendita al dettaglio consente agli utenti di autenticarsi al livello 0 (corrispondenza ANI) o al livello 1 (di base) come descritto nella tabella del livello di autenticazione.
| Livello di autenticazione | Requisiti |
|---|---|
| Livello 0: corrispondenza ANI | L'utente viene autenticato chiamando da o fornendo un numero di telefono corrispondente a un account registrato. Un utente può essere autenticato al livello 0 utilizzando il componente predefinito di saluto. |
| Livello 1: di base | L'utente viene autenticato verificando un codice OTP (password monouso) inviato al suo indirizzo email o numero di telefono. |
Tipi di utenti supportati
Il componente di autenticazione per la vendita al dettaglio fornisce assistenza agli utenti con un numero di telefono e un indirizzo email registrati.
Limitazioni
Oltre alla sezione limitazioni comuni dei componenti predefiniti, questo componente predefinito presenta le seguenti limitazioni:
- Le OTP verranno inviate solo a un numero di cellulare o a un indirizzo email precedentemente registrato per l'utente. Il componente non utilizzerà la OTP per autenticare i clienti chiamare da un numero di telefono alternativo non registrato con il relativo account. Quando un utente chiama da un numero di telefono alternativo, le domande di sicurezza vengono usato per autenticare il chiamante.
- 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 la telefonia, il che attiva l'intenzione di benvenuto predefinita e la prima risposta dell'agente all'inizio della conversazione.
Autenticazione livello 0 riuscita: corrispondenza ANI
L'utente chiama da un numero di telefono registrato in un account esistente, conferma la sua l'account di servizio e viene autenticato al Livello 0.
| Input utente | Risposta dell'agente |
|---|---|
| Ciao. Il numero che hai chiamato è collegato all\'account di Giovanni. Stai chiedendo informazioni sull'ordine di un'altra persona? Di' sì se è così, altrimenti di' no. | |
| No | |
| Grazie John. La tua identità è stata identificata. |
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 OTP inviata al canale scelto dall'utente. L'utente è in grado di fornire un'OTP valida e si è autenticato correttamente al livello 1.
| Input utente | Risposta dell'agente |
|---|---|
| Non siamo riusciti a trovare questo numero di telefono associato a noi. Fornisci il numero di telefono registrato. | |
| L'agente raccoglie il numero di telefono utilizzando il componente predefinito Raccolta di numeri 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 per telefono o per email? |
|
| telefono | |
| Giusto per confermare, vuoi ricevere l\'OTP sul telefono? Di' 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. La tua identità è stata identificata. |
Convenzioni di denominazione
Questo componente predefinito utilizza le seguenti convenzioni di denominazione:
| Funzionalità | Formato | Esempio |
|---|---|---|
| Flusso | [Component Name] | Autenticazione retail |
| Intent specifico per 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 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 con ambito a livello di flusso devono essere impostata 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_req | Definisce il livello di autenticazione a cui verrà autenticato l'utente finale. I valori validi sono 0 o 1. |
integer |
| $session.params.auth_level | (Facoltativo) Indica il livello di autenticazione corrente 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_phone_number | Specifica il numero di nuovi tentativi consentiti durante 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 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 la sezione per visualizzare le istruzioni.
- Apri la console 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 pagina iniziale nella sezione Pagine.
- Fai clic sulla route 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 dal componente. Questi parametri contengono importanti informazioni raccolte di strumento di authoring. Questo componente predefinito fornisce valori per i seguenti parametri di output:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| auth_level | Indica il livello di autenticazione corrente dell'utente finale. | integer |
| all_recent_order_id | Questo parametro elenca gli ID ordine associati all'utente autenticato, ordinati in ordine decrescente in base alla data di inserimento dell'ordine. 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 codice paese, utilizzato per identificarlo. | string |
| L'indirizzo email registrato con l'account. | string | |
| user_first_name | Il 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 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 nuovi 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: 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 la sezione Configurazione dei webhook di seguito.
Configurazione webhook
Per utilizzare questo componente, è necessario configurare lo strumento webhook flessibili per recuperare le informazioni necessarie dai tuoi servizi esterni.
Verifica dei dettagli dell'utente
Il webhook prebuilt_components_retail_authentication:verify_user_details viene utilizzato dal componente per recuperare i dettagli dell'account utente in base al numero di telefono fornito.
Parametri di richiesta API
I seguenti parametri vengono forniti dal componente come input alla richiesta dell'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 |
|---|---|---|
| L'indirizzo email registrato con l'account. | string | |
| all_recent_order_id | Elenco di ID ordine associati all'utente autenticato, ordinati in base alla data di posizionamento 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 | Il nome dell'utente, utilizzato per salutare e confermare la proprietà dell'account. | string |
Per configurare il webhook Verifica dei dettagli dell'utente per questo componente, espandi 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 predefinito_components_retail_authentication:verify_user_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 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, in quanto sono richiesti dal componente per accedere i valori dei campi restituiti.
- Rivedi e aggiorna le impostazioni Autenticazione in base alle esigenze.
- Fai clic su Salva.
Invia OTP
Il webhook prebuilt_components_retail_authentication:send_otp è in uso
dal componente per inviare una password monouso (OTP) a un canale registrato
selezionate dall'utente finale.
Parametri di richiesta API
I seguenti parametri vengono forniti dal componente come input alla richiesta dell'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 di ricevere l'OTP. I valori validi sono definiti dall'entità personalizzata prebuilt_components_channel_email_phone. Per impostazione predefinita, sono supportati i criteri email e phone. |
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 |
|---|---|---|
| generated_otp | Il valore dell'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 predefinito_components_retail_authentication:send_otp.
- 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, in quanto sono richiesti dal componente per accedere i valori dei campi restituiti.
- Rivedi e aggiorna le impostazioni Autenticazione in base alle esigenze.
- Fai clic su Salva.
Completa
L'agente e i relativi webhook dovrebbero essere configurati e pronti per il test.