Annulla ordine componente predefinito

Il componente predefinito di annullamento dell'ordine controlla il livello di autenticazione di un utente. Una volta che l'utente è stato autenticato, il componente fornisce informazioni sugli ordini più recenti o passati dell'utente. L'utente può quindi scegliere di annullare un intero ordine o annullare articoli specifici di un ordine. Questo componente utilizza il componente predefinito Autenticazione retail per autenticare gli utenti. Il componente utilizza anche i Generatori per il riassunto post-chiamata.

Limitazioni

Oltre alle limitazioni comuni dei componenti predefiniti, questo componente predefinito presenta le seguenti limitazioni:

• Questo componente non cripta i dati.

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 utilizzando la telefonia, che attiva l'intent di benvenuto predefinito e la prima risposta dell'agente all'inizio della conversazione.

Annulla singolo prodotto nell'ordine recente

L'utente finale è stato autenticato in precedenza. L'agente conferma gli articoli dell'ordine più recente da annullare. L'agente verifica il metodo di pagamento originale e conferma i dettagli dell'annullamento con l'utente.

Input utente	Risposta dell'agente
	Stai chiamando in merito al numero d'ordine più recente che termina con 12978, che contiene 5 bottiglie d'acqua e 1 maglietta, effettuato il 09/11/2023 alle 20:00?
sì
	Abbiamo trovato alcuni prodotti idonei nel tuo ordine. Indicaci quale prodotto vuoi annullare. Prodotto 1: bottiglia d'acqua google, Prodotto 2: t-shirt google. Di' o inserisci il numero di prodotto dell'articolo che vuoi selezionare oppure di' "Avanti" per mostrare altri prodotti.
successivo
	Non abbiamo trovato altre voci nei nostri dati. Scegli un prodotto dall'elenco condiviso. Prodotto 1: bottiglia d'acqua google, Prodotto 2: t-shirt google. Di' o inserisci il numero di prodotto dell'articolo che vuoi selezionare oppure di' "accanto" per mostrare altri prodotti.
1
	Per verificare, vuoi annullare la bottiglia d'acqua Google. È corretto?
sì
	Possiamo vedere 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, consegna ritardata, acquistato per errore, cambiare il metodo di pagamento o dire altro.
Vorrei acquistare un altro articolo
	Grazie per averci informati. Vuoi annullare un altro prodotto?
no
	Per gli acquisti effettuati con Wallet, i rimborsi vengono accreditati sul portafoglio o sul conto del credito dello Store. Saranno necessari da 3 a 5 giorni lavorativi prima che il rimborso figuri sul tuo conto. Tieni presente che l'importo del rimborso non comprende le spese di spedizione e trasporto.

Annulla l'intero ordine

L'utente finale è stato autenticato in precedenza. L'agente conferma che l'utente vuole annullare un ordine specifico, quindi raccoglie il motivo dell'annullamento. L'agente verifica il metodo di pagamento originale e conferma i dettagli dell'annullamento con l'utente.

Input utente	Risposta dell'agente
	Stai chiamando per il numero d'ordine più recente che termina con 12345, contenente una maglietta, effettuato 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 tracciare?
12346
	Le ultime cinque cifre dell'ID ordine che abbiamo ottenuto sono 12346, giusto?
sì
	Ottimo, abbiamo terminato la raccolta dell'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, consegna ritardata, acquistato per errore, cambiare il metodo di pagamento o dire altro.
non più necessario
	Grazie per averci informati. La richiesta di annullamento è stata generata.

Convenzioni di denominazione

Questo componente predefinito utilizza le seguenti convenzioni di denominazione:

Selezione delle	Formato	Esempio
Flusso	[Nome componente]	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 con ambito a flusso devono essere impostati nella pagina iniziale del componente. I parametri basati sulle sessioni possono essere impostati 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 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 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)
$session.params.email	(Facoltativo) L'indirizzo email registrato con l'account.	string
$session.params.user_first_name	(Facoltativo) 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, compresi i nuovi tentativi.

Nome parametro	Descrizione	Formato
$flow.max_retry_another_account_counter	Specifica il numero di nuovi tentativi consentiti quando scegli se continuare con un account alternativo. Il valore predefinito è 2.	integer
$flow.max_retry_order_number	Specifica il numero di nuovi tentativi consentiti quando fornisci 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 viene selezionato un altro ordine nei casi in cui l'ID ordine non sia presente 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 viene fornito il numero dell'ordine completo nei casi in cui più ordini condividano le 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 nuovi tentativi consentiti durante la conferma del prodotto selezionato. Il valore predefinito è 2.	integer
$flow.max_retry_select_quantity	Specifica il numero massimo di nuovi tentativi consentiti durante la selezione della 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 "altri". Il valore predefinito è "others".	string
$flow.max_retry_cancel_reason	Specifica il numero di nuovi tentativi consentiti quando confermi 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

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 dal componente. Questo componente predefinito fornisce valori per i seguenti parametri di output:

Nome parametro	Descrizione	Formato di output
phone_number	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 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)
email	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 dell'uscita dal flusso, se l'operazione non è riuscita. 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 eventi senza input. Vedi gli eventi integrati senza input. max_no_match: la conversazione ha raggiunto il numero massimo di nuovi tentativi per gli eventi senza corrispondenza. Visualizza gli eventi integrati senza corrispondenza. webhook_error: si è verificato un errore relativo al webhook. Vedi l'evento integrato webhook.error. webhook_not_found: un URL webhook non è raggiungibile. Vedi l'evento integrato webhook.error.not-found.	string

generatori

Questo componente utilizza Generatori per abilitare parti specifiche della conversazione.

Riassunto

Il generatore Summarization viene utilizzato per generare un riepilogo post-chiamata che descriva la conversazione gestita dal componente.

Configurazione di base

Per configurare questo componente predefinito:

1. Importa il componente predefinito.
2. Configura i webhook flessibili forniti con una configurazione che descrive i servizi esterni di Dialogflow. Vedi Configurazione webhook.

Configurazione webhook

Per utilizzare questo componente, devi configurare i hook flessibili inclusi per recuperare le informazioni necessarie dai servizi esterni.

Autenticazione

Se non hai precedentemente configurato i servizi esterni richiesti per l'autenticazione, dovrai configurarli per abilitare l'autenticazione degli utenti per questo componente. Per istruzioni dettagliate, consulta Configurazione del webhook di autenticazione per la vendita al dettaglio.

Ottenere i dettagli dell'ordine

Il webhook prebuilt_components_cancel_order:get_order_details viene utilizzato dal componente per recuperare i dettagli di un ordine specificato.

Parametri delle richieste API

I seguenti parametri sono forniti dal componente come input per la richiesta API.

Nome parametro	Descrizione	Formato 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 all'interno di un ordine.	integer
order_payment_mode	Indica la modalità di pagamento utilizzata per effettuare l'ordine.	string
cancelable_product_id	Elenco di ID prodotto dei prodotti annullabili all'interno dell'ordine.	Elenco (stringa)
cancelable_product_name	Elenco dei nomi di prodotto per i prodotti annullabili all'interno dell'ordine.	Elenco (stringa)
cancelable_product_brand_name	Elenco di nomi di brand per i prodotti annullabili all'interno dell'ordine.	Elenco (stringa)
cancelable_product_quantity	Elenco delle quantità per i prodotti annullabili all'interno dell'ordine.	Elenco (stringa)

Ottenere dettagli dell'ordine duplicati

Il webhook prebuilt_components_retail_services:get_duplicate_order_details viene utilizzato dal componente per recuperare informazioni dettagliate in modo da distinguere tra ordini quando più numeri di ordine hanno le stesse ultime cinque cifre.

Parametri delle richieste API

I seguenti parametri sono forniti dal componente come input per la richiesta API.

Nome parametro	Descrizione	Formato 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 di 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 in formato HH:MM. Ogni elemento di questo array corrisponde allo stesso elemento dell'array all_order_date.	Elenco (stringa)

Dettagli dopo l'annullamento

Il webhook prebuilt_components_cancel_order:post_cancellation_details viene utilizzato dal componente per inviare una richiesta di annullamento.

Parametri delle richieste API

I seguenti parametri sono forniti dal componente come input per la richiesta API.

Nome parametro	Descrizione	Formato input
$session.params.phone_number	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	Elenco degli ID prodotto che l'utente vuole annullare.	Elenco (stringa)
$flow.cancel_product_quantity_list	Elenco delle quantità di prodotto che l'utente vuole annullare, corrispondenti a ogni elemento in $flow.cancel_product_id_list.	Elenco (stringa)
$flow.cancel_reason_list	Elenco dei motivi di annullamento per ogni prodotto annullato, corrispondenti 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

Completi

L'agente e i relativi webhook dovrebbero essere configurati e pronti per i test.