Componente predefinito per resi e rimborsi

Il componente predefinito per resi e rimborsi 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. L'utente può quindi scegliere di restituire più articoli di un ordine e selezionare opzioni tra cui i metodi di rimborso e reso. 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 e le domande frequenti.

Limitazioni

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

• Questo componente non cripta i dati.

Esempi di dialoghi

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

Reso in negozio per un singolo prodotto

L'utente finale è stato autenticato in precedenza. L'agente conferma quali articoli dell'ordine più recente devono essere restituiti e raccoglie il motivo del reso. L'utente sceglie di restituire gli articoli in un negozio e l'agente fornisce un elenco dei negozi più vicini. L'utente seleziona un negozio e l'agente genera un'etichetta spedizione che viene inviata ai canali registrati dell'utente.

Input utente	Risposta dell'agente
	Stai chiamando per il tuo ordine più recente che termina con 12345 contenente 2 lampade effettuato il 10/11/2023?
sì
	Per confermare, vuoi restituire la lampada Google. È corretto?
sì
	Possiamo vedere che la quantità disponibile del prodotto che hai selezionato è 2. Specifica la quantità di prodotti che vuoi restituire.
due
	Specifica il motivo del reso. Puoi dire qualcosa come: articolo difettoso o non funzionante, non più necessario, problema di taglia o vestibilità, articolo errato inviato, articolo arrivato troppo tardi, acquistato per errore o altro.
altri
	Indica il motivo del reso.
qualità scadente
	Per verificare, il motivo del reso è la scarsa qualità. È corretto?
sì
	Facci sapere dove vuoi ricevere il rimborso. Puoi dire qualcosa come credito dello Store o account di origine.
account di origine
	Grazie per aver confermato che vuoi ricevere il rimborso sul metodo di pagamento originale. Come ultimo passaggio, come vuoi restituire il prodotto? Puoi dire qualcosa come: Reso in negozio, Consegna presso un punto di ritiro o Programma il ritiro.
reso in negozio
	Troviamo un negozio nelle vicinanze.
	L'agente raccoglie il codice postale utilizzando il componente predefinito Raccolta del codice postale
	Ecco l'elenco delle sedi vicino al codice postale che hai inserito. Indirizzo 1: Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, US. Indirizzo 2: Google California, 19510 Jamboree Road, Irvine, California 92612, US. Pronuncia o inserisci il numero dell'indirizzo che vuoi selezionare oppure di' "avanti" per visualizzare altri indirizzi dei negozi.
1
	Per confermare, hai selezionato Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, US. È corretto?
sì
	Perfetto. Abbiamo inviato un'etichetta spedizione e un numero di ticket al tuo numero di telefono e al tuo indirizzo email registrati. Stampala, applicala al pacco e spedisci il reso entro 30 giorni. Una volta ricevuto l'articolo presso il nostro magazzino, saranno necessari da 3 a 5 giorni lavorativi prima che il rimborso venga visualizzato nel tuo account. Tieni presente che l'importo del rimborso non includerà i costi di spedizione e gestione. Grazie per aver chiamato.

Convenzioni di denominazione

Questo componente predefinito utilizza le seguenti convenzioni di denominazione:

Funzionalità	Formato	Esempio
Flow	[Component Name]	Reso e rimborso
Tipo di entità	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_return_refund_mode_of_return
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_return_refund:post_return_details

Parametri di input

I parametri di input vengono 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 di flusso devono essere impostati nella pagina iniziale del componente. I parametri con ambito sessione possono essere impostati da un flusso chiamante o nella pagina di avvio 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 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 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) 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 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 è 3.	integer
$flow.max_retry_another_order	Specifica il numero di nuovi tentativi consentiti quando si seleziona un altro ordine per il reso nei casi in cui l'ID ordine non viene trovato o l'ordine non è idoneo per il reso. Il valore predefinito è 2.	integer
$flow.max_retry_select_order_number	Specifica il numero di tentativi consentiti per fornire 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 tentativi consentiti quando si seleziona un prodotto da restituire. Il valore predefinito è 2.	integer
$flow.max_product_return_confirm_counter	Specifica il numero massimo di nuovi tentativi consentiti per la conferma del prodotto selezionato. Il valore predefinito è 2.	integer
$flow.max_retry_return_reason_counter	Specifica il numero di tentativi consentiti per confermare il motivo del reso. Il valore predefinito è 2.	integer
$flow.order_product_return_reason_others	Specifica il valore dell'entità prebuilt_components_return_refund_reason che indica che l'utente ha selezionato il motivo del reso "altri". Il valore predefinito è "others".	string
$flow.max_retry_select_quantity	Specifica il numero massimo di tentativi consentiti quando si seleziona la quantità di prodotto da restituire. Il valore predefinito è 2.	integer
$flow.max_store_display_counter	Specifica il numero massimo di negozi da presentare in un singolo turno. Il valore predefinito è 1.	integer
$flow.max_store_display	Specifica il numero massimo di negozi da presentare nel corso dell'intera conversazione. Il valore predefinito è 10.	integer
$flow.max_retry_store_number_counter	Specifica il numero massimo di nuovi tentativi consentiti quando si seleziona un negozio. Il valore predefinito è 2.	integer
$flow.max_retry_store_selection	Specifica il numero di nuovi tentativi consentiti per la conferma della selezione del negozio. Il valore predefinito è 2.	integer
$flow.max_retry_another_zip_code	Specifica il numero massimo di tentativi consentiti per fornire un codice postale. 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
$flow.order_refund_mode_source_account	Specifica il valore dell'entità prebuilt_components_return_refund_mode_of_refund che indica che l'utente ha scelto di ricevere il rimborso sul proprio account di origine. Il valore predefinito è source_account.	string
$flow.order_return_location_scheduled_for_pickup	Specifica il valore dell'entità prebuilt_components_exchange_order_location che indica che l'utente ha scelto di programmare un ritiro per il reso. Il valore predefinito è scheduled_for_pickup.	string

Per configurare i parametri di input per questo componente, espandi la sezione per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona l'agente.
4. Seleziona la scheda Build.
5. Fai clic sul componente importato nella sezione Flussi.
6. Fai clic sulla pagina iniziale nella sezione Pagine.
7. Fai clic sul percorso true nella pagina iniziale.
8. Nella finestra Route (Percorso), modifica i valori di Parameter Presets (Preset dei parametri) in base alle tue esigenze.
9. 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 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 prefisso internazionale, 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 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)
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 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 in un momento 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 di assenza di 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

Questo componente utilizza i generatori per attivare parti specifiche della conversazione.

Domande frequenti

Il generatore FAQ viene utilizzato per gestire le domande frequenti su resi e cambi, tra cui:

• Esiste una scadenza per la procedura di reso?
• Posso cambiare un articolo ricevuto in dono?
• Il prezzo del prodotto e l'importo del rimborso sono diversi. Perché?

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:

1. Importa il componente predefinito.
2. Configura i webhook flessibili forniti con la configurazione che descrive i tuoi servizi esterni. Consulta la sezione Configurazione dei webhook.

Configurazione del webhook

Per utilizzare questo componente, devi 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. Per istruzioni dettagliate, consulta Configurazione del webhook di autenticazione di Retail.

Ottieni i dettagli dell'ordine

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

Parametri di richiesta API

I seguenti parametri vengono forniti dal componente 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

I seguenti parametri vengono estratti dalla risposta dell'API per essere utilizzati dal componente.

Nome parametro	Descrizione	Formato di output
order_date	Data in cui è stato effettuato l'ordine, nel formato YYYY-MM-DD.	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
returnable_product_id	Elenco degli ID prodotto dei prodotti restituibili all'interno dell'ordine.	Elenco (stringa)
returnable_product_name	Elenco dei nomi dei prodotti restituibili all'interno dell'ordine.	Elenco (stringa)
returnable_product_brand_name	Elenco dei nomi dei brand dei prodotti restituibili all'interno dell'ordine.	Elenco (stringa)
returnable_product_quantity	Elenco delle quantità di prodotti restituibili nell'ordine.	Elenco (stringa)

Per configurare il webhook Recupera i dettagli dell'ordine per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona l'agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_return_refund:get_order_details.
7. 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.
8. Esamina e aggiorna il corpo della richiesta per formare il formato di richiesta appropriato per il webhook.
9. 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.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Ottieni i dettagli dell'ordine duplicato

Il webhook prebuilt_components_retail_services:get_duplicate_order_details viene utilizzato dal componente per recuperare informazioni dettagliate al fine di distinguere gli 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 per la richiesta 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 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 nel formato YYYY-MM-DD. Ogni elemento di questo array corrisponde allo stesso elemento nell'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 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.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona l'agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_retail_services:get_duplicate_order_details.
7. 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.
8. Esamina e aggiorna il corpo della richiesta per formare il formato di richiesta appropriato per il webhook.
9. 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.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Ottieni i dettagli dello store

Il webhook prebuilt_components_return_refund:get_store_details viene utilizzato dal componente per recuperare l'elenco dei negozi vicini al codice postale fornito dall'utente.

Parametri di richiesta API

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

Nome parametro	Descrizione	Formato di input
$flow.zip_code	Codice postale per cercare i negozi vicini.	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
store_id	Elenco degli ID negozio.	Elenco (stringa)
store_address	Elenco degli indirizzi dei negozi corrispondenti a ogni elemento di store_id.	Elenco (stringa)

Per configurare il webhook Ottieni dettagli del negozio per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona l'agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_return_refund:get_store_details.
7. 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.
8. Esamina e aggiorna il corpo della richiesta per formare il formato di richiesta appropriato per il webhook.
9. 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.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Dettagli del reso dopo la spedizione

Il webhook prebuilt_components_return_refund:post_return_details viene utilizzato dal componente per inviare un reso.

Parametri di richiesta API

I seguenti parametri vengono forniti dal componente 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 prefisso internazionale, utilizzato per identificare l'utente.	string
$flow.order_id	ID ordine per cui inviare un ticket.	string
$flow.return_product_id_list	Elenco degli ID prodotto che l'utente vuole restituire.	Elenco (stringa)
$flow.return_product_quantity_list	Elenco delle quantità di prodotti che l'utente vuole restituire, corrispondente a ogni elemento in $flow.return_product_id_list.	Elenco (stringa)
$flow.return_reason_list	Elenco dei motivi del reso per ogni prodotto restituito, corrispondente a ogni elemento in $flow.return_product_id_list.	Elenco (stringa)
$flow.order_return_location	La modalità selezionata per il reso. I valori validi sono definiti dall'entità prebuilt_components_exchange_order_location.	string
$flow.order_return_store_id	L'ID del negozio selezionato dall'utente per un reso in negozio.	string
$flow.order_refund_mode	La modalità di pagamento per il rimborso. I valori validi sono definiti dall'entità prebuilt_components_return_refund_mode_of_return. Se non è richiesto alcun rimborso, questo valore è null.	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_return_ticket_id	ID ticket per il reso inviato.	string

Per configurare il webhook dei dettagli di reso per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona l'agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_return_refund:post_return_details.
7. 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.
8. Esamina e aggiorna il corpo della richiesta per formare il formato di richiesta appropriato per il webhook.
9. 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.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Invia le informazioni sul rimborso per il pagamento in contanti alla consegna

Il webhook prebuilt_components_return_refund:send_COD_refund_information viene utilizzato dal componente per inviare a un utente i dati di pagamento relativi al reso.

Parametri di richiesta API

I seguenti parametri vengono forniti dal componente 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 prefisso internazionale, utilizzato per identificare l'utente.	string
$flow.order_id	ID ordine per cui inviare un ticket.	string
$flow.channel	Il canale specifico a cui inviare le informazioni. I valori validi sono definiti dall'entità prebuilt_components_channel_email_phone. Per impostazione predefinita, sono supportati phone e email.	string

Per configurare il webhook Invia informazioni sul rimborso COD per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona l'agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_return_refund:send_COD_refund_information.
7. 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.
8. Esamina e aggiorna il corpo della richiesta per formare il formato di richiesta appropriato per il webhook.
9. 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.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Completa

Ora l'agente e i relativi webhook dovrebbero essere configurati e pronti per essere testati.