Il componente predefinito per l'annullamento degli ordini controlla il livello di autenticazione di un utente. Dopo l'autenticazione dell'utente, il componente fornisce informazioni sugli ordini più recenti o passati dell'utente. L'utente può quindi scegliere di annullare un intero ordine o articoli specifici di un ordine.
Questo componente utilizza il componente predefinito Autenticazione per la vendita al dettaglio per autenticare gli utenti. Il componente utilizza anche i generatori per il riepilogo post-chiamata.
Limitazioni
Oltre alle limitazioni comuni dei componenti predefiniti, questo componente predefinito include le seguenti limitazioni:
- Questo componente non cripta i dati.
Esempi di dialoghi
Le finestre di dialogo di esempio mostrano gli scenari comuni gestiti da questo componente predefinito. Mostrano il comportamento quando l'utente chiama il componente utilizzando la telefonia, che attiva l'intent di benvenuto predefinito e la prima risposta dell'agente all'inizio della conversazione.
Annulla un singolo prodotto in un ordine recente
- L'utente è stato autenticato in precedenza.
- L'agente conferma quali articoli dell'ordine più recente annullare.
- L'agente controlla il metodo di pagamento originale e conferma i dettagli dell'annullamento con l'utente.
| Input utente | Risposta dell'agente |
|---|---|
| Stai chiamando per il tuo ordine più recente con numero che termina con 12978 contenente 5 borracce e 1 t-shirt effettuato il 9 novembre 2023 alle 20:00? | |
| sì | |
| Abbiamo trovato alcuni prodotti idonei nel tuo ordine. Indica quale prodotto vuoi annullare. Prodotto 1: borraccia Google, Prodotto 2: t-shirt Google. Pronuncia o inserisci il numero del prodotto che vuoi selezionare oppure di' "avanti" per visualizzare altri prodotti. |
|
| successivo | |
| Non abbiamo trovato altri elementi nei nostri record. Scegli dall'elenco condiviso. 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. |
|
| 1 | |
| Per verificare, ti interessa annullare la borraccia Google. È corretto? | |
| sì | |
| Possiamo vedere che la quantità disponibile del prodotto selezionato è 5. Specifica la quantità di prodotti che vuoi annullare. | |
| 4 | |
| Specifica il motivo dell'annullamento. Puoi dire qualcosa come: ho cambiato idea, non mi serve più, vorrei acquistare un altro articolo, consegna in ritardo, acquistato per errore, voglio cambiare metodo di pagamento o altro. | |
| Vorrei acquistare un altro articolo | |
| Grazie per avercelo comunicato. Vuoi annullare un altro prodotto? |
|
| no | |
| Per gli acquisti effettuati utilizzando il wallet, i rimborsi vengono accreditati sul wallet o sull'account del credito dello Store. Potrebbero essere necessari da 3 a 5 giorni lavorativi prima che il rimborso venga visualizzato sul tuo conto. Tieni presente che l'importo del rimborso non include i costi di spedizione e gestione. |
Annulla l'intero ordine
- L'utente è stato autenticato in precedenza.
- L'agente conferma che l'utente vuole annullare un ordine specifico, quindi raccoglie il motivo dell'annullamento.
- L'agente controlla il metodo di pagamento originale e conferma i dettagli dell'annullamento con l'utente.
| Input utente | Risposta dell'agente |
|---|---|
| Stai chiamando per il tuo ordine più recente con numero che termina con 12345 contenente 1 maglietta effettuato il 10/11/2023 alle 18:00? | |
| no | |
| Vuoi annullare un altro ordine? | |
| sì | |
| Puoi fornirmi le ultime 5 cifre dell'ID ordine che vuoi monitorare? | |
| 12346 | |
| Le ultime cinque cifre dell'ID ordine che abbiamo ricevuto sono 12346, è corretto? | |
| sì | |
| Ottimo, abbiamo raccolto l'ID ordine. Vuoi annullare l'intero ordine? |
|
| sì | |
| Specifica il motivo dell'annullamento. Puoi dire qualcosa come: ho cambiato idea, non mi serve più, vorrei acquistare un altro articolo, consegna in ritardo, acquistato per errore, voglio cambiare metodo di pagamento o altro. | |
| non più necessario | |
| Grazie per avercelo comunicato. La tua richiesta di annullamento è stata generata. |
Convenzioni di denominazione
Questo componente predefinito utilizza le seguenti convenzioni di denominazione:
| Funzionalità | Formato | Esempio |
|---|---|---|
| Flow | [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 configurano determinati comportamenti del componente. Una o più condizioni all'interno del flusso utilizzano questi parametri per determinare il comportamento del componente. Devi impostare i parametri con ambito del flusso nella pagina iniziale del componente. Puoi impostare i parametri con ambito sessione utilizzando 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.phone_number | (Facoltativo) Il numero di telefono locale dell'utente, senza il prefisso internazionale, 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 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) |
| $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 ti consente di utilizzare i seguenti parametri facoltativi per configurare il comportamento del componente, inclusi i nuovi tentativi.
| Nome parametro | Descrizione | Formato |
|---|---|---|
| $flow.max_retry_another_account_counter | Specifica il numero di nuovi 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 tentativi consentiti quando si forniscono le ultime cinque cifre di un numero d'ordine. Il valore predefinito è 2. |
integer |
| $flow.max_retry_another_order | Specifica il numero di nuovi tentativi consentiti quando si seleziona un altro ordine nei casi in cui l'ID ordine non viene trovato o l'ordine non è idoneo per l'annullamento. Il valore predefinito è 2. |
integer |
| $flow.max_retry_select_order_number | Specifica il numero di tentativi consentiti quando si fornisce il numero d'ordine completo nei casi in cui più ordini condividono 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 nel corso dell'intera conversazione. Il valore predefinito è 9. |
integer |
| $flow.max_retry_product_number_counter | Specifica il numero massimo di nuovi tentativi consentiti quando si seleziona un prodotto da annullare. Il valore predefinito è 2. |
integer |
| $flow.max_product_cancel_confirm_counter | Specifica il numero massimo di nuovi 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 dell'annullamento "Altri". Il valore predefinito è "others". |
string |
| $flow.max_retry_cancel_reason | Specifica il numero di nuovi tentativi consentiti per la conferma del 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 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 con credito dello Store. Il valore predefinito è "store_credit". |
string |
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 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 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 l'uscita dal componente. Questi parametri contengono informazioni importanti raccolte dal componente.
Questo componente predefinito restituisce i 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 | 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) |
| 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 | Il motivo per cui il flusso è stato chiuso, 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 senza 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 |
Generatori
I generatori alimentano parti specifiche della conversazione.
Riassunto
Il generatore Summarization genera 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 fornendo una configurazione che descrive i tuoi servizi esterni. Per ulteriori informazioni, consulta la sezione Configurazione del webhook.
Configurazione del webhook
Per utilizzare questo componente, devi configurare i webhook flessibili inclusi per recuperare le informazioni richieste dai tuoi servizi esterni.
Autenticazione
Se non hai configurato in precedenza i servizi esterni richiesti per l'autenticazione, configurali per abilitare l'autenticazione utente per questo componente. Per saperne di più sull'autenticazione, consulta la guida alla configurazione del webhook di autenticazione di Retail.
Ottieni i dettagli dell'ordine
Il webhook prebuilt_components_cancel_order:get_order_details recupera i dettagli
dell'ordine per un ordine specificato.
Parametri di richiesta API
Il componente fornisce i seguenti parametri come input per la richiesta API:
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $flow.order_id | ID ordine per cui recuperare i dettagli. | string |
Parametri di risposta dell'API
Il componente recupera i seguenti parametri dalla risposta dell'API:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| order_date | La data in cui è stato effettuato l'ordine, nel formato YYYY-MM-DD. |
string |
| order_time | La data e l'ora in cui è stato effettuato l'ordine, nel formato HH:MM. |
string |
| order_product_count | Il numero di prodotti unici all'interno di un ordine. | integer |
| order_payment_mode | Indica la modalità di pagamento utilizzata per l'ordine. | string |
| cancelable_product_id | Un elenco di ID prodotto per i prodotti annullabili all'interno dell'ordine. | Elenco (stringa) |
| cancelable_product_name | Un elenco di nomi di prodotti annullabili all'interno dell'ordine. | Elenco (stringa) |
| cancelable_product_brand_name | Un elenco di nomi di brand per i prodotti annullabili all'interno dell'ordine. | Elenco (stringa) |
| cancelable_product_quantity | Un elenco di quantità per i prodotti annullabili all'interno dell'ordine. | Elenco (stringa) |
Per configurare il webhook Ottieni dettagli dell'ordine 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_cancel_order:get_order_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.
Ottieni i dettagli dell'ordine duplicato
Il webhook prebuilt_components_retail_services:get_duplicate_order_details consente al componente di recuperare informazioni dettagliate per distinguere gli ordini quando più numeri di ordine hanno le stesse ultime cinque cifre.
Parametri di richiesta API
Il componente fornisce i seguenti parametri come input per la richiesta API:
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $flow.duplicate_order_id | Un elenco contenente le ultime cinque cifre dei numeri d'ordine condivisi tra uno o più ordini per l'utente. | Elenco (stringa) |
Parametri di risposta dell'API
Il componente recupera i seguenti parametri dalla risposta dell'API:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| all_order_date | Un elenco di date degli ordini duplicati con le ultime cinque cifre specificate nel formato YYYY-MM-DD. Ogni elemento di questo array corrisponde allo stesso elemento nell'array all_order_time. |
Elenco (stringa) |
| all_order_time | Un 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 nell'array all_order_date. |
Elenco (stringa) |
Per configurare il webhook Recupera i dettagli dell'ordine duplicato 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_services:get_duplicate_order_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.
Dettagli forniti dopo l'annullamento
Il componente utilizza il webhook prebuilt_components_cancel_order:post_cancellation_details per inviare una richiesta di annullamento.
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 codice paese, utilizzato per identificare l'utente. | string |
| $flow.order_id | ID ordine per cui inviare un ticket. | string |
| $flow.cancel_product_id_list | Un elenco di ID prodotto che l'utente vuole annullare. | Elenco (stringa) |
| $flow.cancel_product_quantity_list | Un elenco di quantità di prodotti che l'utente vuole annullare, corrispondente a ogni elemento in $flow.cancel_product_id_list. |
Elenco (stringa) |
| $flow.cancel_reason_list | Un elenco di 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
Il componente recupera i seguenti parametri dalla risposta dell'API:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| order_cancellation_ticket_id | ID ticket per l'annullamento inviato. | string |
Per configurare il webhook dei dettagli di annullamento della prenotazione 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_cancel_order:post_cancellation_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.
Completa
Il componente predefinito per l'annullamento dell'ordine e i relativi webhook sono ora configurati e pronti per essere testati.