Il componente predefinito offerte e promozioni verifica se il chiamante è un utente registrato. Se l'utente ha un account registrato, il componente può fornire informazioni su offerte e promozioni specifiche per l'utente. L'utente può anche ottenere dettagli su offerte e promozioni generali o segnalare problemi con un codice coupon specifico. Questo componente utilizza il componente predefinito Raccolta alfanumerica per raccogliere i codici coupon. Il componente utilizza anche Generatori per il riepilogo post-chiamata, le domande frequenti e i dettagli dell'offerta.
Limitazioni
Oltre alle limitazioni comuni dei componenti predefiniti, questo componente predefinito presenta le seguenti limitazioni:
- Questo componente non cripta alcun dato.
Esempi di dialoghi
Le seguenti finestre di dialogo di esempio mostrano scenari comuni gestiti da questo componente predefinito. Le finestre di dialogo di esempio mostrano il comportamento quando il componente viene chiamato tramite telefonia, il che attiva l'intent di benvenuto predefinito e la prima risposta dell'agente all'inizio della conversazione.
Offerte e promozioni generali e specifiche per gli utenti
L'utente finale è stato autenticato in precedenza. L'utente chiede le sue ultime offerte e l'agente presenta un elenco di offerte specifiche per l'utente. L'utente pone alcune domande sulle offerte, poi chiede offerte in una categoria specifica. L'agente presenta l'elenco delle offerte nella categoria. L'agente si offre di inviare i dettagli dell'offerta all'utente, che rifiuta.
| Input utente | Risposta dell'agente |
|---|---|
| Ti diamo il benvenuto. Vuoi scoprire le nostre ultime offerte o hai problemi con un codice coupon specifico? | |
| Voglio vedere le ultime offerte | |
| Per confermare, stai cercando offerte. È corretto? | |
| sì | |
| Abbiamo trovato le seguenti offerte per te. Ecco i dettagli: Offerta 1: ricevi il 5% di sconto su abbigliamento, utilizza il codice APPARELS5, valido fino al 28/03/2024. Offerta 2: ricevi il 15% di sconto su generi alimentari, utilizza il codice GROCERY500, valido fino al 28/03/2024.8. Ci auguriamo che queste offerte ti interessino. Hai domande su offerte o promozioni a cui possiamo rispondere? |
|
| È previsto un acquisto minimo per l'offerta per la spesa? | |
| Sì, è previsto un valore minimo di acquisto di 10 € per usufruire dello sconto del 15% sui prodotti alimentari. Utilizza il codice GROCERY500 per riscattare questa offerta, valida fino al 28/03/2024. Ci auguriamo di poterti fornire i dettagli che ti servono. Hai domande su offerte o promozioni a cui possiamo rispondere? |
|
| Avete offerte per l'elettronica? | |
| Certo. Ecco i dettagli dell'offerta: Offerta 1: usufruisci del 5% di sconto sull'elettronica, utilizza il codice ELECTRIC5, valido fino al 28/03/2024. Offerta 2: ricevi il 15% di sconto sull'elettronica, utilizza il codice ELECTRIC15, valido fino al 28/03/2024. Ci auguriamo di poterti fornire i dettagli di cui hai bisogno. Hai domande su offerte o promozioni a cui possiamo rispondere? |
|
| No, ho finito | |
| Vuoi che i dettagli dell'offerta vengano condivisi sul tuo cellulare o indirizzo email registrato? | |
| No, grazie | |
| Grazie per aver chiamato. |
Problema con un codice coupon
L'utente finale è stato autenticato in precedenza. L'utente afferma di avere un problema con un codice coupon. L'agente raccoglie il codice coupon e fornisce all'utente i dettagli sul suo utilizzo. L'utente conferma di avere un problema con il codice coupon e l'agente invia un ticket per segnalare il problema.
| Input utente | Risposta dell'agente |
|---|---|
| Ti diamo il benvenuto. Vuoi esplorare le nostre ultime offerte o hai problemi con un codice coupon specifico? | |
| Ho problemi con un codice coupon | |
| Per confermare, stai cercando codici coupon. È corretto? | |
| sì | |
| Ci spiace molto. Potresti condividere il codice coupon che stai utilizzando? | |
| L'agente raccoglie il codice coupon utilizzando il componente predefinito Raccolta alfanumerica | |
| Il codice offerta APPARELS5 associato all'abbigliamento richiedeva un valore di acquisto minimo di 100$ ed era valido fino al 28/03/2024. Assicurati che siano soddisfatte le condizioni, ad esempio il requisito di acquisto minimo. Queste informazioni ti sono utili? |
|
| no | |
| Specifica il problema che stai riscontrando. Potresti dire, ad esempio, che il tuo codice coupon non funziona o che non funziona nella tua zona. | |
| Il codice coupon non funziona | |
| Per conferma, il problema del codice coupon fornito è che il codice coupon non funziona. È corretto? | |
| sì | |
| Abbiamo creato un ticket per segnalare il tuo problema. Grazie per aver chiamato. |
Convenzioni di denominazione
Questo componente predefinito utilizza le seguenti convenzioni di denominazione:
| Funzionalità | Formato | Esempio |
|---|---|---|
| Flow | [Component Name] | Offerte e promozioni |
| Tipo di entità | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_offers_and_deals_category |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_offers_and_deals:get_offers_details |
Parametri di input
I parametri di input sono parametri utilizzati per configurare determinati comportamenti del componente. I parametri verranno utilizzati da una o più condizioni all'interno del flusso per determinare il comportamento del componente. I parametri con ambito flusso devono essere impostati nella pagina iniziale del componente. I parametri con ambito sessione possono essere impostati da un flusso di chiamata o nella pagina iniziale di questo componente.
Questo componente predefinito accetta i seguenti parametri di input:
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $session.params.phone_number | (facoltativo) Il numero di telefono locale dell'utente, senza il prefisso internazionale, utilizzato per identificare l'utente. | string |
Questo componente predefinito consente di configurare i seguenti parametri facoltativi del comportamento del componente, inclusi i tentativi.
| Nome parametro | Descrizione | Formato |
|---|---|---|
| $flow.max_retry_concern_type | Specifica il numero di tentativi consentiti quando si seleziona se l'utente vuole ascoltare le offerte o segnalare un problema con un codice coupon. Il valore predefinito è 2. |
integer |
| $flow.max_retry_offers_category | Specifica il numero di tentativi consentiti quando fornisci una categoria per ascoltare le offerte. Il valore predefinito è 2. |
integer |
| $flow.max_retry_another_coupon_code | Specifica il numero di tentativi consentiti quando viene fornito il codice coupon specifico con cui l'utente ha un problema. Il valore predefinito è 2. |
integer |
| $flow.max_retry_coupon_code_issue_counter | Specifica il numero di tentativi consentiti quando viene fornito il problema riscontrato dall'utente con un codice coupon. Il valore predefinito è 2. |
integer |
| $flow.max_retry_message_confirm_channel | Specifica il numero di tentativi consentiti quando viene fornito un canale per ricevere i dettagli dell'offerta. Il valore predefinito è 2. |
integer |
| $flow.valid_coupon_code_status | Specifica il valore del campo coupon_code_status restituito dal get_coupon_code_details webhook che indica che il codice coupon è valido. Il valore predefinito è "valid". |
string |
| $flow.invalid_coupon_code_status | Specifica il valore del campo coupon_code_status restituito dal webhook get_coupon_code_details che indica che il codice coupon non è valido. Il valore predefinito è "invalid". |
string |
| $flow.expired_coupon_code_status | Specifica il valore del campo coupon_code_status restituito dal get_coupon_code_details webhook che indica che il codice coupon è scaduto. Il valore predefinito è "expired". |
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 il tuo agente.
- Seleziona la scheda Crea.
- Fai clic sul componente importato nella sezione Flussi.
- Fai clic su Pagina iniziale nella sezione Pagine.
- Fai clic sulla route true nella pagina iniziale.
- Nella finestra Route, modifica i valori di Preset 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 informazioni importanti raccolte dal componente. Questo componente predefinito fornisce valori per i seguenti parametri di output:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| phone_number | Il numero di telefono locale dell'utente, senza il codice paese, utilizzato per identificare l'utente. | string |
| transfer_reason | Questo parametro indica il motivo per cui il flusso è stato interrotto, se non è andato a buon fine. Il valore restituito è uno dei seguenti:agent: l'utente finale ha richiesto un operatore umano a un certo punto della conversazione.denial_of_information: l'utente finale si è rifiutato di condividere le informazioni richieste dal componente.max_no_input: la conversazione ha raggiunto il numero massimo di tentativi per gli eventi senza input. Consulta gli eventi integrati senza input.max_no_match: la conversazione ha raggiunto il numero massimo di tentativi per gli eventi senza corrispondenza. Consulta eventi integrati senza corrispondenza.webhook_error: si è verificato un errore webhook. Vedi webhook.error evento integrato. webhook_not_found: un URL webhook non era raggiungibile. Vedi webhook.error.not-found evento integrato. |
string |
Generatori
Questo componente utilizza i Generatori per attivare parti specifiche della conversazione.
Riassunto
Il generatore Summarization viene utilizzato per generare un riepilogo post-chiamata che descrive
la conversazione gestita dal componente.
Domande frequenti di carattere generale
Il generatore di General FAQ viene utilizzato per gestire le domande frequenti relative
a sconti, vendite, acquisti e programmi fedeltà.
- Posso restituire i prodotti in promozione se cambio idea?
- Posso ricevere campioni o regali senza costi con l'acquisto di determinati prodotti?
- Offrite aggiustamenti di prezzo se l'articolo che ho acquistato viene messo in saldo in un secondo momento?
- Esiste un limite di tempo per riscattare i premi del programma fedeltà?
Dettagli dell'offerta specifici per l'utente
Il generatore User-specific offer details viene utilizzato per fornire dettagli sulle offerte specifiche per gli utenti in base alle informazioni fornite dal get_offers_details
webhook.
Dettagli di offerte e promozioni
Il generatore Offers and deals details viene utilizzato per fornire dettagli su
offerte e promozioni generali in base alle informazioni fornite dal get_offers_details
webhook.
L'utente può chiedere informazioni sulle offerte in una categoria specifica o maggiori dettagli su offerte specifiche.
Domande frequenti su offerte e promozioni
Il generatore di Offers and deals FAQ viene utilizzato per gestire le domande frequenti
relative a offerte e promozioni.
- Sono disponibili offerte speciali per i nuovi clienti?
- Come faccio a ricevere una notifica delle offerte in arrivo?
- Esistono offerte disponibili esclusivamente in negozio o online?
- Con quale frequenza vengono aggiunte nuove offerte alla tua piattaforma?
Domande frequenti su sconti e codici promozionali
L'Discount and promo code FAQ viene utilizzato per gestire le domande frequenti
relative a sconti e codici promozionali.
- Posso utilizzare un codice sconto più di una volta?
- Posso utilizzare più sconti per un singolo ordine?
- Come posso utilizzare un codice sconto durante il checkout?
- Cosa succede se mi dimentico di applicare un codice sconto durante il pagamento?
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. Per informazioni sulla configurazione dei webhook, consulta la sezione Configurazione dei webhook.
Configurazione webhook
Per utilizzare questo componente, devi configurare i webhook flessibili inclusi per recuperare le informazioni necessarie dai tuoi servizi esterni.
Visualizzare i dettagli delle offerte
Il webhook prebuilt_components_offers_and_deals:get_offers_details viene utilizzato
dal componente per recuperare i dettagli delle offerte specifiche per gli utenti e di quelle generali.
Parametri della richiesta API
I seguenti parametri vengono forniti dal componente come input per la richiesta API.
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $session.params.phone_number | Numero di telefono per recuperare i dettagli dell'offerta. | 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 |
|---|---|---|
| active_category | Elenco delle categorie di offerte disponibili per l'utente. I valori validi sono definiti dall'entità prebuilt_components_offers_and_deals_category. |
Elenco (stringa) |
| user_email | Email registrata per l'account fornito, utilizzata per inviare i dettagli dell'offerta. | string |
| user_offer | Elenco dei dettagli dell'offerta specifici per l'utente. Ogni elemento dell'elenco rappresenta una singola offerta, con coppie chiave-valore che descrivono diversi attributi dell'offerta, ad esempio {"valid_from": "2024-01-29", "sale_type": "none", "valid_until": "2024-03-28", "offer_id": "G5E0M2D7A6Y4W9S", "discount_value": "5%", "coupon_code": "ELECTRIC5", "is_redeem_allowed": "true", "minimum_order_value": "1000", "maximum_discount_amount": "200", "offer_category_name": "electronics"}. |
Elenco (oggetto) |
| all_offers | Elenco dei dettagli generali dell'offerta. Ogni elemento dell'elenco rappresenta una singola offerta, seguendo lo stesso formato del campo user_offer. |
Elenco (oggetto) |
Per configurare il webhook Get offers details per questo componente, espandi per visualizzare le istruzioni.
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona il tuo agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook prebuilt_components_offers_and_deals:get_offers_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 corretto nel menu a discesa.
- Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
- Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Visualizzare i dettagli del codice coupon
Il webhook prebuilt_components_offers_and_deals:get_coupon_code_details viene utilizzato
dal componente per recuperare i dettagli di un codice coupon specifico con cui un utente
ha segnalato problemi.
Parametri della richiesta API
I seguenti parametri vengono forniti dal componente come input per la richiesta API.
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $flow.coupon_code | Codice coupon per recuperare i dettagli. | string |
| $session.params.phone_number | Numero di telefono associato all'account dell'utente. | 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 |
|---|---|---|
| offer_id | ID offerta per il codice coupon. | string |
| offer_category_name | Categoria del codice coupon. I valori validi sono definiti dall'entità prebuilt_components_offers_and_deals_category. |
string |
| coupon_code_status | Stato del codice coupon. I valori validi sono definiti dai parametri di input $flow.valid_coupon_code_status, $flow.invalid_coupon_code_status e $flow.valid_coupon_code_status. |
string |
| valid_until | Data di scadenza del codice coupon, nel formato YYYY-MM-DD. |
string |
| minimum_order_value | Valore minimo dell'ordine per il codice coupon. | string |
Per configurare il webhook Ottieni dettagli codice coupon per questo componente, espandi per visualizzare le istruzioni.
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona il tuo agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook prebuilt_components_offers_and_deals:get_coupon_code_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 corretto nel menu a discesa.
- Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
- Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Invia messaggio
Il webhook prebuilt_components_offers_and_deals:send_message viene utilizzato
dal componente per inviare un messaggio contenente i dettagli dell'offerta al canale
selezionato dall'utente.
Parametri della richiesta API
I seguenti parametri vengono forniti dal componente come input per la richiesta API.
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $session.params.phone_number | Il numero di telefono locale dell'utente, senza il codice paese, utilizzato per identificare l'utente. | string |
| $flow.confirmation_channel | Il canale che l'utente ha selezionato per ricevere i dettagli dell'offerta. I valori validi sono definiti dall'entità prebuilt_components_channel_email_phone. |
string |
Per configurare il webhook Invia messaggio per questo componente, espandi per visualizzare le istruzioni.
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona il tuo agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook prebuilt_components_offers_and_deals:send_message.
- Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto nel menu a discesa.
- Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
- Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Aprire un ticket
Il webhook prebuilt_components_offers_and_deals:raise_ticket viene utilizzato
dal componente per inviare un ticket che segnala un problema dell'utente con un codice coupon.
Parametri della richiesta API
I seguenti parametri vengono forniti dal componente come input per la richiesta API.
| Nome parametro | Descrizione | Formato di input |
|---|---|---|
| $session.params.phone_number | Il numero di telefono locale dell'utente, senza il codice paese, utilizzato per identificare l'utente. | string |
| $flow.coupon_code | Codice coupon per cui l'utente ha segnalato un problema. | string |
| $flow.offer_id | ID offerta per il codice coupon fornito. | string |
| $flow.coupon_code_issue | Problema fornito dall'utente per il codice coupon. | string |
Per configurare il webhook Raise ticket per questo componente, espandi per visualizzare le istruzioni.
- Apri la console Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona il tuo agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook rebuilt_components_offers_and_deals:raise_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 corretto nel menu a discesa.
- Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
- Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
- Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
- Fai clic su Salva.
Completa
L'agente e i relativi webhook dovrebbero ora essere configurati e pronti per il test.