Componente predefinito per gli ordini di scambio

L'ordine di scambio componente predefinito 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 scambiare più articoli in un ordine e selezionare opzioni tra cui metodi di rimborso e spedizione. Questo componente utilizza il componente predefinito Autenticazione retail per autenticare gli utenti. Il componente utilizza anche 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 alcun dato.

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.

Sostituzione in negozio di un articolo difettoso

L'utente finale è stato autenticato in precedenza. L'agente conferma quali articoli dell'ordine più recente devono essere scambiati e raccoglie il motivo dello scambio. L'utente sceglie di cambiare 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 canali registrati dell'utente.

Input utente	Risposta dell'agente
	Mi chiami in merito al tuo ordine più recente con numero finale 12375 contenente 2 lampade, 2 Pixel e 10 altri prodotti effettuato il 10/11/2023?
sì
	Abbiamo trovato alcuni prodotti idonei nel tuo ordine. Specifica il prodotto che vuoi scambiare. Prodotto 1: lampada Google, Prodotto 2: Google Pixel, Prodotto 3: luce LED Google. Pronuncia o inserisci il numero del prodotto che vuoi selezionare oppure di' "Avanti" per visualizzare altri prodotti.
1
	Per confermare, ti interessa sostituire la lampada Google. È corretto?
sì
	Possiamo vedere che la quantità disponibile del prodotto che hai selezionato è 2. Specifica la quantità di prodotti che vuoi sostituire.
Due
	Specifica il motivo del cambio. Puoi scrivere ad esempio: articolo difettoso o non funzionante, problema di taglia o vestibilità, problema di ordine incompleto, problema di stile, colore errato o altro.
Articolo difettoso
	Grazie per avercelo comunicato. Come ultimo passaggio, come vorresti effettuare il cambio del prodotto? Puoi dire qualcosa del tipo: Cambio in un negozio o Programma il ritiro.
Voglio effettuare un cambio in un negozio
	Troviamo un negozio vicino a te.
	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, Stati Uniti. Indirizzo 2: Google California, 19510 Jamboree Road, Irvine, California 92612, Stati Uniti. Pronuncia o inserisci il numero dell'indirizzo che vuoi selezionare oppure di' "Avanti" per visualizzare altri indirizzi di negozi.
Il primo negozio
	Per confermare, 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 di ticket al tuo numero di telefono e indirizzo email registrati. Stampalo, attaccalo al pacco e spedisci il reso entro 30 giorni. Una volta ricevuto l'articolo presso il nostro magazzino, saranno necessari 3-5 giorni lavorativi prima che l'eventuale cambio venga visualizzato nel tuo account. Nota: l'importo del rimborso non include le spese di spedizione e gestione. Il prodotto sostitutivo ha un valore superiore. La differenza di prezzo è di 20$. A breve riceverai il link di pagamento sul tuo numero di cellulare registrato. Ti invitiamo a effettuare il pagamento entro 24 ore per effettuare il cambio. Vuoi cambiare un altro ordine?
no, è tutto
	Grazie per aver chiamato.

Rimborso per differenza di prezzo

L'utente finale è stato autenticato in precedenza. L'agente raccoglie il numero dell'ordine, il prodotto da sostituire e il motivo della sostituzione. L'utente sceglie di scambiare gli articoli con una taglia diversa e programma un ritiro. L'agente identifica che l'articolo scambiato ha un prezzo inferiore rispetto al nuovo articolo e conferma con l'utente il metodo di pagamento per un rimborso.

Input utente	Risposta dell'agente
	Stai chiamando in merito al tuo numero d'ordine più recente che termina con 12345 contenente 2 lampade effettuate il 10/11/2023?
No
	Vuoi cambiare un altro ordine?
Sì
	Potresti fornirci le ultime 5 cifre dell'ID ordine che vuoi scambiare?
12346
	Le ultime cinque cifre dell'ID ordine che abbiamo ricevuto sono 12346. È corretto?
Sì
	Ottimo, abbiamo terminato la raccolta dell'ID ordine. Abbiamo trovato alcuni prodotti idonei nel tuo ordine. Specifica il prodotto che vuoi scambiare. 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.
Due
	Per verificare che ti interessi la permuta della t-shirt di Google. È corretto?
Sì
	Specifica il motivo del cambio. Puoi scrivere ad esempio: articolo difettoso o non funzionante, problema di taglia o vestibilità, problema di ordine incompleto, problema di stile, colore errato o altro.
Problema di dimensioni o adattabilità
	Grazie per averci comunicato il motivo del cambio. Puoi dirci la taglia con cui vorresti effettuare il cambio? Abbiamo a disposizione le seguenti taglie: Di' 1 per la taglia piccola. Di' 2 per la taglia media. Di' 3 per la taglia grande. Di' 4 per la taglia XL. Di' 5 per la taglia XXL.
1
	Come ultimo passaggio, come vorresti scambiare il prodotto? Puoi dire qualcosa del tipo: Cambio in un negozio o Programma il ritiro.
Programma il ritiro
	Perfetto. Abbiamo inviato un'etichetta di spedizione al tuo numero di telefono e indirizzo email registrati. Stampalo e allegalo al pacco. Il nostro team ti contatterà entro le prossime 24-48 ore per programmare il ritiro. Una volta ricevuto l'articolo nel nostro magazzino, saranno necessari 3-5 giorni lavorativi prima che il rimborso per lo scambio venga visualizzato nel tuo account. Il prodotto scambiato ha un valore inferiore e hai diritto a un rimborso di 5$. Comunicaci dove vuoi ricevere il rimborso. Puoi dire, ad esempio, credito del negozio o account di origine.
Credito dello Store
	Grazie per aver confermato che vuoi che il rimborso venga restituito al portafoglio. Vuoi cambiare un altro ordine?
no
	Grazie per aver chiamato.

Ordine non idoneo

L'utente finale è stato autenticato in precedenza. L'agente controlla l'ordine più recente e rileva che non sono presenti prodotti idonei per il cambio. L'agente raccoglie un numero d'ordine dall'utente e scopre che l'ordine fornito non contiene prodotti idonei.

Input utente	Risposta dell'agente
	Non abbiamo trovato prodotti nel tuo ordine più recente idonei al cambio. Vuoi cambiare un altro ordine?
sì
	Potresti fornirci le ultime 5 cifre dell'ID ordine che vuoi scambiare?
23487
	Le ultime cinque cifre dell'ID ordine che abbiamo ricevuto sono 23487. È corretto?
sì
	Ottimo, abbiamo finito di raccogliere l'ID ordine.
	Spiacenti, non ci sono prodotti nel tuo ordine idonei al cambio in base alle nostre norme. Puoi trovare maggiori informazioni sulle nostre norme sui cambi sul nostro sito web. Vuoi cambiare un altro ordine?
no
	Grazie per aver chiamato.

Convenzioni di denominazione

Questo componente predefinito utilizza le seguenti convenzioni di denominazione:

Funzionalità	Formato	Esempio
Flow	[Component Name]	Order Status
Tipo di entità	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_exchange_order_location
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_exchange_order:get_product_exchange_availability

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 flusso devono essere impostati nella pagina iniziale del componente. I parametri con ambito sessione possono essere impostati da 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 per data di inserimento dell'ordine in ordine decrescente. Il primo elemento dell'array rappresenta l'ordine più recente. Se un utente non ha effettuato ordini, il valore di questo parametro è null.	Elenco (stringa)
$session.params.email	(facoltativo) L'email registrata con l'account.	string
$session.params.user_first_name	(facoltativo) Il nome dell'utente, utilizzato per salutarlo e confermare la proprietà dell'account.	string

Questo componente predefinito consente di configurare i seguenti parametri facoltativi del comportamento del componente, inclusi i tentativi.

Nome parametro	Descrizione	Formato
$flow.max_retry_another_account	Specifica il numero di tentativi consentiti quando si sceglie se continuare con un account alternativo. Il valore predefinito è 3.	integer
$flow.max_retry_order_number	Specifica il numero di tentativi consentiti quando vengono fornite 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 allo scambio. Il valore predefinito è 2.	integer
$flow.max_retry_select_order_number	Specifica il numero di tentativi consentiti quando viene fornito il numero d'ordine completo nei casi in cui più ordini condividono le stesse ultime cinque cifre. Il valore predefinito è 2.	integer
$flow.max_retry_exchange_reason	Specifica il numero di tentativi consentiti quando viene fornito il motivo dello scambio. Il valore predefinito è 3.	integer
$flow.max_retry_exchange_reason_counter	Specifica il numero di tentativi consentiti durante la conferma del motivo dello scambio. Il valore predefinito è 2.	integer
$flow.order_product_exchange_reason_others	Specifica il valore dell'entità prebuilt_components_exchange_order_reason che indica che l'utente ha selezionato il motivo dello scambio "altro". Il valore predefinito è "others".	string
$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 durante l'intera conversazione. Il valore predefinito è 9.	integer
$flow.max_product_exchange_confirm	Specifica il numero massimo di tentativi consentiti durante la conferma del prodotto selezionato. Il valore predefinito è 2.	integer
$flow.max_retry_product_number_counter	Specifica il numero massimo di tentativi consentiti durante la selezione di un prodotto da scambiare. Il valore predefinito è 3.	integer
$flow.max_retry_select_quantity	Specifica il numero massimo di tentativi consentiti durante la selezione della quantità di prodotto da scambiare. Il valore predefinito è 2.	integer
$flow.max_retry_size_number_counter	Specifica il numero massimo di tentativi consentiti durante la selezione della taglia da scambiare. Il valore predefinito è 2.	integer
$flow.max_retry_another_zip_code	Specifica il numero massimo di tentativi consentiti quando viene fornito un codice postale. Il valore predefinito è 2.	integer
$flow.max_store_display_counter	Specifica il numero massimo di negozi da presentare in una singola svolta. Il valore predefinito è 1.	integer
$flow.max_store_display	Specifica il numero massimo di negozi da presentare durante l'intera conversazione. Il valore predefinito è 10.	integer
$flow.max_retry_store_number_counter	Specifica il numero massimo di tentativi consentiti durante la selezione di un negozio. Il valore predefinito è 2.	integer
$flow.max_retry_store_selection	Specifica il numero di tentativi consentiti durante la conferma della selezione del negozio. Il valore predefinito è 3.	integer
$flow.max_available_address_reselection_counter	Specifica il numero di tentativi consentiti per confermare se l'utente vuole selezionare un indirizzo del negozio diverso. Il valore predefinito è 2.	integer
$flow.order_payment_mode_COD	Specifica il valore del campo order_payment_mode restituito dal get_order_details webhook che indica un metodo di pagamento in contrassegno. Il valore predefinito è "COD".	string
$flow.order_payment_mode_store_credit	Specifica il valore del campo order_payment_mode restituito dal get_order_details webhook 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_exchange_order_refund_mode che indica che l'utente ha scelto di effettuare il rimborso sul proprio account di origine. Il valore predefinito è source_account.	string
$flow.order_exchange_location_scheduled_for_pickup	Specifica il valore dell'entità prebuilt_components_exchange_order_location che indica che l'utente ha selezionato la pianificazione di un ritiro per lo scambio. Il valore predefinito è scheduled_for_pickup.	string

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

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Crea.
5. Fai clic sul componente importato nella sezione Flussi.
6. Fai clic su Pagina iniziale nella sezione Pagine.
7. Fai clic sulla route true nella pagina iniziale.
8. Nella finestra Route, modifica i valori di Preset 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 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	Questo parametro elenca gli ID ordine associati all'utente autenticato, ordinati per data di inserimento dell'ordine in ordine decrescente. Il primo elemento dell'array rappresenta l'ordine più recente. Se un utente non ha effettuato ordini, il valore di questo parametro è null.	Elenco (stringa)
email	L'indirizzo email registrato con l'account.	string
user_first_name	Il nome dell'utente, utilizzato per salutarlo e confermare la proprietà dell'account.	string
transfer_reason	Questo parametro indica il motivo per cui il flusso è stato interrotto, se non è andato a buon fine. Il valore restituito è uno dei seguenti: agent: l'utente finale ha richiesto un operatore umano a un certo punto della conversazione. denial_of_information: l'utente finale si è rifiutato di condividere le informazioni richieste dal componente. max_no_input: la conversazione ha raggiunto il numero massimo di tentativi per gli eventi senza input. Consulta gli eventi integrati senza input. max_no_match: la conversazione ha raggiunto il numero massimo di tentativi per gli eventi senza corrispondenza. Consulta eventi integrati senza corrispondenza. webhook_error: si è verificato un errore webhook. Vedi webhook.error evento integrato. webhook_not_found: un URL webhook non era raggiungibile. Vedi webhook.error.not-found evento integrato.	string

Generatori

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

Domande frequenti

Il generatore di 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 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:

1. Importa il componente predefinito.
2. Configura i webhook flessibili forniti con la configurazione che descrive i tuoi servizi esterni. Per informazioni sulla configurazione dei webhook, consulta la sezione Configurazione dei webhook.

Configurazione 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 necessari 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.

Ottieni i dettagli dell'ordine

Il webhook prebuilt_components_exchange_order:get_order_details viene utilizzato dal componente per recuperare i dettagli dell'ordine per un ordine specifico.

Parametri della 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 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 al momento dell'ordine.	string
exchangeable_product_id	Elenco degli ID prodotto per i prodotti sostituibili all'interno dell'ordine.	Elenco (stringa)
exchangeable_product_name	Elenco dei nomi dei prodotti scambiabili all'interno dell'ordine.	Elenco (stringa)
exchangeable_product_brand_name	Elenco dei nomi dei brand per i prodotti sostituibili all'interno dell'ordine.	Elenco (stringa)
exchangeable_product_quantity	Elenco delle quantità per i prodotti sostituibili all'interno dell'ordine.	Elenco (stringa)
exchangeable_product_price	Elenco dei prezzi dei prodotti sostituibili all'interno dell'ordine.	Elenco (stringa)

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

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_exchange_order: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 corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al 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 tra gli ordini quando più numeri d'ordine hanno le stesse ultime cinque cifre.

Parametri della 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 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 il webhook Get duplicate order details per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo 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 corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al 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.

Ottenere la dimensione di scambio disponibile

Il webhook prebuilt_components_exchange_order:get_available_exchange_size viene utilizzato dal componente per recuperare le taglie disponibili per il cambio nei casi in cui l'utente desidera cambiare un articolo a causa di problemi di taglia o vestibilità.

Parametri della richiesta API

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

Nome parametro	Descrizione	Formato di input
$flow.selected_order_product_id	L'ID prodotto del prodotto che l'utente vuole scambiare.	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
product_available_sizes	Elenco delle dimensioni disponibili per il prodotto selezionato.	Elenco (stringa)

Per configurare il webhook Get available exchange size per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_exchange_order:get_available_exchange_size.
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 corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al 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.

Recuperare la disponibilità dello scambio di prodotti

Il webhook prebuilt_components_exchange_order:get_product_exchange_availability viene utilizzato dal componente per verificare se il prodotto, la quantità e la taglia facoltativa selezionati dall'utente sono disponibili per il cambio.

Parametri della 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 recuperare i dettagli.	string
$flow.selected_order_product_id	L'ID prodotto del prodotto che l'utente vuole scambiare.	string
$flow.order_product_quantity_exchange_count	Quantità del prodotto che l'utente vuole scambiare.	integer
$flow.product_selected_size	Taglia del prodotto che l'utente vuole scambiare.	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
product_exchange_availability	Indica se il prodotto, la quantità e la taglia selezionati sono disponibili per il cambio.	boolean
product_exchange_price	Indica il prezzo di cambio per un singolo articolo del prodotto e della taglia selezionati.	numero

Per configurare il webhook Get product exchange availability per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_exchange_order:get_product_exchange_availability.
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 corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al 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.

Apri un ticket per ordine incompleto

Il webhook prebuilt_components_exchange_order:raise_incomplete_order_ticket viene utilizzato dal componente per creare un ticket quando l'utente vuole sostituire un prodotto all'interno di un ordine perché incompleto.

Parametri della 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 codice paese, utilizzato per identificare l'utente.	string
$flow.order_id	ID ordine per cui inviare un ticket.	string
$flow.selected_order_product_id	L'ID prodotto del prodotto che l'utente vuole scambiare.	string
$flow.order_product_quantity_exchange_count	Quantità del prodotto che l'utente vuole scambiare.	integer
$flow.order_product_exchange_reason	Il motivo per cui l'utente vuole sostituire il prodotto.	string

Per configurare il webhook Raise incomplete order ticket per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_exchange_order:raise_incomplete_order_ticket.
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 corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al 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.

Recupera i dettagli dell'archivio

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

Parametri della 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 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 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 negozio per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_exchange_order: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 corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al 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 dello scambio di post

Il webhook prebuilt_components_exchange_order:post_exchange_details viene utilizzato dal componente per inviare uno scambio.

Parametri della 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 codice paese, utilizzato per identificare l'utente.	string
$flow.order_id	ID ordine per cui inviare un ticket.	string
$flow.selected_order_product_id	L'ID prodotto del prodotto che l'utente vuole scambiare.	string
$flow.order_product_quantity_exchange_count	Quantità del prodotto che l'utente vuole scambiare.	integer
$flow.product_selected_size	Taglia del prodotto che l'utente vuole scambiare.	string
$flow.order_product_exchange_reason	Il motivo per cui l'utente vuole sostituire il prodotto.	string
$flow.order_exchange_location	La modalità selezionata per lo scambio. I valori validi sono definiti dall'entità prebuilt_components_exchange_order_location.	string
$flow.order_exchange_store_id	L'ID dello store selezionato dall'utente per un cambio di store.	string
$flow.order_refund_mode	La modalità di pagamento per il rimborso, se applicabile. I valori validi sono definiti dall'entità prebuilt_components_exchange_order_refund_mode. Se non è richiesto alcun rimborso, questo valore è null.	string
$flow.total_refund_amount	L'importo da rimborsare, se il prezzo del prodotto sostituibile è superiore a quello del nuovo prodotto. Se non è richiesto alcun rimborso, questo valore è null.	integer

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_exchange_ticket_id	ID ticket per lo scambio inviato.	string

Per configurare il webhook Dettagli post-scambio per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_exchange_order:post_exchange_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 corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al 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.

Inviare i dati per il rimborso in contrassegno

Il webhook prebuilt_components_exchange_order:send_COD_refund_information viene utilizzato dal componente per inviare a un utente informazioni di pagamento relative allo scambio.

Parametri della 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 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 phone e email.	string

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

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_exchange_order: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 corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al 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

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