Il componente predefinito dell'ordine di scambio controlla il livello di autenticazione di un utente. Una volta che l'utente è stato autenticato, il componente fornisce informazioni sugli ordini più recenti o passati dell'utente. L'utente può quindi scegliere di scambiare più articoli in un ordine e selezionare le opzioni, tra cui i metodi di rimborso e spedizione. Questo componente utilizza il componente predefinito Autenticazione retail per autenticare gli utenti. Il componente utilizza anche Generatori per il riassunto post-chiamata e le domande frequenti.
Limitazioni
Oltre alle limitazioni comuni dei componenti predefiniti, questo componente predefinito presenta le seguenti limitazioni:
- Questo componente non cripta i dati.
Finestre di dialogo di esempio
Le seguenti finestre di dialogo di esempio mostrano scenari comuni gestiti da questo componente predefinito. Le finestre di dialogo di esempio mostrano il comportamento quando il componente viene chiamato utilizzando la telefonia, che attiva l'intent di benvenuto predefinito e la prima risposta dell'agente all'inizio della conversazione.
Sostituzione in negozio con un articolo difettoso
L'utente finale è stato autenticato in precedenza. L'agente conferma gli articoli dell'ordine più recente da scambiare e raccoglie il motivo dello scambio. L'utente sceglie di scambiare gli articoli in un negozio e l'agente fornisce un elenco dei negozi più vicini. L'utente seleziona un negozio e l'agente genera un'etichetta di spedizione che viene inviata ai suoi canali registrati.
| Input utente | Risposta dell'agente |
|---|---|
| Stai chiamando in merito al tuo numero d'ordine più recente che termina con 12375, contenente 2 lampade, 2 Pixel e altri 10 prodotti effettuati il 10/11/2023? | |
| sì | |
| Abbiamo trovato alcuni prodotti idonei nel tuo ordine. Facci sapere quale prodotto vuoi scambiare. Prodotto 1: lampada Google, prodotto 2: Google Pixel, prodotto 3: luce LED di Google. Di' o inserisci il numero di prodotto dell'articolo che vuoi selezionare oppure di' accanto per mostrare altri prodotti. |
|
| 1 | |
| Per conferma: vuoi scambiare la lampada Google. È corretto? | |
| sì | |
| Possiamo vedere 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 di dimensioni o vestibilità, problema di ordine incompleto, problema di stile, colore errato, oppure dire altri. | |
| Articolo con problemi | |
| Grazie per averci informati. Come ultimo passaggio, come vorresti scambiare il prodotto? Ad esempio, puoi dire: Sostituzione in un negozio o Programma per il ritiro. |
|
| Voglio effettuare lo scambio in un negozio | |
| Troviamo un negozio nelle vicinanze. | |
| L'agente raccoglie il codice postale utilizzando il componente predefinito Raccolta codici postali | |
| Ecco l'elenco delle sedi vicine al codice postale inserito. Indirizzo 1: Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, Stati Uniti. Indirizzo 2: Google California, 19510 Jamboree Road, Irvine, California 92612, Stati Uniti. Di' o inserisci il numero dell'indirizzo che vuoi dire accanto al negozio da selezionare oppure altro. |
|
| Il primo negozio | |
| Per conferma: hai selezionato Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, Stati Uniti. È corretto? | |
| sì | |
| Perfetto. Abbiamo inviato un'etichetta di spedizione e un numero del biglietto al tuo numero di telefono e indirizzo email registrati. Stampalo e attaccalo al pacco, quindi consegna lo strumento di sostituzione entro 30 giorni. Una volta ricevuto l'articolo presso il nostro magazzino, saranno necessari da 3 a 5 giorni lavorativi prima che l'eventuale sostituzione venga visualizzata sul tuo conto. Nota: l'importo del rimborso escluderà le spese di spedizione e gestione. Il prodotto della sostituzione ha un valore superiore. La differenza di prezzo è di 20$. A breve riceverai il link di pagamento sul tuo numero di cellulare registrato. Effettua il pagamento entro 24 ore per effettuare lo scambio. Vuoi scambiare un altro ordine? |
|
| no, niente | |
| Grazie per aver chiamato. |
Rimborso per la differenza di prezzo
L'utente finale è stato autenticato in precedenza. L'agente raccoglie il numero dell'ordine, il prodotto da scambiare e il motivo dello scambio. L'utente sceglie di scambiare gli articoli con una taglia diversa e pianifica un ritiro. L'agente identifica che l'articolo scambiato abbia un prezzo inferiore a quello del nuovo e conferma all'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 posizionato il 10/11/2023? | |
| No | |
| Vuoi scambiare 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 ottenuto sono 12346, giusto? | |
| Sì | |
| Ottimo, abbiamo terminato la raccolta dell'ID ordine. Abbiamo trovato alcuni prodotti idonei nel tuo ordine. Facci sapere quale prodotto vuoi scambiare. Prodotto 1: bottiglia d'acqua google, prodotto 2: t-shirt google. Di' o inserisci il numero di prodotto dell'articolo che vuoi selezionare, oppure di' accanto per mostrare altri prodotti. |
|
| Due | |
| Per verificare, ti interessa scambiare la t-shirt Google con una sostituzione. È corretto? | |
| Sì | |
| Specifica il motivo dello scambio. Potresti dire ad esempio: Articolo difettoso o non funzionante, problema di dimensioni o vestibilità, problema di ordine incompleto, problema di stile, colore errato, oppure dire altri. | |
| Problema di dimensioni o adattabilità | |
| Grazie per averci fatto conoscere il motivo dello scambio. Puoi indicarci la taglia con cui vorresti effettuare il cambio? Sono disponibili le seguenti taglie: Di' 1 per Small. Di' 2 per Medium. Di' 3 per Large. Di' 4 per XL. Di' 5 per double-XL. |
|
| 1 | |
| Come ultimo passaggio, in che modo vorresti scambiare il prodotto? Ad esempio, puoi dire: Sostituzione in un negozio o Programma per il ritiro. | |
| Programma per il ritiro | |
| Perfetto. Abbiamo inviato un'etichetta di spedizione al tuo numero di telefono e email registrati. Stampalo e attaccalo al pacco. Il nostro team ti contatterà entro le prossime 24-48 ore per fissare un ritiro. Una volta ricevuto l'articolo presso il nostro magazzino, saranno necessari da 3 a 5 giorni lavorativi prima che il rimborso della sostituzione risulti sul tuo conto. Il prodotto scambiato ha un valore inferiore e hai diritto a un rimborso di 5 €. Facci sapere dove vuoi ricevere il rimborso. Prova a dire, ad esempio, credito dello Store o account di origine. |
|
| Credito dello Store | |
| Grazie per aver verificato di voler restituire il rimborso su Wallet. Vuoi scambiare 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 scopre che non ci sono prodotti idonei per la sostituzione. L'agente raccoglie un numero d'ordine dall'utente e scopre che l'ordine fornito non ha prodotti idonei.
| Input utente | Risposta dell'agente |
|---|---|
| Non abbiamo trovato alcun prodotto nel tuo ordine più recente idoneo per la sostituzione. Vuoi scambiare un altro ordine? |
|
| sì | |
| Potresti fornire le ultime 5 cifre dell'ID ordine che vuoi scambiare? | |
| 23487 | |
| Le ultime cinque cifre dell'ID ordine che abbiamo ricevuto sono 23487, giusto? | |
| sì | |
| Bene, abbiamo terminato la raccolta dell'ID ordine. | |
| Spiacenti, il tuo ordine non contiene prodotti idonei alla sostituzione in base alle nostre norme. Puoi trovare ulteriori informazioni in merito alle nostre norme sulla piattaforma di scambio pubblicitario 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:
| Selezione delle | Formato | Esempio |
|---|---|---|
| Flusso | [Nome componente] | Stato 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 del flusso per determinare il comportamento del componente. I parametri con ambito a flusso devono essere impostati nella pagina iniziale del componente. I parametri basati sulle sessioni possono essere impostati tramite un flusso di chiamata o nella pagina iniziale di questo componente.
Questo componente predefinito accetta i seguenti parametri di input:
| Nome parametro | Descrizione | Formato input |
|---|---|---|
| $session.params.phone_number | (Facoltativo) Numero di telefono locale dell'utente, senza il codice paese, utilizzato per identificare l'utente. | string |
| $session.params.all_recent_order_id | (Facoltativo) Questo parametro elenca gli ID ordine associati all'utente autenticato, ordinati in base alla data di posizionamento dell'ordine in ordine decrescente. Il primo elemento dell'array rappresenta l'ordine più recente. Se un utente non ha ordini, il valore di questo parametro è null. |
Elenco (stringa) |
| $session.params.email | (Facoltativo) L'indirizzo email registrato con l'account. | string |
| $session.params.user_first_name | (Facoltativo) Nome dell'utente, utilizzato per salutare e confermare la proprietà dell'account. | string |
Questo componente predefinito consente ai seguenti parametri facoltativi di configurare il comportamento del componente, compresi i nuovi tentativi.
| Nome parametro | Descrizione | Formato |
|---|---|---|
| $flow.max_retry_another_account | Specifica il numero di nuovi tentativi consentiti quando scegli se continuare con un account alternativo. Il valore predefinito è 3. |
integer |
| $flow.max_retry_order_number | Specifica il numero di nuovi tentativi consentiti quando fornisci le ultime cinque cifre di un numero d'ordine. Il valore predefinito è 3. |
integer |
| $flow.max_retry_another_order | Specifica il numero di nuovi tentativi consentiti quando viene selezionato un altro ordine per il reso nei casi in cui l'ID ordine non sia stato trovato o l'ordine non sia idoneo per la piattaforma di scambio pubblicitario. Il valore predefinito è 2. |
integer |
| $flow.max_retry_select_order_number | Specifica il numero di nuovi tentativi consentiti quando viene fornito il numero dell'ordine completo nei casi in cui più di un ordine condivida le ultime cinque cifre. Il valore predefinito è 2. |
integer |
| $flow.max_retry_exchange_reason | Specifica il numero di nuovi tentativi consentiti quando viene specificato il motivo della sostituzione. Il valore predefinito è 3. |
integer |
| $flow.max_retry_exchange_reason_counter | Specifica il numero di nuovi tentativi consentiti quando confermi il motivo della sostituzione. 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 un motivo di scambio "altri". 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 nuovi tentativi consentiti quando si seleziona un prodotto da scambiare. Il valore predefinito è 3. |
integer |
| $flow.max_retry_select_quantity | Specifica il numero massimo di nuovi tentativi consentiti per 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 durante la selezione della dimensione da scambiare. Il valore predefinito è 2. |
integer |
| $flow.max_retry_another_zip_code | Specifica il numero massimo di nuovi tentativi consentiti quando fornisci un codice postale. Il valore predefinito è 2. |
integer |
| $flow.max_store_display_counter | Specifica il numero massimo di negozi da presentare in un singolo turno. Il valore predefinito è 1. |
integer |
| $flow.max_store_display | Specifica il numero massimo di negozi da presentare nell'intera conversazione. Il valore predefinito è 10. |
integer |
| $flow.max_retry_store_number_counter | Specifica il numero massimo di nuovi tentativi consentiti quando viene selezionato un negozio. Il valore predefinito è 2. |
integer |
| $flow.max_retry_store_selection | Specifica il numero di nuovi tentativi consentiti quando confermi la selezione del negozio. Il valore predefinito è 3. |
integer |
| $flow.max_available_address_reselection_counter | Specifica il numero di nuovi tentativi consentiti quando confermi 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 scelto di pianificare il ritiro per la piattaforma di scambio pubblicitario. Il valore predefinito è scheduled_for_pickup. |
string |
Per configurare i parametri di input per questo componente, espandi per visualizzare le istruzioni.
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Crea.
- Fai clic sul componente importato nella sezione Flussi.
- Fai clic su Pagina iniziale nella sezione Pagine.
- Fai clic sul percorso true nella pagina iniziale.
- Nella finestra Route, modifica i valori in Parameter Presets (Preimpostazioni parametri) in base alle tue esigenze.
- Fai clic su Salva.
Parametri di output
I parametri di output sono parametri di sessione che rimarranno attivi dopo l'uscita dal componente. Questi parametri contengono importanti informazioni raccolte dal componente. Questo componente predefinito fornisce valori per i seguenti parametri di output:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| phone_number | Numero di telefono locale dell'utente senza il codice paese, utilizzato per identificare l'utente. | string |
| all_recent_order_id | Questo parametro elenca gli ID ordine associati all'utente autenticato, ordinati in base alla data di posizionamento dell'ordine in ordine decrescente. Il primo elemento dell'array rappresenta l'ordine più recente. Se un utente non ha ordini, il valore di questo parametro è null. |
Elenco (stringa) |
| L'indirizzo email registrato con l'account. | string | |
| user_first_name | Nome dell'utente, utilizzato per salutare e confermare la proprietà dell'account. | string |
| transfer_reason | Questo parametro indica il motivo dell'uscita dal flusso, se l'operazione non è riuscita. Il valore restituito è uno dei seguenti:agent: l'utente finale ha richiesto un agente umano a un certo punto della conversazione.denial_of_information: l'utente finale ha rifiutato di condividere le informazioni richieste dal componente.max_no_input: la conversazione ha raggiunto il numero massimo di nuovi tentativi per eventi senza input. Vedi gli eventi integrati senza input.max_no_match: la conversazione ha raggiunto il numero massimo di nuovi tentativi per gli eventi senza corrispondenza. Visualizza gli eventi integrati senza corrispondenza.webhook_error: si è verificato un errore relativo al webhook. Vedi l'evento integrato webhook.error. webhook_not_found: un URL webhook non è raggiungibile. Vedi l'evento integrato webhook.error.not-found. |
string |
generatori
Questo componente utilizza Generatori per abilitare parti specifiche della conversazione.
Domande frequenti
Il generatore FAQ viene utilizzato per gestire le domande frequenti su resi e scambi, tra cui:
- È prevista una scadenza per la procedura di reso?
- Posso cambiare un articolo regalo?
- Il prezzo del prodotto e l'importo del rimborso sono diversi. Perché?
Riassunto
Il generatore Summarization viene utilizzato per generare un riepilogo post-chiamata che descriva
la conversazione gestita dal componente.
Configurazione di base
Per configurare questo componente predefinito:
- Importa il componente predefinito.
- Configura i webhook flessibili forniti con una configurazione che descrive i servizi esterni di Dialogflow. Vedi Configurazione webhook.
Configurazione webhook
Per utilizzare questo componente, devi configurare i hook flessibili inclusi per recuperare le informazioni necessarie dai servizi esterni.
Autenticazione
Se non hai precedentemente configurato i servizi esterni richiesti per l'autenticazione, dovrai configurarli per abilitare l'autenticazione degli utenti per questo componente. Per istruzioni dettagliate, consulta Configurazione del webhook di autenticazione per la vendita al dettaglio.
Ottenere i dettagli dell'ordine
Il webhook prebuilt_components_exchange_order:get_order_details viene utilizzato dal componente per recuperare i dettagli di un ordine specificato.
Parametri delle richieste API
I seguenti parametri sono forniti dal componente come input per la richiesta API.
| Nome parametro | Descrizione | Formato input |
|---|---|---|
| $flow.order_id | ID ordine di cui recuperare i dettagli. | string |
Parametri di risposta dell'API
I seguenti parametri vengono estratti dalla risposta dell'API per essere utilizzati dal componente.
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| order_date | La data in cui è stato effettuato l'ordine, in formato YYYY-MM-DD. |
string |
| order_product_count | Il numero di prodotti univoci all'interno di un ordine. | integer |
| order_payment_mode | Indica la modalità di pagamento utilizzata per effettuare l'ordine. | string |
| exchangeable_product_id | Elenco di ID prodotto dei prodotti scambiabili all'interno dell'ordine. | Elenco (stringa) |
| exchangeable_product_name | Elenco di nomi di prodotti per i prodotti scambiabili all'interno dell'ordine. | Elenco (stringa) |
| exchangeable_product_brand_name | Elenco di nomi di brand per i prodotti scambiabili all'interno dell'ordine. | Elenco (stringa) |
| exchangeable_product_quantity | Elenco delle quantità per i prodotti scambiabili all'interno dell'ordine. | Elenco (stringa) |
| exchangeable_product_price | Elenco dei prezzi per i prodotti scambiabili all'interno dell'ordine. | Elenco (stringa) |
Per configurare il webhook Ottieni dettagli dell'ordine per questo componente, espandi per visualizzare le istruzioni.
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook prebuilt_components_exchange_order:get_order_details.
- Sostituisci l'URL nel campo URL webhook di Dialogflow con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo appropriato nel menu a discesa.
- Esamina e aggiorna il Corpo della richiesta in modo da formare il formato della richiesta corretto per il tuo webhook.
- Esamina e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, poiché sono richiesti dal componente per accedere ai valori dei campi restituiti.
- Rivedi e aggiorna le impostazioni di Autenticazione in base alle tue esigenze.
- Fai clic su Salva.
Ottenere dettagli dell'ordine duplicati
Il webhook prebuilt_components_retail_services:get_duplicate_order_details viene utilizzato dal componente per recuperare informazioni dettagliate in modo da distinguere tra ordini quando più numeri di ordine hanno le stesse ultime cinque cifre.
Parametri delle richieste API
I seguenti parametri sono forniti dal componente come input per la richiesta API.
| Nome parametro | Descrizione | Formato input |
|---|---|---|
| $flow.duplicate_order_id | Elenco contenente le ultime cinque cifre dei numeri degli ordini condivisi tra uno o più ordini per l'utente. | Elenco (stringa) |
Parametri di risposta dell'API
I seguenti parametri vengono estratti dalla risposta dell'API per essere utilizzati dal componente.
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| all_order_date | Elenco di date degli ordini duplicati con le ultime cinque cifre specificate in formato YYYY-MM-DD. Ogni elemento di questo array corrisponde allo stesso elemento dell'array all_order_time. |
Elenco (stringa) |
| all_order_time | Elenco degli orari degli ordini duplicati con le ultime cinque cifre specificate in formato HH:MM. Ogni elemento di questo array corrisponde allo stesso elemento dell'array all_order_date. |
Elenco (stringa) |
Per configurare il webhook Ottieni dettagli dell'ordine duplicati per questo componente, espandi per visualizzare le istruzioni.
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook prebuilt_components_retail_services:get_duplicate_order_details.
- Sostituisci l'URL nel campo URL webhook di Dialogflow con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo appropriato nel menu a discesa.
- Esamina e aggiorna il Corpo della richiesta in modo da formare il formato della richiesta corretto per il tuo webhook.
- Esamina e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, poiché sono richiesti dal componente per accedere ai valori dei campi restituiti.
- Rivedi e aggiorna le impostazioni di Autenticazione in base alle tue esigenze.
- Fai clic su Salva.
Visualizza le dimensioni di scambio disponibili
Il webhook prebuilt_components_exchange_order:get_available_exchange_size viene
utilizzato dal componente per recuperare le dimensioni disponibili per la sostituzione nei casi in cui
l'utente voglia sostituire un articolo a causa di problemi di dimensioni o adattabilità.
Parametri delle richieste API
I seguenti parametri sono forniti dal componente come input per la richiesta API.
| Nome parametro | Descrizione | Formato input |
|---|---|---|
| $flow.selected_order_product_id | L'ID 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 taglie disponibili per il prodotto selezionato. | Elenco (stringa) |
Per configurare il webhook di dimensioni della piattaforma di scambio disponibili per questo componente, espandi le istruzioni.
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook prebuilt_components_exchange_order:get_available_exchange_size.
- Sostituisci l'URL nel campo URL webhook di Dialogflow con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo appropriato nel menu a discesa.
- Esamina e aggiorna il Corpo della richiesta in modo da formare il formato della richiesta corretto per il tuo webhook.
- Esamina e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, poiché sono richiesti dal componente per accedere ai valori dei campi restituiti.
- Rivedi e aggiorna le impostazioni di Autenticazione in base alle tue esigenze.
- Fai clic su Salva.
Sapere la disponibilità della piattaforma di scambio pubblicitario
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 selezionata dall'utente sono disponibili per la sostituzione.
Parametri delle richieste API
I seguenti parametri sono forniti dal componente come input per la richiesta API.
| Nome parametro | Descrizione | Formato input |
|---|---|---|
| $flow.order_id | ID ordine di cui recuperare i dettagli. | string |
| $flow.selected_order_product_id | L'ID del prodotto che l'utente vuole scambiare. | string |
| $flow.order_product_quantity_exchange_count | La quantità del prodotto che l'utente vuole scambiare. | integer |
| $flow.product_selected_size | Le dimensioni del prodotto con cui 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 la sostituzione. | boolean |
| product_exchange_price | Indica il prezzo di cambio per un singolo articolo del prodotto e della taglia selezionati. | number |
Per configurare il webhook per la disponibilità della piattaforma di scambio dei prodotti per questo componente, espandi le istruzioni.
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook prebuilt_components_exchange_order:get_product_Exchange_availability_availability.
- Sostituisci l'URL nel campo URL webhook di Dialogflow con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo appropriato nel menu a discesa.
- Esamina e aggiorna il Corpo della richiesta in modo da formare il formato della richiesta corretto per il tuo webhook.
- Esamina e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, poiché sono richiesti dal componente per accedere ai valori dei campi restituiti.
- Rivedi e aggiorna le impostazioni di Autenticazione in base alle tue esigenze.
- Fai clic su Salva.
Aumenta ticket di ordinazione incompleto
Il webhook prebuilt_components_exchange_order:raise_incomplete_order_ticket
viene utilizzato dal componente per generare un ticket quando l'utente vuole scambiare un
prodotto all'interno di un ordine perché incompleto.
Parametri delle richieste API
I seguenti parametri sono forniti dal componente come input per la richiesta API.
| Nome parametro | Descrizione | Formato input |
|---|---|---|
| $session.params.phone_number | Numero di telefono locale dell'utente senza il codice paese, utilizzato per identificare l'utente. | string |
| $flow.order_id | ID ordine per cui inviare un ticket. | string |
| $flow.selected_order_product_id | L'ID del prodotto che l'utente vuole scambiare. | string |
| $flow.order_product_quantity_exchange_count | La quantità del prodotto che l'utente vuole scambiare. | integer |
| $flow.order_product_exchange_reason | Il motivo per cui l'utente vuole scambiare il prodotto. | string |
Per configurare il webhook di aumento del ticket dell'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 il webhook prebuilt_components_exchange_order:raise_incomplete_order_ticket.
- Sostituisci l'URL nel campo URL webhook di Dialogflow con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo appropriato nel menu a discesa.
- Esamina e aggiorna il Corpo della richiesta in modo da formare il formato della richiesta corretto per il tuo webhook.
- Esamina e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, poiché sono richiesti dal componente per accedere ai valori dei campi restituiti.
- Rivedi e aggiorna le impostazioni di Autenticazione in base alle tue esigenze.
- Fai clic su Salva.
Visualizza i dettagli dello store
Il webhook prebuilt_components_exchange_order:get_store_details viene utilizzato dal componente per recuperare l'elenco dei negozi vicini al codice postale fornito dall'utente.
Parametri delle richieste API
I seguenti parametri sono forniti dal componente come input per la richiesta API.
| Nome parametro | Descrizione | Formato input |
|---|---|---|
| $flow.zip_code | CAP per cercare negozi nelle vicinanze. | string |
Parametri di risposta dell'API
I seguenti parametri vengono estratti dalla risposta dell'API per essere utilizzati dal componente.
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| store_id | Elenco di ID negozio. | Elenco (stringa) |
| store_address | Elenco di indirizzi dei negozi corrispondenti a ogni elemento di store_id. |
Elenco (stringa) |
Per configurare il webhook Ottieni dettagli del negozio per questo componente, espandi per visualizzare le istruzioni.
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook prebuilt_components_exchange_order:get_store_details.
- Sostituisci l'URL nel campo URL webhook di Dialogflow con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo appropriato nel menu a discesa.
- Esamina e aggiorna il Corpo della richiesta in modo da formare il formato della richiesta corretto per il tuo webhook.
- Esamina e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, poiché sono richiesti dal componente per accedere ai valori dei campi restituiti.
- Rivedi e aggiorna le impostazioni di Autenticazione in base alle tue esigenze.
- Fai clic su Salva.
Dettagli post-scambio
Il webhook prebuilt_components_exchange_order:post_exchange_details viene utilizzato
dal componente per inviare una piattaforma di scambio pubblicitario.
Parametri delle richieste API
I seguenti parametri sono forniti dal componente come input per la richiesta API.
| Nome parametro | Descrizione | Formato input |
|---|---|---|
| $session.params.phone_number | Numero di telefono locale dell'utente senza il codice paese, utilizzato per identificare l'utente. | string |
| $flow.order_id | ID ordine per cui inviare un ticket. | string |
| $flow.selected_order_product_id | L'ID del prodotto che l'utente vuole scambiare. | string |
| $flow.order_product_quantity_exchange_count | La quantità del prodotto che l'utente vuole scambiare. | integer |
| $flow.product_selected_size | Le dimensioni del prodotto con cui l'utente vuole scambiare. | string |
| $flow.order_product_exchange_reason | Il motivo per cui l'utente vuole scambiare 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 negozio del negozio selezionato dall'utente per una piattaforma di scambio pubblicitario del negozio. | 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 scambiabile è 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 il webhook Post Exchange per questo componente, espandi le istruzioni.
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook prebuilt_components_exchange_order:post_exchange_details.
- Sostituisci l'URL nel campo URL webhook di Dialogflow con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo appropriato nel menu a discesa.
- Esamina e aggiorna il Corpo della richiesta in modo da formare il formato della richiesta corretto per il tuo webhook.
- Esamina e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, poiché sono richiesti dal componente per accedere ai valori dei campi restituiti.
- Rivedi e aggiorna le impostazioni di Autenticazione in base alle tue esigenze.
- Fai clic su Salva.
Invia informazioni sul rimborso COD
Il webhook prebuilt_components_exchange_order:send_COD_refund_information viene utilizzato dal componente per inviare a un utente dati di pagamento relativi alla piattaforma di scambio pubblicitario.
Parametri delle richieste API
I seguenti parametri sono forniti dal componente come input per la richiesta API.
| Nome parametro | Descrizione | Formato input |
|---|---|---|
| $session.params.phone_number | Numero di telefono locale dell'utente senza il codice paese, utilizzato per identificare l'utente. | string |
| $flow.order_id | ID ordine per cui inviare un ticket. | string |
| $flow.channel | Il canale specifico a cui inviare le informazioni. I valori validi sono definiti dall'entità prebuilt_components_channel_email_phone. Per impostazione predefinita sono supportati i criteri phone e email. |
string |
Per configurare il webhook Invia informazioni sul rimborso COD per questo componente, espandi per visualizzare le istruzioni.
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona l'agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook prebuilt_components_exchange_order:send_COD_refund_information.
- Sostituisci l'URL nel campo URL webhook di Dialogflow con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo appropriato nel menu a discesa.
- Esamina e aggiorna il Corpo della richiesta in modo da formare il formato della richiesta corretto per il tuo webhook.
- Esamina e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, poiché sono richiesti dal componente per accedere ai valori dei campi restituiti.
- Rivedi e aggiorna le impostazioni di Autenticazione in base alle tue esigenze.
- Fai clic su Salva.
Completi
L'agente e i relativi webhook dovrebbero essere configurati e pronti per i test.