Il componente predefinito dello stato dell'ordine controlla il livello di autenticazione di un cliente, quindi fornisce informazioni sugli ordini più recenti o passati dell'utente a un cliente autenticato. Questo componente utilizza il componente predefinito Autenticazione per la vendita al dettaglio per autenticare gli utenti. Il componente utilizza anche Generatori per il riepilogo post-chiamata.
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 la telefonia, il che attiva l'intenzione di benvenuto predefinita e la prima risposta dell'agente all'inizio della conversazione.
Ordine recente
Chiamate dell'utente finale da un numero non registrato; l'agente autentica l'utente, fornisce quindi informazioni dettagliate sulle spedizioni nell'ordine. L'utente conferma di voler ricevere un SMS al suo numero di telefono registrato con ulteriori dettagli.
| Input utente | Risposta dell'agente |
|---|---|
| L'agente autentica l'utente utilizzando il componente predefinito Autenticazione per la vendita al dettaglio | |
| Ok, John. Stai chiamando per avere informazioni sul tuo ultimo ordine di Mario Rossi contenente lampada, camicia e altri 10 articoli inseriti il 10/11/2023 alle 18:00? | |
| Sì | |
| Il tuo ordine ha 2 spedizioni, che verranno consegnate entro il 15/01/2024. Vuoi saperne di più su queste spedizioni? |
|
| Sì | |
| La spedizione 1 contenente jeans, cintura e altri 2 articoli è in transito e verrà consegnata entro il 12/01/2024. La spedizione 2, contenente lampada, camicia e altri 6 articoli, è stata consegnata il 12/11/2023. Vuoi ricevere un SMS con ulteriori dettagli sui tuoi articoli? |
|
| Sì | |
| Ti abbiamo inviato un SMS con un link per monitorare lo stato di tutte le tue spedizioni. Grazie per averci chiamato. |
Ordini duplicati
L'utente finale è stato precedentemente autenticato. L'utente richiede informazioni su un ordine e fornisce le ultime cinque cifre dell'ordine. L'agente rileva che diversi ordini effettuati da questo utente condividono le stesse ultime cinque cifre, quindi conferma l'ordine di cui l'utente vuole conoscere lo stato e fornisce lo stato dell'ordine.
| Input utente | Risposta dell'agente |
|---|---|
| Ok, Amber. Chiami in merito al tuo ordine più recente per Amber Doe contenente una lampada, una camicia e altri 2 articoli effettuato il 10-11-2023 alle ore 18:00? | |
| No | |
| Potresti fornire le ultime 5 cifre dell\'ID ordine che vuoi monitorare? | |
| 12355 | |
| Le ultime cinque cifre dell\'ID ordine che abbiamo ricevuto sono 12355, giusto? | |
| Sì, esatto | |
| Bene, abbiamo finito di raccogliere l'ID ordine. | |
| Dai dati in nostro possesso risulta che abbiamo trovato 2 ordini che terminano con le stesse 5 cifre 12355. Quale ordine stai cercando? Il numero d'ordine 1 è stato effettuato il 10/11/2023 alle 18:00 oppure il 09/11/2023 alle 20:00? Per selezionare il numero 1, di' 1, per selezionare il numero 2, di' 2. Altrimenti, di' No. |
|
| Ordinane uno | |
| Il tuo ordine ha 2 spedizioni, che verranno consegnate entro il 15/01/2024. Vuoi saperne di più su queste spedizioni? |
|
| Sì | |
| La spedizione 1 contenente jeans è in transito e verrà consegnata entro il 15/01/2024. La spedizione 2 contenente lampada, camicia e altri 1 articoli è stata annullata. Vuoi ricevere un SMS con ulteriori dettagli sui tuoi articoli? |
|
| No, non serve altro | |
| Grazie per averci chiamato. |
Convenzioni di denominazione
Questo componente predefinito utilizza le seguenti convenzioni di denominazione:
| Funzionalità | Formato | Esempio |
|---|---|---|
| Flusso | [Component Name] | Stato dell'ordine |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_order_status:get_order_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 da impostare nella pagina iniziale del componente. I parametri basati sulla sessione possono essere impostati da un flusso di chiamate o nella pagina iniziale di questo componente.
Questo componente predefinito accetta i seguenti parametri di input:
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $session.params.phone_number | (Facoltativo) Numero di telefono locale dell'utente, senza il codice paese, utilizzato per identificare l'utente. | string |
| $session.params.all_recent_order_id | (Facoltativo) 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) |
| $session.params.email | (Facoltativo) L'indirizzo email registrato con l'account. | string |
| $session.params.user_first_name | (Facoltativo) Il nome dell'utente, utilizzato per salutare e confermare la proprietà dell'account. | string |
| $flow.max_shipment | Specifica il numero di spedizioni visualizzate contemporaneamente all'utente. Il valore predefinito è 2. |
integer |
| $flow.tracking_status_deliveryed | Specifica il valore restituito dal webhook che indica lo stato dell'ordine pubblicato. Il valore predefinito è "delivered". |
string |
| $flow.tracking_status_cancelled | Specifica il valore restituito dal webhook che indica lo stato dell'ordine annullato. Il valore predefinito è "cancelled". |
string |
| $flow.tracking_status_returned | Specifica il valore restituito dal webhook che indica lo stato dell'ordine restituito. Il valore predefinito è "returned". |
string |
| $flow.tracking_status_partially_returned | Specifica il valore restituito dall'webhook che indica uno stato dell'ordine restituito parzialmente. Il valore predefinito è "partially returned". |
string |
| $flow.max_retry_alternate_profile | Specifica il numero di nuovi tentativi consentiti quando viene richiesto lo stato dell'ordine da un numero di telefono non registrato o da un profilo alternativo. Il valore predefinito è 3. |
integer |
| $flow.max_retry_order_number | Specifica il numero di tentativi consentiti quando fornisci un numero d'ordine. Il valore predefinito è 3. |
integer |
| $flow.max_retry_another_order_id | Specifica il numero di nuovi tentativi consentiti dopo aver fornito un numero d'ordine non valido. 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 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 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 |
|---|---|---|
| phone_number | Il numero di telefono locale dell'utente, senza il codice paese, utilizzato per identificare l'utente. | string |
| 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) |
| 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 dell'uscita dal flusso, 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. Consulta gli eventi integrati senza corrispondenza.webhook_error: si è verificato un errore webhook. Vedi l'evento integrato webhook.error. webhook_not_found: un URL webhook non era raggiungibile. Vedi webhook.error.not-found-in-evento integrato. |
string |
Impostazione di base
Per configurare questo componente predefinito:
- Importa il componente predefinito.
- Configura l'oggetto fornito webhook flessibili con che descrive i servizi esterni, vedi webhook configurazione.
Configurazione webhook
Per utilizzare questo componente, dovrai configurare i webhook flessibili inclusi per recuperare le informazioni necessarie dai tuoi servizi esterni.
Autenticazione
Se non hai configurato in precedenza i servizi esterni richiesti per l'autenticazione, dovrai configurarli per abilitare l'autenticazione degli utenti per questo componente. Consulta Configurazione del webhook di autenticazione retail per istruzioni dettagliate.
Ottieni i dettagli dell'ordine
Il webhook prebuilt_components_order_status:get_order_details viene utilizzato
dal componente per recuperare i dettagli dell'ordine per un ordine specificato.
Parametri di richiesta API
I seguenti parametri vengono forniti dal componente come input alla richiesta dell'API.
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $flow.order_id | ID ordine di cui recuperare i dettagli. | 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 |
|---|---|---|
| order_date | Data di effettuazione dell'ordine, in formato YYYY-MM-DD. |
string |
| order_time | L'ora in cui è stato effettuato l'ordine, in formato HH:MM. |
string |
| order_status | Indica lo stato dell'ordine. Alcuni valori di esempio sono "pending", "processing", "in-transit", "on-hold", "cancelled", "delivered", "returned", "partially returned". |
string |
| order_product_name | Elenco dei nomi dei prodotti all'interno dell'ordine. | Elenco (stringa) |
| order_product_quantity | Conteggio totale del numero di prodotti ordinati per ciascun prodotto all'interno di un ordine. | integer |
| order_product_count | Il numero di prodotti univoci in un ordine. | integer |
| order_status_notification | Indica se le notifiche sono attive per questo ordine. | boolean |
| return_eligibility_date | Elenco delle date entro le quali ogni prodotto all'interno dell'ordine è idoneo alla restituzione, in formato YYYY-MM-DD. |
Elenco (stringa) |
| order_customer_billing_name | Nome del cliente per la fatturazione dell'ordine. | string |
| order_latest_delivery_date | La data di consegna più recente tra tutte le date di consegna stimate per le spedizioni nell'ordine, in formato YYYY-MM-DD. |
string |
| order_shipment_multiple | Indica se l'ordine contiene più spedizioni. | boolean |
| order_shipment_count | Il numero di spedizioni all'interno dell'ordine. | integer |
| order_shipment_product_count | Conteggio totale dei prodotti in ogni spedizione all'interno dell'ordine. | Elenco (numero intero) |
| order_shipment_product_name | Elenco dei nomi dei prodotti in ogni spedizione all'interno dell'ordine. | Elenco (stringa) |
| order_estimated_delivery_date | Elenco delle date di consegna stimate per ogni spedizione all'interno dell'ordine, in formato YYYY-MM-DD. |
Elenco (stringa) |
| order_shipment_status | Elenco che indica lo stato di ogni spedizione all'interno dell'ordine. I valori di esempio includono "pending", "processing", "in-transit", "on-hold", "cancelled", "delivered", "returned" e "partially returned". |
Elenco (stringa) |
Per configurare l'webhook Get order details 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 Gestisci.
- Fai clic su Webhook.
- Seleziona l'webhook prebuilt_components_order_status:get_order_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.
Ricevere ordini duplicati
Il webhook prebuilt_components_retail_services:get_duplicate_order è in uso
dal componente per recuperare informazioni dettagliate e distinguere tra
ordini quando più numeri d'ordine hanno le stesse ultime cinque cifre.
Parametri di richiesta API
I seguenti parametri vengono forniti dal componente come input alla richiesta dell'API.
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $flow.duplicate_order_id | Elenco contenente le ultime cinque cifre dei numeri degli ordini condivisi tra uno o più ordini per l'utente. | 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 |
|---|---|---|
| all_order_date | Elenco delle date degli ordini duplicati con le ultime cinque cifre specificate in formato YYYY-MM-DD. Ogni elemento di questo array corrisponde allo stesso elemento dell'array all_order_time. |
boolean |
| all_order_time | Elenco degli orari degli ordini duplicati con le ultime cinque cifre specificate nel formato HH:MM. Ogni elemento di questo array corrisponde allo stesso elemento dell'array all_order_date. |
numero |
Per configurare l'webhook Ricevi ordini duplicati per questo componente, espandi la sezione per visualizzare le istruzioni.
- Apri la console di Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona il tuo agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook predefinito_components_retail_services:get_ duplicate_order.
- 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 SMS
Il webhook prebuilt_components_order_status:send_sms è in uso
dal componente per inviare i dettagli dell'ordine tramite SMS al numero di telefono specificato.
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 identificarlo. | string |
| $flow.order_id | ID ordine per cui inviare i dettagli dell'ordine. | string |
Per configurare il webhook Invia SMS per questo componente, espandi per visualizzare le istruzioni.
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona il tuo agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook prebuilt_components_order_status:send_sms.
- 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.
Attiva notifiche
Il webhook prebuilt_components_order_status:enable_notification viene utilizzato dal componente per attivare le notifiche per il numero di telefono registrato di un utente.
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 identificarlo. | string |
| $flow.order_notification | Indica se le notifiche devono essere attivate per l'utente. | boolean |
Per configurare l'webhook Attiva notifiche per questo componente, espandi la sezione per visualizzare le istruzioni.
- Apri la console di Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona il tuo agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook prebuilt_components_order_status:enable_notification.
- 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.
Completa
L'agente e i relativi webhook ora dovrebbero essere configurati e pronti per il test.