Il componente predefinito dell'ordine di scambio controlla il livello di autenticazione di un utente. Una volta che l'utente è stato autenticato, fornisce informazioni sugli ordini più recenti o passati dell'utente. L'utente può quindi scegliere di cambiare più articoli in un ordine e selezionare opzioni tra cui metodi di rimborso e spedizione. Questo componente utilizza la classe Autenticazione retail componente predefinito 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.
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 chiamata mediante la telefonia, che attiva l'intent di benvenuto predefinito e la risposta dell'agente all'inizio della conversazione.
Sostituzione in negozio per un articolo con problemi
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 seleziona la sostituzione 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'etichetta di spedizione che viene inviata ai canali registrati dell'utente.
| Input utente | Risposta dell'agente |
|---|---|
| Chiami in merito al tuo numero d'ordine più recente che termina con 12375 e contiene 2 lampade, 2 Pixel e altri 10 prodotti effettuati il 10-11-2023? | |
| sì | |
| Abbiamo trovato alcuni prodotti idonei nel tuo ordine. Dicci quale prodotto vorresti scambiare. Prodotto 1: lampada Google, prodotto 2: Google Pixel, prodotto 3: luce LED Google. Pronuncia o inserisci il numero di prodotto dell'articolo che vuoi selezionare oppure di' Avanti per mostrare altri prodotti. |
|
| 1 | |
| Mi confermi che ti interessa sostituire la lampada Google? È corretto? | |
| sì | |
| Abbiamo notato che la quantità disponibile del prodotto che hai selezionato è 2. Specifica la quantità di prodotti che vuoi scambiare. | |
| Due | |
| Specifica il motivo dello scambio. Potresti dire, ad esempio: Articolo difettoso o non funzionante, problema relativo alle dimensioni o alla vestibilità, problema con ordine incompleto, problema di stile, colore errato oppure altro. | |
| Articolo difettoso | |
| Grazie per avercelo comunicato. Come ultimo passaggio, come vuoi cambiare il prodotto? Puoi dire, ad esempio, Cambio in un negozio o Programma per il ritiro. |
|
| Voglio effettuare uno scambio in un negozio | |
| Troviamo un negozio vicino a te. | |
| L'agente raccoglie il codice postale utilizzando il componente predefinito Raccolta codice postale | |
| Ecco l'elenco di sedi vicine 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. Di' o inserisci il numero civico che vuoi selezionare oppure di' "avanti" per visualizzare altri indirizzi dei negozi. |
|
| Il primo negozio | |
| 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 il numero del ticket al numero di telefono e all'indirizzo email registrati. Stampalo e attaccalo al pacco e consegna il pacco entro 30 giorni. Una volta ricevuto l'articolo presso il nostro magazzino, saranno necessari da 3 a 5 giorni lavorativi prima che il tuo cambio, se presente, compaia sul tuo conto. Nota: l'importo del rimborso esclude le spese di spedizione e gestione. Il prodotto sostitutivo ha un valore superiore. La differenza di prezzo è di 20$. A breve riceverai il link per il pagamento sul numero di cellulare registrato. Effettua il pagamento entro 24 ore per effettuare lo scambio. Vuoi cambiare un altro ordine? |
|
| no è tutto | |
| Grazie per aver chiamato. |
Rimborso per differenza di prezzo
L'utente finale è stato precedentemente autenticato. L'agente raccoglie il numero dell'ordine, il prodotto da cambiare e il motivo dello scambio. L'utente sceglie di cambiare gli articoli con una taglia diversa e pianifica un ritiro. L'agente conferma che l'articolo scambiato ha un prezzo inferiore rispetto al nuovo articolo e conferma con l'utente il metodo di pagamento per il rimborso.
| 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? | |
| No | |
| Vuoi cambiare un altro ordine? | |
| Sì | |
| Potresti fornire le ultime 5 cifre dell'ID ordine che vuoi scambiare? | |
| 12346 | |
| Le ultime cinque cifre dell\'ID ordine che abbiamo ricevuto sono 12346, giusto? | |
| Sì | |
| Bene, abbiamo finito di raccogliere l'ID ordine. Abbiamo trovato alcuni prodotti idonei nel tuo ordine. Indicaci quale prodotto vuoi cambiare. Prodotto 1: borraccia Google, prodotto 2: t-shirt Google. Di' o inserisci il numero del prodotto dell'articolo che vuoi selezionare oppure di' Avanti per visualizzare altri prodotti. |
|
| Due | |
| Per la verifica, ti interessa scambiare la t-shirt Google con uno scambio. È corretto? | |
| Sì | |
| Specifica il motivo della sostituzione. Potresti dire qualcosa del tipo: articolo difettoso o non funzionante, problema di taglia o vestibilità, problema con l'ordine incompleto, problema con lo stile, colore errato o altro. | |
| Problema di taglia o vestibilità | |
| Grazie per averci comunicato il motivo della sostituzione. Puoi dirci la taglia con cui vorresti effettuare lo scambio? Sono disponibili le seguenti taglie: Di' 1 per small. Dì 2 per medio. Di' 3 per large. Di' 4 per XL. Di' 5 per doppia XL. |
|
| 1 | |
| Come ultimo passaggio, come vuoi scambiare il prodotto? Puoi dire, ad esempio: "Ritira in un negozio" o "Pianifica il ritiro". | |
| Programma il ritiro | |
| Perfetto. Abbiamo inviato un'etichetta di spedizione al numero di telefono e all'indirizzo email registrati. Stampalo e allegalo al pacco. Il nostro team ti contatterà nelle prossime 24-48 ore per pianificare un ritiro. Una volta ricevuto l'articolo nel nostro magazzino, saranno necessari da 3 a 5 giorni lavorativi prima che il rimborso dell'operazione di scambio venga visualizzato nel tuo account. Il prodotto sostituito ha un valore inferiore e hai diritto a un rimborso di 5 $. Facci sapere dove vuoi ricevere il rimborso. Puoi dire, ad esempio, credito dello Store o account di origine. |
|
| Credito dello Store | |
| Grazie per aver verificato che vuoi che il rimborso venga restituito al tuo portafoglio. Vuoi cambiare un altro ordine? |
|
| no | |
| Grazie per aver chiamato. |
Ordine non idoneo
L'utente finale è stato precedentemente autenticato. L'agente controlla le più recenti rileva che non ci sono prodotti idonei alla sostituzione. 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 idonei alla sostituzione nell'ordine più recente. Vuoi cambiare un altro ordine? |
|
| sì | |
| Potresti fornire le ultime 5 cifre dell\'ID ordine che vuoi cambiare? | |
| 23487 | |
| Le ultime cinque cifre dell\'ID ordine che abbiamo ricevuto sono 23487, giusto? | |
| sì | |
| Bene, abbiamo finito di raccogliere l'ID ordine. | |
| Spiacenti, non sono presenti prodotti nel tuo ordine idonei per lo scambio in base alle nostre norme. Puoi trovare ulteriori informazioni in merito alle nostre norme sulla piattaforma di scambio sul nostro sito web. Vuoi scambiare un altro ordine? |
|
| no | |
| Grazie per aver chiamato. |
Convenzioni di denominazione
Questo componente predefinito utilizza le seguenti convenzioni di denominazione:
| Funzionalità | Formato | Esempio |
|---|---|---|
| Flusso | [Nome componente] | Stato dell'ordine |
| 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 di per determinare il comportamento del componente. I parametri con ambito a livello di flusso devono da impostare nella pagina iniziale del componente. Con ambito sessione possono essere impostati da un flusso di chiamata o all'inizio pagina di questo componente.
Questo componente predefinito accetta i seguenti parametri di input:
| Nome parametro | Descrizione | Formato di 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) Il 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 | 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 nuovi tentativi consentiti fornendo le ultime cinque cifre di un numero dell'ordine. Il valore predefinito è 3. |
integer |
| $flow.max_retry_another_order | Specifica il numero di nuovi tentativi consentiti durante la selezione di un altro ordine per il reso nei casi in cui l'ID ordine non sia trovato o l'ordine non sia idoneo per lo scambio. 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_retry_exchange_reason | Specifica il numero di tentativi consentiti quando fornisci il motivo dello scambio. Il valore predefinito è 3. |
integer |
| $flow.max_retry_exchange_reason_counter | Specifica il numero di tentativi consentiti per 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 nell'intera conversazione. Il valore predefinito è 9. |
integer |
| $flow.max_product_exchange_confirm | Specifica il numero massimo di nuovi 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 quando si seleziona un prodotto da cambiare. Il valore predefinito è 3. |
integer |
| $flow.max_retry_select_quantity | Specifica il numero massimo di nuovi 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 nuovi tentativi consentiti quando si seleziona la dimensione da scambiare. 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.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 tentativi consentiti quando si seleziona 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 è 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 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_exchange_order_refund_mode che indica che l'utente ha selezionato 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 di pianificare un ritiro per lo scambio. Il valore predefinito è scheduled_for_pickup. |
string |
Per configurare i parametri di input 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 Crea.
- Fai clic sul componente importato nella sezione Flussi.
- Fai clic sulla home page nella sezione Pagine.
- Fai clic su true nella pagina iniziale.
- Nella finestra Route, modifica i valori di Parameter Presets 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 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 identificarlo. | 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 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 determinato momento durante la 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 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 di mancata 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: un URL webhook non era raggiungibile. Vedi webhook.error.not-found-in-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 scambi, tra cui:
- Esiste una scadenza per la procedura di reso?
- Posso scambiare un articolo del 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, dovrai 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 dell'autenticazione, dovrai configurarle per abilitare l'autenticazione 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_exchange_order: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 | Data di effettuazione dell'ordine, in formato YYYY-MM-DD. |
string |
| order_product_count | Il numero di prodotti univoci in un ordine. | integer |
| order_payment_mode | Indica la modalità di pagamento utilizzata al momento dell'ordine. | string |
| exchangeable_product_id | Elenco di ID prodotto per i prodotti scambiabili 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 scambiabili all'interno dell'ordine. | Elenco (stringa) |
| exchangeable_product_quantity | Elenco delle quantità dei prodotti scambiabili nell'ordine. | Elenco (stringa) |
| exchangeable_product_price | Elenco dei prezzi dei prodotti scambiabili 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_exchange_order: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, in quanto sono richiesti dal componente per accedere i valori dei campi restituiti.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Ottenere 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 di 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 d'ordine condivisi tra uno o più ordini dell'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 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 dei tempi di ordine per gli 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 di Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook precompilato_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, in quanto sono richiesti dal componente per accedere i valori dei campi restituiti.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Ottenere le dimensioni della piattaforma di scambio pubblicitario disponibili
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 voglia cambiare un articolo a causa di problemi di taglia o vestibilità.
Parametri di richiesta API
I seguenti parametri vengono forniti dal componente come input alla richiesta dell'API.
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $flow.selected_order_product_id | L'ID del prodotto che l'utente vuole cambiare. | 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 taglie disponibili per il prodotto selezionato. | Elenco (stringa) |
Per configurare il webhook Ottieni dimensioni della piattaforma di scambio disponibili 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_exchange_order:get_available_exchange_size.
- 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 corretto dal 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, in quanto sono richiesti dal componente per accedere i valori dei campi restituiti.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Vedere la disponibilità della piattaforma di scambio pubblicitario dei prodotti
prebuilt_components_exchange_order:get_product_exchange_availability
webhook viene utilizzato dal componente per verificare se il prodotto selezionato dall'utente,
la quantità e la taglia facoltativa
sono disponibili per la sostituzione.
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 |
| $flow.selected_order_product_id | L'ID del prodotto che l'utente vuole cambiare. | string |
| $flow.order_product_quantity_exchange_count | Quantità del prodotto che l'utente vuole cambiare. | integer |
| $flow.product_selected_size | Taglia del prodotto che l'utente vuole sostituire. | 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 scambio per un singolo articolo del prodotto e della taglia selezionati. | numero |
Per configurare il webhook per ottenere la disponibilità della piattaforma di scambio dei prodotti 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_Exchange_order:get_product_Exchange_availability.
- 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, in quanto sono richiesti dal componente per accedere i valori dei campi restituiti.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Genera ticket con ordine incompleto
Il webhook prebuilt_components_exchange_order:raise_incomplete_order_ticket viene utilizzato dal componente per creare un ticket quando l'utente vuole cambiare un prodotto all'interno di un ordine perché incompleto.
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 identificare l'utente. | string |
| $flow.order_id | ID ordine per il quale inviare un ticket. | string |
| $flow.selected_order_product_id | L'ID del prodotto che l'utente vuole cambiare. | string |
| $flow.order_product_quantity_exchange_count | Quantità del prodotto che l'utente vuole cambiare. | integer |
| $flow.order_product_exchange_reason | Il motivo per cui l'utente vuole cambiare il prodotto. | string |
Per configurare il webhook per creare un ticket di ordine incompleto 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_exchange_order:raise_incomplete_order_ticket.
- 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, in quanto sono richiesti dal componente per accedere i valori dei campi restituiti.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Ottieni i dettagli del negozio
Il webhook prebuilt_components_exchange_order: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 l'webhook Get store details 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 il webhook predefinito_components_Exchange_order: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 corretto dal 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, in quanto sono richiesti dal componente per accedere i valori dei campi restituiti.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Dettagli della pubblicazione
Il webhook prebuilt_components_exchange_order:post_exchange_details viene utilizzato
dal componente per inviare uno scambio.
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 identificare l'utente. | string |
| $flow.order_id | ID ordine per il quale inviare un ticket. | string |
| $flow.selected_order_product_id | L'ID del prodotto che l'utente vuole cambiare. | string |
| $flow.order_product_quantity_exchange_count | Quantità del prodotto che l'utente vuole cambiare. | integer |
| $flow.product_selected_size | Taglia del prodotto che l'utente vuole sostituire. | string |
| $flow.order_product_exchange_reason | Il motivo per cui l'utente vuole cambiare il prodotto. | string |
| $flow.order_exchange_location | La modalità selezionata per la piattaforma di scambio pubblicitario. I valori validi sono definiti dall'entità prebuilt_components_exchange_order_location. |
string |
| $flow.order_exchange_store_id | L'ID del negozio selezionato dall'utente per una piattaforma di scambio pubblicitario. | 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 intercambiabile è 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 la piattaforma di scambio pubblicitario inviata. | string |
Per configurare l'webhook Post exchange details 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_Exchange_order:post_Exchange_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 corretto dal 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, in quanto sono richiesti dal componente per accedere i valori dei campi restituiti.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Invia informazioni sul rimborso COD
Il webhook prebuilt_components_exchange_order:send_COD_refund_information viene utilizzato dal componente per inviare a un utente i dati di pagamento relativi alla piattaforma di scambio pubblicitario.
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 identificare l'utente. | string |
| $flow.order_id | ID ordine per il quale 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 del COD 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_exchange_order: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, in quanto sono richiesti dal componente per accedere i valori dei campi restituiti.
- Esamina e aggiorna le impostazioni di 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.