Il componente predefinito per resi e rimborsi 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 restituire più articoli in un ordine e selezionare opzioni tra cui i metodi di rimborso e reso. Questo componente utilizza il componente predefinito Autenticazione retail per autenticare gli utenti. Il componente utilizza anche Generatori per il riassunto 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.
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.
Reso in negozio per un singolo prodotto
L'utente finale è stato autenticato in precedenza. L'agente conferma gli articoli dell'ordine più recente da restituire 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 di spedizione che viene inviata ai suoi canali registrati.
| Input utente | Risposta dell'agente |
|---|---|
| Stai chiamando in merito al tuo numero d'ordine più recente che termina con 12345 contenente 2 lampade posizionato il 10/11/2023? | |
| sì | |
| Per conferma: 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. Potresti dire ad esempio: articolo difettoso o non funzionante, non più necessario, problema con dimensioni o vestibilità, invio dell'articolo sbagliato, articolo arrivato troppo tardi, acquistato per errore o dire altro. | |
| altre | |
| Indica il motivo della restituzione. | |
| qualità scadente | |
| Per verificare, il motivo del reso è di scarsa qualità. È corretto? | |
| sì | |
| Facci sapere dove vorresti ricevere il rimborso. Prova a dire, ad esempio, credito dello Store o account di origine. | |
| account di origine | |
| Grazie per aver verificato di voler restituire il rimborso sul metodo di pagamento originale. Come ultimo passaggio, come vuoi restituire il prodotto? Ad esempio, puoi dire "Reso in negozio", "Consegna a domicilio" o "Programma di ritiro". |
|
| reso in negozio | |
| Troviamo un negozio nelle vicinanze. | |
| L'agente raccoglie il codice postale utilizzando il componente predefinito Raccolta codici postali | |
| Ecco l'elenco delle sedi vicine al codice postale inserito. Indirizzo 1: Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, Stati Uniti. Indirizzo 2: Google California, 19510 Jamboree Road, Irvine, California 92612, Stati Uniti. Di' o inserisci il numero dell'indirizzo che vuoi dire accanto al negozio da selezionare oppure altro. |
|
| 1 | |
| Per conferma: hai selezionato Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, Stati Uniti. È corretto? | |
| sì | |
| Perfetto. Abbiamo inviato un'etichetta di spedizione e un numero del biglietto al tuo numero di telefono e indirizzo email registrati. Stampalo e allegalo al tuo pacco e consegna il reso entro 30 giorni. Una volta ricevuto l'articolo in magazzino, saranno necessari da 3 a 5 giorni lavorativi prima che il rimborso figuri sul tuo conto. Nota: l'importo del rimborso esclude le spese di gestione e spedizione. Grazie per aver chiamato. |
Convenzioni di denominazione
Questo componente predefinito utilizza le seguenti convenzioni di denominazione:
| Selezione delle | Formato | Esempio |
|---|---|---|
| Flusso | [Nome componente] | Resi e rimborsi |
| 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 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 è 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 sia trovato o l'ordine non sia idoneo per il reso. 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 quando viene selezionato un prodotto da restituire. Il valore predefinito è 2. |
integer |
| $flow.max_product_return_confirm_counter | Specifica il numero massimo di nuovi tentativi consentiti durante la conferma del prodotto selezionato. Il valore predefinito è 2. |
integer |
| $flow.max_retry_return_reason_counter | Specifica il numero di nuovi tentativi consentiti quando confermi 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 di restituzione "altri". Il valore predefinito è "others". |
string |
| $flow.max_retry_select_quantity | Specifica il numero massimo di nuovi tentativi consentiti per la selezione della 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 nell'intera conversazione. Il valore predefinito è 10. |
integer |
| $flow.max_retry_store_number_counter | Specifica il numero massimo di nuovi tentativi consentiti quando viene selezionato un negozio. Il valore predefinito è 2. |
integer |
| $flow.max_retry_store_selection | Specifica il numero di nuovi tentativi consentiti quando confermi la selezione del negozio. Il valore predefinito è 2. |
integer |
| $flow.max_retry_another_zip_code | Specifica il numero massimo di nuovi tentativi consentiti quando fornisci 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 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 |
| $flow.order_refund_mode_source_account | Specifica il valore dell'entità prebuilt_components_return_refund_mode_of_refund che indica che l'utente ha selezionato 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 selezionato per pianificare il ritiro del reso. Il valore predefinito è scheduled_for_pickup. |
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 su Pagina iniziale nella sezione Pagine.
- Fai clic sul percorso true nella pagina iniziale.
- Nella finestra Route, modifica i valori in Parameter Presets (Preimpostazioni parametri) in base alle tue 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 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) |
| 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.
Domande frequenti
Il generatore FAQ viene utilizzato per gestire le domande frequenti su resi e scambi, tra cui:
- È prevista una scadenza per la procedura di reso?
- Posso cambiare un articolo regalo?
- 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 descriva
la conversazione gestita dal componente.
Configurazione di base
Per configurare questo componente predefinito:
- Importa il componente predefinito.
- 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_return_refund: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_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 |
| returnable_product_id | Elenco di ID prodotto dei prodotti restituibili all'interno dell'ordine. | Elenco (stringa) |
| returnable_product_name | Elenco dei nomi di prodotto per i prodotti restituibili all'interno dell'ordine. | Elenco (stringa) |
| returnable_product_brand_name | Elenco dei nomi di brand per i prodotti restituibili all'interno dell'ordine. | Elenco (stringa) |
| returnable_product_quantity | Elenco delle quantità per i prodotti restituibili 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 predefinito_components_return_refund:get_order_details.
- Sostituisci l'URL nel campo URL webhook di Dialogflow 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 da formare il formato della richiesta corretto per il tuo 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.
- Rivedi e aggiorna le impostazioni di Autenticazione in base alle tue esigenze.
- Fai clic su Salva.
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) |
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 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 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 da formare il formato della richiesta corretto per il tuo 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.
- Rivedi e aggiorna le impostazioni di Autenticazione in base alle tue esigenze.
- Fai clic su Salva.
Visualizza 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 delle richieste API
I seguenti parametri sono forniti dal componente come input per la richiesta API.
| Nome parametro | Descrizione | Formato input |
|---|---|---|
| $flow.zip_code | CAP per cercare negozi nelle vicinanze. | 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 di ID negozio. | Elenco (stringa) |
| store_address | Elenco di 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.
- 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 predefinito_components_return_refund:get_store_details.
- Sostituisci l'URL nel campo URL webhook di Dialogflow 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 da formare il formato della richiesta corretto per il tuo 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.
- Rivedi e aggiorna le impostazioni di Autenticazione in base alle tue esigenze.
- Fai clic su Salva.
Dettagli del reso dopo
Il webhook prebuilt_components_return_refund:post_return_details viene utilizzato
dal componente per inviare un reso.
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.return_product_id_list | Elenco degli ID prodotto che l'utente vuole restituire. | Elenco (stringa) |
| $flow.return_product_quantity_list | Elenco delle quantità di prodotto che l'utente vuole restituire, corrispondenti 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 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 Dettagli reso 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 predefinito_components_return_refund:post_return_details.
- Sostituisci l'URL nel campo URL webhook di Dialogflow 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 da formare il formato della richiesta corretto per il tuo 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.
- Rivedi e aggiorna le impostazioni di Autenticazione in base alle tue esigenze.
- Fai clic su Salva.
Invia informazioni sul rimborso COD
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 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.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 i criteri phone e email. |
string |
Per configurare il webhook Invia informazioni sul rimborso COD 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_return_refund:send_COD_refund_information.
- Sostituisci l'URL nel campo URL webhook di Dialogflow 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 da formare il formato della richiesta corretto per il tuo 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.
- Rivedi e aggiorna le impostazioni di Autenticazione in base alle tue esigenze.
- Fai clic su Salva.
Completi
L'agente e i relativi webhook dovrebbero essere configurati e pronti per i test.