Il componente predefinito per l'ordine di cambio controlla il livello di autenticazione dell'utente. Dopo aver autenticato l'utente, il componente fornisce informazioni sugli ordini più recenti o passati dell'utente. L'utente può quindi scegliere di cambiare più articoli di un ordine e selezionare opzioni tra cui i metodi di rimborso e spedizione.
Questo componente ti consente di utilizzare il componente predefinito Autenticazione per la vendita al dettaglio per autenticare gli utenti. Il componente utilizza anche i 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 i dati.
Finestre di dialogo di esempio
Le seguenti finestre di dialogo di esempio mostrano scenari comuni gestiti da questo componente predefinito. Illustrano cosa succede quando la telefonia avvia il componente, 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 è già autenticato.
- L'agente conferma quali articoli dell'ordine più recente devono essere sostituiti e raccoglie il motivo della sostituzione.
- L'utente seleziona l'opzione per cambiare gli articoli in un negozio.
- L'agente fornisce un elenco dei negozi più vicini.
- L'utente seleziona un negozio.
- L'agente genera un'etichetta spedizione che viene inviata ai canali registrati dell'utente.
| Input utente | Risposta dell'agente |
|---|---|
| Stai chiamando per il tuo ordine più recente con numero che termina con 12375 contenente 2 lampade, 2 Pixel e altri 10 prodotti effettuato il 10/11/2023? | |
| sì | |
| Abbiamo trovato alcuni prodotti idonei nel tuo ordine. Comunicaci quale prodotto vuoi sostituire. Prodotto 1: lampada Google, Prodotto 2: Google Pixel, Prodotto 3: spia 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 della sostituzione. Ad esempio, puoi dire: 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 vuoi sostituire il prodotto? Ad esempio, puoi dire: "Cambio in un negozio" o "Programma per il ritiro". |
|
| Voglio effettuare un cambio in un negozio | |
| Possiamo trovare un negozio nelle vicinanze. | |
| 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, US. Indirizzo 2: Google California, 19510 Jamboree Road, Irvine, California 92612, US. Pronuncia o inserisci il numero dell'indirizzo che vuoi selezionare oppure di' "Avanti" per visualizzare altri indirizzi dei negozi. |
|
| Il primo negozio | |
| Per confermare, hai selezionato Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, US. È corretto? | |
| sì | |
| Perfetto. Abbiamo inviato un'etichetta spedizione e un numero di ticket al tuo numero di telefono e al tuo indirizzo email registrati. Stampala, applicala al pacco e spedisci il dispositivo da sostituire entro 30 giorni. Una volta ricevuto l'articolo presso il nostro magazzino, saranno necessari da 3 a 5 giorni lavorativi prima che l'eventuale cambio venga visualizzato nel tuo account. L'importo del rimborso non include i costi 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 tuo numero di cellulare registrato. Effettua il pagamento entro 24 ore per richiedere la permuta. Vuoi permutare un altro ordine? |
|
| no, è tutto | |
| Grazie per aver chiamato. |
Rimborso per differenza di prezzo
- L'utente è già autenticato.
- L'agente raccoglie il numero dell'ordine, il prodotto da sostituire e il motivo della sostituzione.
- L'utente sceglie di sostituire gli articoli con una taglia diversa e programma un ritiro.
- L'agente identifica che l'articolo sostituito 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 |
|---|---|
| Stai chiamando per il tuo ordine più recente che termina con 12345 contenente 2 lampade effettuato il 10/11/2023? | |
| No | |
| Vuoi cambiare un altro ordine? | |
| Sì | |
| Puoi fornire le ultime cinque cifre dell'ID ordine che vuoi sostituire? | |
| 12346 | |
| Le ultime cinque cifre dell'ID ordine che abbiamo ricevuto sono 12346, è corretto? | |
| Sì | |
| Ottimo, abbiamo raccolto l'ID ordine. Abbiamo trovato alcuni prodotti idonei nel tuo ordine. Comunicaci quale prodotto vuoi sostituire. 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, vuoi cambiare la t-shirt di Google. È corretto? | |
| Sì | |
| Specifica il motivo della sostituzione. Puoi dire qualcosa come: 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 della permuta. Puoi indicarci la taglia con cui vorresti effettuare il cambio? Abbiamo le seguenti taglie disponibili: Di' 1 per la S. Di' 2 per la M. Di' 3 per la L. Di' 4 per la XL. Di' 5 per la XXL. |
|
| 1 | |
| Come ultimo passaggio, come vorresti sostituire il prodotto? Puoi dire qualcosa come: "Cambio in un negozio" o "Programma il ritiro". | |
| Programma il ritiro | |
| Perfetto. Abbiamo inviato un'etichetta spedizione al tuo numero di telefono e al tuo indirizzo email registrati. Stampala e attaccala al pacco. Il nostro team ti contatterà entro le prossime 24-48 ore per programmare un ritiro. Una volta ricevuto l'articolo presso il nostro magazzino, saranno necessari da 3 a 5 giorni lavorativi prima che il rimborso per la sostituzione venga visualizzato sul tuo conto. Il prodotto sostituito ha un valore inferiore e hai diritto a un rimborso di 5 $. Facci sapere dove vuoi ricevere il rimborso. Puoi dire qualcosa come "credito dello Store" o "account di origine". |
|
| credito dello Store | |
| Grazie per aver confermato che vuoi che il rimborso venga accreditato sul tuo wallet. Vuoi cambiare un altro ordine? |
|
| no | |
| Grazie per aver chiamato. |
Ordine non idoneo
- L'utente ha eseguito l'autenticazione 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 rileva che l'ordine fornito non contiene prodotti idonei.
| Input utente | Risposta dell'agente |
|---|---|
| Non abbiamo trovato prodotti idonei alla sostituzione nel tuo ordine più recente. Vuoi sostituire un altro ordine? |
|
| sì | |
| Puoi fornire le ultime cinque cifre dell'ID ordine che vuoi sostituire? | |
| 23487 | |
| Le ultime cinque cifre dell'ID ordine che abbiamo ricevuto sono 23487, è corretto? | |
| sì | |
| Ottimo, abbiamo finito di raccogliere l'ID ordine. | |
| Spiacenti, nel tuo ordine non sono presenti prodotti idonei alla sostituzione in base alle nostre norme. Puoi trovare ulteriori 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 configurano determinati comportamenti del componente. Una o più condizioni all'interno del flusso utilizzano questi parametri per determinare il comportamento del componente. Devi impostare i parametri con ambito di flusso nella pagina iniziale del componente, come descritto di seguito. Puoi impostare i parametri con ambito sessione utilizzando 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) Gli ID ordine associati all'utente autenticato, ordinati in base alla data di invio dell'ordine in ordine decrescente. Il primo elemento dell'array rappresenta l'ordine più recente. Se l'utente autenticato non ha ordini, il valore di questo parametro è null. |
Elenco (stringa) |
| $session.params.email | (Facoltativo) L'indirizzo email registrato con l'account. | string |
| $session.params.user_first_name | (Facoltativo) Il nome dell'utente, utilizzato per salutare e confermare la proprietà dell'account. | string |
Questo componente predefinito consente di configurare parametri facoltativi per controllare il comportamento del componente, inclusi i nuovi tentativi.
| Nome parametro | Descrizione | Formato |
|---|---|---|
| $flow.max_retry_another_account | Specifica il numero di nuovi 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 si forniscono le ultime cinque cifre di un numero d'ordine. Il valore predefinito è 3. |
integer |
| $flow.max_retry_another_order | Specifica il numero di nuovi tentativi consentiti quando si seleziona un altro ordine per il reso nei casi in cui l'ID ordine non viene trovato o l'ordine non è idoneo per il cambio. Il valore predefinito è 2. |
integer |
| $flow.max_retry_select_order_number | Specifica il numero di tentativi consentiti per fornire 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 della sostituzione. Il valore predefinito è 3. |
integer |
| $flow.max_retry_exchange_reason_counter | Specifica il numero di nuovi tentativi consentiti per la conferma del 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 il motivo di cambio "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 nel corso dell'intera conversazione. Il valore predefinito è 9. |
integer |
| $flow.max_product_exchange_confirm | Specifica il numero massimo di nuovi tentativi consentiti per 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 scambiare. Il valore predefinito è 3. |
integer |
| $flow.max_retry_select_quantity | Specifica il numero massimo di tentativi consentiti quando si seleziona la 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 nuovi tentativi consentiti quando si fornisce 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 store da presentare nel corso dell'intera conversazione. Il valore predefinito è 10. |
integer |
| $flow.max_retry_store_number_counter | Specifica il numero massimo di nuovi tentativi consentiti quando si seleziona un archivio. Il valore predefinito è 2. |
integer |
| $flow.max_retry_store_selection | Specifica il numero di nuovi tentativi consentiti per 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 alla consegna (COD). Il valore predefinito è "COD". |
string |
| $flow.order_payment_mode_store_credit | Specifica il valore del campo order_payment_mode restituito dal webhook get_order_details che indica un metodo di pagamento con credito dello Store. Il valore predefinito è "store_credit". |
string |
| $flow.order_refund_mode_source_account | Specifica il valore dell'entità prebuilt_components_exchange_order_refund_mode che indica che l'utente ha scelto di ricevere 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 programmare un ritiro per il cambio. 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 Build.
- Fai clic sul componente importato nella sezione Flussi.
- Fai clic sulla pagina iniziale nella sezione Pagine.
- Fai clic sulla route true nella pagina iniziale.
- Nella finestra Route (Percorso), modifica i valori di Parameter Presets (Preset dei parametri) in base alle tue esigenze.
- Fai clic su Salva.
Parametri di output
I parametri di output sono parametri di sessione che rimangono attivi dopo l'uscita dal componente. Questi parametri contengono informazioni importanti raccolte dal componente.
Questo componente predefinito fornisce 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 | Gli ID ordine associati all'utente autenticato, ordinati in base alla data di invio dell'ordine in ordine decrescente. Il primo elemento dell'array rappresenta l'ordine più recente. Se l'utente autenticato 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 | Indica il motivo per cui il flusso è stato chiuso, se non è andato a buon fine. Il valore restituito è uno dei seguenti:agent: l'utente ha richiesto un agente umano in un momento della conversazione.denial_of_information: l'utente ha rifiutato di condividere le informazioni richieste dal componente.max_no_input: la conversazione ha raggiunto il numero massimo di nuovi tentativi per gli eventi di assenza di input. Consulta gli eventi integrati di assenza di input.max_no_match: la conversazione ha raggiunto il numero massimo di nuovi tentativi per gli eventi di mancata corrispondenza. Consulta gli eventi integrati no-match.webhook_error: si è verificato un errore del webhook. Consulta l'evento integrato webhook.error. webhook_not_found: un URL webhook non era raggiungibile. Consulta l'evento integrato webhook.error.not-found. |
string |
Generatori
Questo componente utilizza i generatori per consentirti di attivare parti specifiche della conversazione.
Domande frequenti
Il generatore FAQ gestisce le domande frequenti su resi e cambi, tra cui:
- Esiste una scadenza per la procedura di reso?
- È possibile cambiare un articolo regalo?
- Il prezzo del prodotto e l'importo del rimborso sono diversi. Perché?
Riassunto
Il generatore Summarization crea un riepilogo post-chiamata che descrive la conversazione gestita dal componente.
Impostazione di base
Configura questo componente predefinito completando i seguenti passaggi:
- Importa il componente predefinito.
- Configura i webhook flessibili forniti con la configurazione che descrive i tuoi servizi esterni. Consulta Configurazione dei webhook.
Configurazione del webhook
Per utilizzare questo componente, configura 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 l'autenticazione, configurali per abilitare l'autenticazione degli utenti per questo componente. Per saperne di più, consulta la documentazione sulla configurazione del webhook di autenticazione di Retail.
Ottieni i dettagli dell'ordine
Il componente utilizza il webhook prebuilt_components_exchange_order:get_order_details per recuperare i dettagli di un ordine specificato.
Parametri di richiesta API
Il componente fornisce i seguenti parametri come input per la richiesta API:
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $flow.order_id | L'ID ordine per cui recuperare i dettagli. | string |
Parametri di risposta dell'API
Il componente recupera i seguenti parametri dalla risposta dell'API:
| 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 nell'ordine. | integer |
| order_payment_mode | Indica la modalità di pagamento utilizzata per l'ordine. | string |
| exchangeable_product_id | Un elenco di ID prodotto per i prodotti scambiabili all'interno dell'ordine. | Elenco (stringa) |
| exchangeable_product_name | Un elenco di nomi di prodotti scambiabili all'interno dell'ordine. | Elenco (stringa) |
| exchangeable_product_brand_name | Un elenco di nomi di brand per i prodotti sostituibili all'interno dell'ordine. | Elenco (stringa) |
| exchangeable_product_quantity | Un elenco di quantità per i prodotti scambiabili all'interno dell'ordine. | Elenco (stringa) |
| exchangeable_product_price | Un elenco di 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 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 formare il formato di richiesta appropriato per il 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.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Ottieni i dettagli dell'ordine duplicato
Il componente utilizza il webhook prebuilt_components_retail_services:get_duplicate_order_details per recuperare informazioni dettagliate che ti consentono di distinguere gli ordini quando più numeri d'ordine hanno le stesse ultime cinque cifre.
Parametri di richiesta API
Il componente fornisce i seguenti parametri come input per la richiesta API:
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $flow.duplicate_order_id | Un 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
Il componente recupera i seguenti parametri dalla risposta dell'API:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| all_order_date | Un elenco di date degli ordini duplicati con le ultime cinque cifre specificate nel formato YYYY-MM-DD. Ogni elemento di questo array corrisponde allo stesso elemento nell'array all_order_time. |
Elenco (stringa) |
| all_order_time | Un 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 nell'array all_order_date. |
Elenco (stringa) |
Per configurare il webhook Recupera i dettagli dell'ordine duplicato 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 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 formare il formato di richiesta appropriato per il 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.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Ottieni la dimensione di scambio disponibile
Il webhook prebuilt_components_exchange_order:get_available_exchange_size consente al componente di recuperare le taglie disponibili per il cambio se l'utente vuole cambiare un articolo a causa di problemi di taglia o vestibilità.
Parametri di richiesta API
Il componente fornisce i seguenti parametri 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
Il componente recupera i seguenti parametri dalla risposta dell'API:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| product_available_sizes | Un elenco delle taglie disponibili per il prodotto selezionato. | Elenco (stringa) |
Per configurare il webhook Recupera la dimensione di scambio disponibile 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_available_exchange_size.
- Sostituisci l'URL nel campo URL webhook di 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 formare il formato di richiesta appropriato per il 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.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Verifica la disponibilità della sostituzione del prodotto
Il webhook prebuilt_components_exchange_order:get_product_exchange_availability consente al componente di verificare se il prodotto, la quantità e la taglia selezionati dall'utente sono disponibili per il cambio.
Parametri di richiesta API
Il componente fornisce i seguenti parametri come input per la richiesta API:
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $flow.order_id | L'ID ordine per cui 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 | La quantità del prodotto che l'utente vuole cambiare. | integer |
| $flow.product_selected_size | La taglia del prodotto che l'utente vuole cambiare. | string |
Parametri di risposta dell'API
Il componente recupera i seguenti parametri dalla risposta dell'API:
| 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 permuta per un singolo articolo del prodotto e della taglia selezionati. | numero |
Per configurare il webhook Ottieni disponibilità per il cambio del prodotto 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_product_exchange_availability.
- Sostituisci l'URL nel campo URL webhook di 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 formare il formato di richiesta appropriato per il 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.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Crea ticket per ordine incompleto
Il componente utilizza il webhook prebuilt_components_exchange_order:raise_incomplete_order_ticket per generare un ticket quando un utente vuole cambiare un prodotto all'interno di un ordine perché l'ordine è incompleto.
Parametri di richiesta API
Il componente fornisce i seguenti parametri 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 | L'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 | La 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 Raise incomplete order ticket 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 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 formare il formato di richiesta appropriato per il 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.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Ottieni i dettagli dello store
Il webhook prebuilt_components_exchange_order:get_store_details consente al componente di recuperare l'elenco dei negozi vicini al codice postale fornito dall'utente.
Parametri di richiesta API
Il componente fornisce i seguenti parametri come input per la richiesta API:
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $flow.zip_code | Codice postale per cercare i negozi vicini. | string |
Parametri di risposta dell'API
Il componente recupera i seguenti parametri dalla risposta dell'API:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| store_id | Un elenco di ID negozio. | Elenco (stringa) |
| store_address | Un 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 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 formare il formato di richiesta appropriato per il 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.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Dettagli post-scambio
Il componente utilizza il webhook prebuilt_components_exchange_order:post_exchange_details per inviare uno scambio.
Parametri di richiesta API
Il componente fornisce i seguenti parametri 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 | L'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 | La quantità del prodotto che l'utente vuole cambiare. | integer |
| $flow.product_selected_size | La taglia del prodotto che l'utente vuole cambiare. | 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 un cambio in 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 permutabile è superiore a quello del nuovo prodotto. Se non è richiesto alcun rimborso, questo valore è null. |
integer |
Parametri di risposta dell'API
Il componente recupera i seguenti parametri dalla risposta dell'API:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| order_exchange_ticket_id | L'ID ticket della permuta inviata. | string |
Per configurare il 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 prebuilt_components_exchange_order:post_exchange_details.
- Sostituisci l'URL nel campo URL webhook di 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 formare il formato di richiesta appropriato per il 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.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Invia i dati per il rimborso del pagamento in contanti alla consegna
Il webhook prebuilt_components_exchange_order:send_COD_refund_information consente al componente di inviare all'utente informazioni di pagamento relative allo scambio.
Parametri di richiesta API
Il componente fornisce i seguenti parametri 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 | L'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.
- 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 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 formare il formato di richiesta appropriato per il 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.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Completa
Il componente predefinito e i relativi webhook sono ora configurati e pronti per il test.