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 i 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 i dati.
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 l'utente
L'utente finale è stato autenticato in precedenza. L'utente chiede le 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 delle offerte. È corretto? | |
| sì | |
| Abbiamo trovato le seguenti offerte per te, ecco i dettagli: Offerta 1: ricevi uno sconto del 5% sull'abbigliamento, utilizza il codice APPARELS5, valido fino al 28 marzo 2024. Offerta 2: ricevi uno sconto del 15% sulla spesa, utilizza il codice GROCERY500, valido fino al 28 marzo 2024. Speriamo che queste offerte ti interessino. Hai domande su offerte o promozioni a cui possiamo rispondere? |
|
| È previsto un acquisto minimo per l'offerta di generi alimentari? | |
| 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 marzo 2024. Ci auguriamo di poterti fornire i dettagli di cui hai bisogno. Hai domande su offerte o promozioni a cui possiamo rispondere? |
|
| Hai delle offerte per l'elettronica? | |
| Certo! Ecco i dettagli dell'offerta: Offerta 1: usufruisci del 5% di sconto sui prodotti elettronici, utilizza il codice ELECTRIC5, valido fino al 28/03/2024. Offerta 2: ricevi il 15% di sconto sui prodotti elettronici, 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 numero di 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 segnala un problema con un codice coupon. L'agente raccoglie il codice coupon e fornisce all'utente i dettagli sull'utilizzo del codice coupon. L'utente conferma di avere un problema con il codice coupon e l'agente invia un ticket per segnalarlo.
| Input utente | Risposta dell'agente |
|---|---|
| Ti diamo il benvenuto. Vuoi scoprire 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. Puoi 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 richiede un valore di acquisto minimo di 100$ ed è valido fino al 28 marzo 2024. Assicurati che le condizioni, come il requisito di acquisto minimo, siano soddisfatte. Queste informazioni ti sono utili? |
|
| no | |
| Specifica il problema che stai riscontrando. Puoi dire qualcosa come "Il mio codice coupon non funziona" o "Il codice non funziona nella mia zona". | |
| Il codice coupon non funziona | |
| Per confermare, il problema relativo al codice coupon fornito è che il codice coupon non funziona. È corretto? | |
| sì | |
| Abbiamo aperto un ticket per segnalare il 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 vengono 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 di flusso devono essere impostati nella pagina iniziale del componente. I parametri con ambito sessione possono essere impostati da un flusso chiamante o nella pagina di avvio 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 codice paese, utilizzato per identificare l'utente. | 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_concern_type | Specifica il numero di nuovi tentativi consentiti quando l'utente seleziona se 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 nuovi tentativi consentiti quando viene fornita una categoria per ascoltare le offerte. Il valore predefinito è 2. |
integer |
| $flow.max_retry_another_coupon_code | Specifica il numero di nuovi 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 nuovi tentativi consentiti quando si fornisce il problema che l'utente sta riscontrando con un codice coupon. Il valore predefinito è 2. |
integer |
| $flow.max_retry_message_confirm_channel | Specifica il numero di nuovi tentativi consentiti quando fornisci 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 webhook get_coupon_code_details 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 webhook get_coupon_code_details che indica che il codice coupon è scaduto. Il valore predefinito è "expired". |
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 Build.
- Fai clic sul componente importato nella sezione Flussi.
- Fai clic sulla pagina iniziale nella sezione Pagine.
- Fai clic sul percorso 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 rimarranno attivi dopo l'uscita dal componente. Questi parametri contengono informazioni importanti raccolte dal componente. Questo componente predefinito fornisce i valori per i seguenti parametri di output:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| phone_number | Il numero di telefono locale dell'utente, senza il prefisso internazionale, utilizzato per identificare l'utente. | 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 momento 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 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 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 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 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 utilizzare 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 l'utente in base alle informazioni fornite dal webhook get_offers_details.
Dettagli su 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 webhook get_offers_details.
L'utente può chiedere informazioni sulle offerte di una categoria specifica o richiedere maggiori dettagli su offerte specifiche.
Domande frequenti su offerte e promozioni
Il generatore 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 notifiche sulle prossime offerte?
- Ci sono offerte disponibili esclusivamente in negozio o online?
- Con quale frequenza vengono aggiunte nuove offerte alla vostra piattaforma?
Domande frequenti su sconti e codici promozionali
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 pagamento?
- Cosa succede se 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. Consulta la sezione Configurazione dei webhook.
Configurazione del webhook
Per utilizzare questo componente, devi configurare i webhook flessibili inclusi per recuperare le informazioni necessarie dai tuoi servizi esterni.
Visualizza i dettagli delle offerte
Il webhook prebuilt_components_offers_and_deals:get_offers_details viene utilizzato dal componente per recuperare i dettagli sulle offerte generali e specifiche per l'utente.
Parametri di 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 cui 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 nell'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 i 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 l'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 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.
Visualizza 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 per il quale un utente ha segnalato problemi.
Parametri di 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 cui 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 validità del codice coupon, nel formato YYYY-MM-DD. |
string |
| minimum_order_value | Valore ordine minimo per il codice coupon. | string |
Per configurare il webhook Recupera i dettagli del codice coupon 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_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 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 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 di 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 prefisso internazionale, utilizzato per identificare l'utente. | string |
| $flow.confirmation_channel | Canale selezionato dall'utente 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 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 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 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
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 di 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 prefisso internazionale, utilizzato per identificare l'utente. | string |
| $flow.coupon_code | Codice coupon per il quale l'utente ha segnalato un problema. | string |
| $flow.offer_id | ID offerta per il codice coupon fornito. | string |
| $flow.coupon_code_issue | Il problema segnalato dall'utente relativo al codice coupon. | string |
Per configurare il webhook Crea 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 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 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
Ora l'agente e i suoi webhook dovrebbero essere configurati e pronti per essere testati.