Annulla l'ordine componente predefinito controlla il livello di autenticazione di un utente. Una volta autenticato l'utente, il componente fornisce informazioni sugli ordini più recenti o passati dell'utente. La l'utente può decidere di annullare un intero ordine o di annullare articoli specifici in un ordine. Questo componente utilizza la classe Autenticazione retail componente predefinito per autenticare gli utenti. Il componente utilizza anche Generatori per il riepilogo post-chiamata.
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 chiamata mediante la telefonia, che attiva l'intent di benvenuto predefinito e la risposta dell'agente all'inizio della conversazione.
Annulla il singolo prodotto nell'ordine recente
L'utente finale è stato autenticato in precedenza. L'agente conferma quali articoli l'ordine più recente dovrebbe essere annullato. L'agente controlla il metodo di pagamento originale e conferma i dettagli dell'annullamento con l'utente.
| Input utente | Risposta dell'agente |
|---|---|
| Ci stai chiamando perché il numero d'ordine più recente che termina con 12978 contiene 5 bottiglie d'acqua e 1 maglietta inserita il 09-11-2023 alle 20:00? | |
| sì | |
| Abbiamo trovato alcuni prodotti idonei nel tuo ordine. Indicaci quale prodotto vuoi annullare. Prodotto 1: borraccia Google, prodotto 2: t-shirt Google. Di' o inserisci il numero del prodotto che vuoi selezionare oppure di' "Avanti" per visualizzare altri prodotti. |
|
| successivo | |
| Non abbiamo trovato altri elementi nei nostri dati. Scegli dall'elenco condiviso. Prodotto 1: bottiglia d'acqua Google, Prodotto 2: t-shirt Google. Dì o inserisci il numero del prodotto dell'articolo che vuoi selezionare oppure "Avanti" per mostrare più prodotti. |
|
| 1 | |
| Mi confermi che vuoi annullare l\'ordine della bottiglia d\'acqua Google? È corretto? | |
| sì | |
| Possiamo notare che la quantità disponibile del prodotto che hai selezionato è 5. Specifica la quantità di prodotti che vuoi annullare. | |
| 4 | |
| Specifica il motivo dell'annullamento. Potresti dire, ad esempio, ho cambiato idea, non mi serve più, vorrei acquistare un altro articolo, consegnare in ritardo, acquistato per errore, voglio cambiare metodo di pagamento o dire altre persone. | |
| Vorrei acquistare un altro articolo | |
| Grazie per averci informati. Vuoi annullare un altro prodotto? |
|
| no | |
| Per gli acquisti effettuati utilizzando il tuo portafoglio, i rimborsi vengono accreditati sul wallet o sul conto di credito dello Store. Il rimborso verrà accreditato sul tuo conto in 3-5 giorni lavorativi. Tieni presente che l'importo del rimborso esclude le spese di spedizione e trasporto. |
Annullare l'intero ordine
L'utente finale è stato autenticato in precedenza. L'agente conferma che l'utente vuole annullare un ordine specifico, poi raccoglie il motivo dell'annullamento. La che l'agente controlla il metodo di pagamento originale e conferma l'annullamento i dettagli con l'utente.
| Input utente | Risposta dell'agente |
|---|---|
| Ci stai chiamando perché il numero d'ordine più recente che termina con 12345 contiene 1 camicia inserito il 10/11/2023 alle 18:00? | |
| no | |
| Vuoi annullare un altro ordine? | |
| sì | |
| Potresti fornire le ultime 5 cifre dell'ID ordine che vuoi monitorare? | |
| 12346 | |
| Le ultime cinque cifre dell\'ID ordine che abbiamo ricevuto sono 12346, giusto? | |
| sì | |
| Bene, abbiamo finito di raccogliere l'ID ordine. Vuoi annullare l'intero ordine? |
|
| sì | |
| Specifica il motivo dell'annullamento. Potresti dire, ad esempio, ho cambiato idea, non mi serve più, vorrei acquistare un altro articolo, consegnare in ritardo, acquistato per errore, voglio cambiare metodo di pagamento o dire altre persone. | |
| non più necessaria | |
| Grazie per averci informati. La richiesta di annullamento è stata generata. |
Convenzioni di denominazione
Questo componente predefinito utilizza le seguenti convenzioni di denominazione:
| Funzionalità | Formato | Esempio |
|---|---|---|
| Flusso | [Component Name] | Annulla ordine |
| Tipo di entità | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_product_cancel_reason |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_cancel_order:post_cancellation_details |
Parametri di input
I parametri di input sono parametri utilizzati per configurare determinati comportamenti del componente. I parametri verranno utilizzati da una o più condizioni all'interno del flusso per determinare il comportamento del componente. I parametri a livello di flusso devono essere impostati nella pagina di avvio 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 |
Questo componente predefinito consente ai seguenti parametri facoltativi di configurare il comportamento del componente, inclusi i nuovi tentativi.
| Nome parametro | Descrizione | Formato |
|---|---|---|
| $flow.max_retry_another_account_counter | Specifica il numero di tentativi consentiti quando si sceglie se continuare con un account alternativo. Il valore predefinito è 2. |
integer |
| $flow.max_retry_order_number | Specifica il numero di nuovi tentativi consentiti fornendo le ultime cinque cifre di un numero dell'ordine. Il valore predefinito è 2. |
integer |
| $flow.max_retry_another_order | Specifica il numero di nuovi tentativi consentiti durante la selezione di un altro ordine nei casi in cui l'ID ordine non sia trovato o l'ordine non sia idoneo per l'annullamento. Il valore predefinito è 2. |
integer |
| $flow.max_retry_select_order_number | Specifica il numero di nuovi tentativi consentiti quando fornisci il numero completo dell'ordine nel caso in cui più ordini condividano le stesse ultime cinque cifre. Il valore predefinito è 2. |
integer |
| $flow.max_product_display_counter | Specifica il numero massimo di prodotti da presentare in un singolo turno. Il valore predefinito è 2. |
integer |
| $flow.max_product_display | Specifica il numero massimo di prodotti da presentare nell'intera conversazione. Il valore predefinito è 9. |
integer |
| $flow.max_retry_product_number_counter | Specifica il numero massimo di nuovi tentativi consentiti durante la selezione di un prodotto da annullare. Il valore predefinito è 2. |
integer |
| $flow.max_product_cancel_confirm_counter | Specifica il numero massimo di tentativi consentiti per la conferma del prodotto selezionato. Il valore predefinito è 2. |
integer |
| $flow.max_retry_select_quantity | Specifica il numero massimo di tentativi consentiti quando si seleziona la quantità di prodotto da annullare. Il valore predefinito è 2. |
integer |
| $flow.order_product_cancel_reason_others | Specifica il valore dell'entità prebuilt_components_product_cancel_reason che indica che l'utente ha selezionato il motivo di annullamento "Altro". Il valore predefinito è "others". |
string |
| $flow.max_retry_cancel_reason | Specifica il numero di tentativi consentiti per confermare il motivo dell'annullamento. Il valore predefinito è 2. |
integer |
| $flow.order_payment_mode_COD | Specifica il valore del campo order_payment_mode restituito dal webhook get_order_details che indica un metodo di pagamento in contanti alla consegna (COD). Il valore predefinito è "COD". |
string |
| $flow.order_payment_mode_store_credit | Specifica il valore del campo order_payment_mode restituito dal webhook get_order_details che indica un metodo di pagamento per il credito dello Store. Il valore predefinito è "store_credit". |
string |
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 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 dal componente. Questi parametri contengono informazioni importanti raccolte dal componente. Questo componente predefinito fornisce valori per il seguente output parametri:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| phone_number | Il numero di telefono locale dell'utente, senza il codice paese, utilizzato per identificarlo. | 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 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. 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 |
Generatori
Questo componente utilizza i generatori per attivare parti specifiche della conversazione.
Riassunto
Il generatore Summarization viene utilizzato per generare un riepilogo post-chiamata che descrive
la conversazione gestita dal componente.
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 configurazione dei webhook.
Configurazione webhook
Per utilizzare questo componente, è necessario configurare lo strumento webhook flessibili per recuperare le informazioni necessarie dai tuoi servizi esterni.
Autenticazione
Se non hai configurato in precedenza i servizi esterni richiesti per dell'autenticazione, dovrai configurarle per abilitare l'autenticazione utenti per questo componente. Per istruzioni dettagliate, consulta la sezione Configurazione del webhook di autenticazione per la vendita al dettaglio.
Ottieni i dettagli dell'ordine
Il webhook prebuilt_components_cancel_order: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 | La data in cui è stato effettuato l'ordine in formato YYYY-MM-DD. |
string |
| order_time | L'ora in cui è stato effettuato l'ordine, in formato HH:MM. |
string |
| order_product_count | Il numero di prodotti univoci in un ordine. | integer |
| order_payment_mode | Indica la modalità di pagamento utilizzata al momento dell'ordine. | string |
| cancelable_product_id | Elenco degli ID prodotto dei prodotti annullabili all'interno dell'ordine. | Elenco (stringa) |
| cancelable_product_name | Elenco dei nomi dei prodotti annullabili nell'ordine. | Elenco (stringa) |
| cancelable_product_brand_name | Elenco dei nomi dei brand per i prodotti annullabili nell'ordine. | Elenco (stringa) |
| cancelable_product_quantity | Elenco delle quantità dei prodotti annullabili nell'ordine. | Elenco (stringa) |
Per configurare il webhook per visualizzare i dettagli dell'ordine 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 l'webhook prebuilt_components_cancel_order: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 appropriato nel menu a discesa.
- Esamina e aggiorna il corpo della richiesta in modo che corrisponda al formato di richiesta corretto per il 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.
Visualizza i dettagli degli ordini duplicati
Il webhook prebuilt_components_retail_services:get_duplicate_order_details viene utilizzato dal componente per recuperare informazioni dettagliate al fine di distinguere tra gli ordini quando più numeri di 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 d'ordine condivisi tra uno o più ordini dell'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. |
Elenco (stringa) |
| 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. |
Elenco (stringa) |
Per configurare il webhook Ottieni dettagli dell'ordine duplicati 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_retail_services:get_ duplicate_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 appropriato nel menu a discesa.
- Esamina e aggiorna il corpo della richiesta in modo che corrisponda al formato di richiesta corretto per il 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.
Dettagli della cancellazione del post
Il webhook prebuilt_components_cancel_order:post_cancellation_details viene utilizzato dal componente per inviare una richiesta di annullamento.
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 un ticket. | string |
| $flow.cancel_product_id_list | Elenco degli ID prodotto che l'utente vuole annullare. | Elenco (stringa) |
| $flow.cancel_product_quantity_list | Elenco delle quantità di prodotti che l'utente vuole annullare, corrispondente a ogni elemento in $flow.cancel_product_id_list. |
Elenco (stringa) |
| $flow.cancel_reason_list | Elenco dei motivi dell'annullamento per ogni prodotto annullato, corrispondente a ogni elemento in $flow.cancel_product_id_list. |
Elenco (stringa) |
| $flow.order_refund_mode | La modalità di pagamento per il rimborso. I valori validi sono definiti dall'entità prebuilt_components_cancel_mode_of_refund. |
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_cancellation_ticket_id | ID ticket per l'annullamento inviato. | string |
Per configurare il webhook Dettagli annullamento post 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_cancel_order:post_unsubscribe_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 in modo che corrisponda al formato di richiesta corretto per il 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.