Il componente predefinito per le offerte e le promozioni controlla se chi chiama è 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 relativi a 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 delle offerte.
Limitazioni
Oltre alle limitazioni comuni dei componenti predefiniti, questo componente predefinito presenta le seguenti limitazioni:
- Questo componente non cripta alcun dato.
Dialoghi 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 tramite la telefonia, il che attiva l'intenzione di benvenuto predefinita e la prima risposta dell'agente all'inizio della conversazione.
Offerte e promozioni generali e specifiche per 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 fa alcune domande sulle offerte, poi chiede offerte in una categoria specifica. L'agente presenta l'elenco delle offerte nella categoria. L'agente offre di inviare all'utente i dettagli dell'offerta, ma l'utente rifiuta.
Input utente | Risposta dell'agente |
---|---|
Ti diamo il benvenuto. Vuoi scoprire le nostre ultime offerte o stai riscontrando problemi con un codice coupon specifico? | |
Voglio vedere le ultime offerte | |
Mi confermi che stai cercando offerte? È corretto? | |
sì | |
Abbiamo trovato le seguenti offerte per te: Offerta 1: ricevi il 5% di sconto sugli abiti, utilizza il codice APPARELS5, valido fino al 28/03/2024. Offerta 2: ricevi il 15% di sconto sulla spesa, utilizza il codice GROCERY500, valido fino al 28/03/2024. Ci auguriamo che queste offerte ti interessino. Hai domande su offerte o promozioni a cui possiamo rispondere? |
|
È previsto un importo minimo di acquisto 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/03/2024. Ci auguriamo di poterti fornire i dettagli di cui hai bisogno. Hai domande su offerte o promozioni a cui possiamo rispondere? |
|
Hai offerte per elettronica? | |
Certo. Ecco i dettagli dell'offerta: Offerta 1: ricevi il 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 numero di cellulare o sulla tua email registrati? | |
No, grazie | |
Grazie per aver chiamato. |
Problema con un codice coupon
L'utente finale è stato autenticato in precedenza. L'utente riferisce di avere un problema con un codice coupon. L'agente raccoglie il codice coupon e fornisce all'utente i dettagli relativi all'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 stai riscontrando problemi con un codice coupon specifico? | |
Ho problemi con un codice coupon | |
Mi confermi che stai cercando codici coupon? È corretto? | |
sì | |
Ci dispiace. 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 minimo di acquisto di 100$ ed è valido fino al 28/03/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. Ad esempio, potresti dire: il mio codice coupon non funziona, il codice non funziona nella mia zona. | |
Il codice coupon non funziona | |
Mi confermi che 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 |
---|---|---|
Flusso | [Component Name] | Offerte |
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 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 a livello di flusso devono essere impostati nella pagina di avvio del componente. I parametri basati sulla sessione possono essere impostati da un flusso di chiamate 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 codice paese, utilizzato per identificarlo. | string |
Questo componente predefinito consente di configurare il comportamento del componente, inclusi i tentativi di nuovo invio, tramite i seguenti parametri facoltativi.
Nome parametro | Descrizione | Formato |
---|---|---|
$flow.max_retry_concern_type | Specifica il numero di tentativi consentiti quando l'utente deve scegliere se 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 fornisci una categoria per cui vuoi ricevere 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 riscontrato 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 fornisci un canale su cui 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 il tuo agente.
- Seleziona la scheda Crea.
- Fai clic sul componente importato nella sezione Fluidi.
- Fai clic sulla home page nella sezione Pagine.
- Fai clic su true nella pagina iniziale.
- Nella finestra Percorso, modifica i valori di Preimpostazioni dei parametri in base alle esigenze.
- Fai clic su Salva.
Parametri di output
I parametri di output sono parametri di sessione che rimarranno attivi dopo l'uscita dal componente. Questi parametri contengono informazioni importanti raccolte dal componente. Questo componente predefinito fornisce valori per i seguenti parametri di output:
Nome parametro | Descrizione | Formato di output |
---|---|---|
phone_number | Il numero di telefono locale dell'utente, senza il codice paese, utilizzato per identificarlo. | string |
transfer_reason | Questo parametro indica il motivo dell'uscita dal flusso, se non è andato a buon fine. Il valore restituito è uno dei seguenti:agent : l'utente finale ha richiesto un agente umano in un determinato momento durante la conversazione.denial_of_information : l'utente finale ha rifiutato di condividere le informazioni richieste dal componente.max_no_input : la conversazione ha raggiunto il numero massimo di tentativi per gli eventi senza input. Consulta gli eventi integrati senza input.max_no_match : la conversazione ha raggiunto il numero massimo di tentativi per gli eventi senza corrispondenza. Consulta gli eventi integrati senza corrispondenza.webhook_error : si è verificato un errore webhook. Consulta l'evento integrato webhook.error. webhook_not_found : un URL webhook non era raggiungibile. Vedi 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 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 gratuiti con l'acquisto di determinati prodotti?
- Offrite aggiustamenti dei prezzi 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 utente
Il generatore User-specific offer details
viene utilizzato per fornire dettagli sulle offerte specifiche per utente in base alle informazioni fornite dal webhook get_offers_details
.
Dettagli di offerte e promozioni
Il generatore di 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 di una categoria specifica o richiedere ulteriori 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.
- Ci sono offerte speciali per i nuovi clienti?
- Come faccio a ricevere una notifica delle offerte imminenti?
- Ci sono offerte disponibili esclusivamente in negozio o online?
- Con quale frequenza vengono aggiunti nuovi deal alla tua 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ù volte?
- Posso utilizzare più sconti su un singolo ordine?
- Come faccio a 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 configurazione dei webhook.
Configurazione webhook
Per utilizzare questo componente, dovrai 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 generali e specifiche per l'utente.
Parametri di richiesta API
I seguenti parametri vengono forniti dal componente come input alla richiesta dell'API.
Nome parametro | Descrizione | Formato di input |
---|---|---|
$session.params.phone_number | Numero di telefono per il quale 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 | Indirizzo email registrato nell'account fornito, utilizzato per inviare i dettagli dell'offerta. | string |
user_offer | Elenco dei dettagli delle offerte specifici per 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 di dettagli generali dell'offerta. Ogni elemento dell'elenco rappresenta una singola offerta, seguendo lo stesso formato del campo user_offer . |
Elenco (oggetto) |
Per configurare l'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 l'webhook prebuilt_components_offers_and_deals:get_offers_details.
- Sostituisci l'URL nel campo URL webhook di Conversational Agents (Dialogflow CX) con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo appropriato nel menu a discesa.
- Esamina e aggiorna il corpo della richiesta per creare il formato di richiesta corretto per l'webhook.
- Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta dell'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.
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 per cui un utente ha segnalato problemi.
Parametri di richiesta API
I seguenti parametri vengono forniti dal componente come input alla richiesta dell'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 per il 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, in formato YYYY-MM-DD . |
string |
minimum_order_value | Valore minimo dell'ordine per il codice coupon. | string |
Per configurare l'webhook Get coupon code details per questo componente, espandi la sezione 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 l'webhook prebuilt_components_offers_and_deals:get_coupon_code_details.
- Sostituisci l'URL nel campo URL webhook di Conversational Agents (Dialogflow CX) con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo appropriato nel menu a discesa.
- Esamina e aggiorna il corpo della richiesta per creare il formato di richiesta corretto per l'webhook.
- Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta dell'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 alla richiesta dell'API.
Nome parametro | Descrizione | Formato di input |
---|---|---|
$session.params.phone_number | Il numero di telefono locale dell'utente, senza il codice paese, utilizzato per identificarlo. | string |
$flow.confirmation_channel | Canale su cui l'utente ha selezionato di ricevere i dettagli dell'offerta. I valori validi sono definiti dall'entità prebuilt_components_channel_email_phone . |
string |
Per configurare l'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 il tuo agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona l'webhook prebuilt_components_offers_and_deals:send_message.
- Sostituisci l'URL nel campo URL webhook di Conversational Agents (Dialogflow CX) con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo appropriato nel menu a discesa.
- Esamina e aggiorna il corpo della richiesta per creare il formato di richiesta corretto per l'webhook.
- Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta dell'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.
Apri 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 di richiesta API
I seguenti parametri vengono forniti dal componente come input alla richiesta dell'API.
Nome parametro | Descrizione | Formato di input |
---|---|---|
$session.params.phone_number | Il numero di telefono locale dell'utente, senza il codice paese, utilizzato per identificarlo. | 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 | Problema fornito dall'utente per il codice coupon. | string |
Per configurare l'webhook Apri ticket per questo componente, espandi la sezione 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 l'webhook rebuilt_components_offers_and_deals:raise_ticket.
- Sostituisci l'URL nel campo URL webhook di Conversational Agents (Dialogflow CX) con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo appropriato nel menu a discesa.
- Esamina e aggiorna il corpo della richiesta per creare il formato di richiesta corretto per l'webhook.
- Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta dell'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
L'agente e i relativi webhook dovrebbero essere configurati e pronti per il test.