Il componente predefinito per i resi e i 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. La l'utente può quindi scegliere di restituire più articoli di uno stesso ordine e selezionare delle opzioni inclusi 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 Generatori per post-chiamata riepilogo e domande frequenti.
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.
Reso in negozio per un singolo prodotto
L'utente finale è stato precedentemente autenticato. L'agente conferma quali articoli dell'ordine più recente devono essere restituiti e raccoglie il motivo del reso. L'utente seleziona la restituzione degli articoli in un negozio e l'agente fornisce un elenco dei negozi più vicini. L'utente seleziona un negozio e l'agente genera un l'etichetta spedizione inviata ai canali registrati dell'utente.
| Input utente | Risposta dell'agente |
|---|---|
| Chiami in merito al tuo numero d\'ordine più recente che termina con 12345 e contiene 2 lampade ordinate il 10/11/2023? | |
| sì | |
| Mi confermi che vuoi restituire la lampada Google. È corretto? | |
| sì | |
| Abbiamo notato che la quantità disponibile del prodotto che hai selezionato è 2. Specifica la quantità di prodotti che vuoi restituire. | |
| due | |
| Specifica il motivo del reso. Ad esempio, puoi dire: articolo difettoso o non funzionante, non più necessario, problema di taglia o vestibilità, articolo errato, articolo arrivato troppo tardi, acquistato per errore o altro. | |
| altri | |
| Indica il motivo del reso. | |
| di scarsa qualità | |
| Come verifica, il motivo del reso è di scarsa qualità. È corretto? | |
| sì | |
| Facci sapere dove vuoi ricevere il rimborso. Puoi dire, ad esempio, credito dello Store o account di origine. | |
| account di origine | |
| Grazie per aver confermato di voler restituire il rimborso sul metodo di pagamento originale. Come ultimo passaggio, come vuoi restituire il prodotto? Puoi dire ad esempio: Restituisci in negozio o Consegna presso un punto di ritiro o Pianifica il ritiro. |
|
| reso in negozio | |
| Troviamo un negozio vicino a te. | |
| L'agente raccoglie il codice postale utilizzando il componente predefinito Raccolta codici postali | |
| Ecco l'elenco delle sedi vicino al codice postale 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 per mostrare altri indirizzi di negozi. |
|
| 1 | |
| Per conferma: hai selezionato Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, US. È corretto? | |
| sì | |
| Perfetto. Abbiamo inviato un'etichetta di spedizione e un numero di biglietto al tuo numero di telefono e all'indirizzo email registrati. Stampalo e attaccalo al 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 compaia sul tuo conto. 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 |
|---|---|---|
| Flusso | [Nome componente] | 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 di per determinare il comportamento del componente. I parametri con ambito a livello di flusso devono da impostare nella pagina iniziale 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) 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 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 di configurare il comportamento del componente, inclusi i tentativi di nuovo invio, tramite i seguenti parametri facoltativi.
| Nome parametro | Descrizione | Formato |
|---|---|---|
| $flow.max_retry_another_account_counter | Specifica il numero di nuovi tentativi consentiti quando si seleziona se continuare con un account alternativo. Il valore predefinito è 2. |
integer |
| $flow.max_retry_order_number | Specifica il numero di 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 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 quando fornisci il numero completo dell'ordine 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 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 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 tentativi consentiti per la conferma del 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 "altri" motivo del reso. Il valore predefinito è "others". |
string |
| $flow.max_retry_select_quantity | Specifica il numero massimo di nuovi tentativi consentiti durante 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 durante la selezione di un negozio. Il valore predefinito è 2. |
integer |
| $flow.max_retry_store_selection | Specifica il numero di nuovi tentativi consentiti durante la conferma della selezione del negozio. Il valore predefinito è 2. |
integer |
| $flow.max_retry_another_zip_code | Specifica il numero massimo di 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 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 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 un ritiro per il 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 di Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Crea.
- Fai clic sul componente importato nella sezione Fluidi.
- 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 importanti informazioni raccolte di strumento di authoring. 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 identificare l'utente. | 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. Vedi gli eventi integrati senza input.max_no_match: la conversazione ha raggiunto il numero massimo di nuovi tentativi per eventi senza corrispondenza. Vedi gli eventi integrati senza corrispondenza.webhook_error: si è verificato un errore relativo al webhook. Vedi l'evento integrato webhook.error. webhook_not_found: l'URL webhook non è 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 sui resi
e piattaforme di scambio pubblicitario, tra cui:
- Esiste 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 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 l'autenticazione, dovrai configurarli per abilitare l'autenticazione degli 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_return_refund: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_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 per i prodotti restituibili nell'ordine. | Elenco (stringa) |
| returnable_product_name | Elenco dei nomi dei prodotti restituibili nell'ordine. | Elenco (stringa) |
| returnable_product_brand_name | Elenco dei nomi dei brand dei prodotti restituibili nell'ordine. | Elenco (stringa) |
| returnable_product_quantity | Elenco delle quantità per i prodotti restituibili all'interno dell'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 l'agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona l'webhook prebuilt_components_return_refund: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 per creare il formato di richiesta corretto per l'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.
- Rivedi e aggiorna le impostazioni 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 è in uso
dal componente per recuperare informazioni dettagliate e distinguere tra
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 alla richiesta dell'API.
| Nome parametro | Descrizione | Formato di 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 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 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 l'webhook Get duplicate order details per questo componente, espandi per visualizzare le istruzioni.
- Apri la console di Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona l'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 per creare il formato di richiesta corretto per l'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.
- Rivedi e aggiorna le impostazioni Autenticazione in base alle esigenze.
- Fai clic su Salva.
Visualizza i dettagli del negozio
Il webhook prebuilt_components_return_refund:get_store_details è utilizzato da
il 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 alla richiesta dell'API.
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $flow.zip_code | Codice postale per cercare i 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 degli indirizzi dei negozi corrispondenti a ogni elemento di store_id. |
Elenco (stringa) |
Per configurare il webhook per visualizzare i 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 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 per creare il formato di richiesta corretto per l'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.
- Rivedi e aggiorna le impostazioni Autenticazione in base alle esigenze.
- Fai clic su Salva.
Dettagli del reso del post
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 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.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, 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 ciascun 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 la restituzione 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 richiesta per il reso inviato. | string |
Per configurare il webhook Dettagli post ritorno 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 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 per creare il formato di richiesta corretto per l'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.
- Rivedi e aggiorna le impostazioni Autenticazione in base alle 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 ai resi.
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.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 l'webhook Invia informazioni sul rimborso con pagamento alla consegna per questo componente, espandi la sezione 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 l'webhook prebuilt_components_return_refund:send_COD_refund_information.
- 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 per creare il formato di richiesta corretto per l'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.
- Rivedi e aggiorna le impostazioni 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.