Offerte e promozioni componente predefinito verifica se il chiamante è un utente registrato. Se l'utente ha registrato di destinazione, il componente può fornire informazioni su offerte specifiche per l'utente e dei nostri partner. L'utente può anche ricevere dettagli su offerte generali e promozioni o 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 post-chiamata riepilogo, domande frequenti e dettagli dell'offerta.
Limitazioni
Oltre alla sezione 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 utilizzando la telefonia, il che attiva l'intenzione di benvenuto predefinita e la prima risposta dell'agente all'inizio della conversazione.
Offerte e promozioni specifiche per gli utenti e generali
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 chiede ad alcune domande sulle offerte, quindi 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 esplorare le nostre ultime offerte o hai riscontrato 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.Ecco i dettagli: Offerta 1: 5% di sconto sui capi di abbigliamento, codice APPARELS5, valido fino al 28/03/2024. Offerta 2: 15% di sconto sui prodotti alimentari, codice GROCERY500, valida fino al 28/03/2024. Ci auguriamo che queste offerte ti siano interessanti. Hai domande su offerte o promozioni a cui possiamo rispondere? |
|
| C'è 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 usufruire di questa offerta. Offerta valida fino al 28/03/2024. Speriamo di riuscire a fornirti i dettagli che ti servono. Hai domande su offerte o promozioni a cui possiamo rispondere? |
|
| Hai offerte per dispositivi elettronici? | |
| Certo. Ecco i dettagli dell'offerta: Offerta 1: 5% di sconto sui prodotti elettronici, codice ELECTRIC5, valido fino al 28/03/2024. Offerta 2: 15% di sconto sui prodotti elettronici, codice ELECTRIC15, valido fino al 28/03/2024. Speriamo di poterti fornire i dettagli che ti servono. Hai domande su offerte o promozioni a cui possiamo rispondere? |
|
| No, ho finito | |
| Vuoi condividere i dettagli dell'offerta sul dispositivo mobile o nell'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 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 | |
| Per conferma, stai cercando codici coupon. È corretto? | |
| sì | |
| Ci spiace molto. Potresti fornirmi il codice coupon che stai utilizzando? | |
| L'agente raccoglie il codice coupon utilizzando il componente predefinito Raccolta alfanumerica | |
| Il codice offerta APPARELS5 associato agli articoli di abbigliamento ha richiesto un valore di acquisto minimo di 100$ ed è valido fino al 28/03/2024. Assicurati che vengano soddisfatte le condizioni come il requisito di acquisto minimo. Queste informazioni sono utili per te? |
|
| 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 | |
| Per conferma, il problema fornito è che il codice coupon non funziona. È corretto? | |
| sì | |
| Abbiamo lanciato 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 |
|---|---|---|
| Flusso | [Nome componente] | 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 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) Numero di telefono locale dell'utente, senza il codice paese, utilizzato per identificare l'utente. | 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 viene fornita una categoria per cui 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 nuovi tentativi consentiti quando fornisci un canale per i quali 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 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 pagina iniziale nella sezione Pagine.
- Fai clic su true nella pagina iniziale.
- Nella finestra Route, modifica i valori di Parameter Presets 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 il seguente output parametri:
| 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 chiuso, se non è andato a buon fine. Il valore restituito è uno dei seguenti:agent: l'utente finale ha richiesto un agente umano a un certo punto della conversazione.denial_of_information: l'utente finale ha rifiutato di condividere le informazioni richieste dal componente.max_no_input: la conversazione ha raggiunto il numero massimo di nuovi tentativi per 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. Vedi gli eventi integrati senza corrispondenza.webhook_error: si è verificato un errore relativo al 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 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 offerta 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 l'utente
Il generatore User-specific offer details viene utilizzato per fornire dettagli su
offerte specifiche per l'utente in base alle informazioni fornite dal get_offers_details
webhook.
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 chiedere maggiori dettagli
a 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 previste 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 aggiunte nuove offerte 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ù di una volta?
- Posso utilizzare più sconti per 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 l'oggetto fornito webhook flessibili con che descrive i servizi esterni, vedi webhook configurazione.
Configurazione webhook
Per utilizzare questo componente, dovrai 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 delle 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 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 offerta a disposizione dell'utente. I valori validi sono definiti dall'entità prebuilt_components_offers_and_deals_category. |
Elenco (stringa) |
| user_email | Indirizzo email registrato con l'account fornito, utilizzato per inviare i dettagli dell'offerta. | string |
| user_offer | Elenco di dettagli dell'offerta specifica 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 di dettagli generali dell'offerta. Ciascun elemento dell'elenco rappresenta una singola offerta, nello stesso formato del campo user_offer. |
Elenco (oggetto) |
Per configurare l'webhook Get offers details per questo componente, espandi la sezione per visualizzare le istruzioni.
- Apri la console di Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona il tuo agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook predefinito_components_offers_and_deals:get_offers_details.
- Sostituisci l'URL nel campo URL webhook degli agenti conversazionali (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 in modo che corrisponda al formato di richiesta corretto per il webhook.
- Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta dell'webhook. Non modificare i nomi dei parametri, in quanto sono richiesti dal componente per accedere i valori dei campi restituiti.
- Rivedi e aggiorna le impostazioni 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 è in uso
dal componente per recuperare i dettagli di uno specifico codice coupon che 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 del 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, in formato YYYY-MM-DD. |
string |
| minimum_order_value [valore_ordine_min] | 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 di 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 degli agenti conversazionali (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 in modo che corrisponda al formato di richiesta corretto per il webhook.
- Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta dell'webhook. Non modificare i nomi dei parametri, in quanto sono richiesti dal componente per accedere i valori dei campi restituiti.
- Rivedi e aggiorna le impostazioni 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 codice paese, 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 l'webhook Invia messaggio per questo componente, espandi la sezione per visualizzare le istruzioni.
- Apri la console di Dialogflow CX.
- Scegli il tuo progetto Google Cloud.
- Seleziona il tuo agente.
- Seleziona la scheda Gestisci.
- Fai clic su Webhook.
- Seleziona il webhook predefinito_components_offers_and_deals:send_message.
- Sostituisci l'URL nel campo URL webhook degli agenti conversazionali (Dialogflow CX) con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto dal menu a discesa.
- Esamina e aggiorna il corpo della richiesta in modo che corrisponda al formato di richiesta corretto per il webhook.
- Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta dell'webhook. Non modificare i nomi dei parametri, in quanto sono richiesti dal componente per accedere i valori dei campi restituiti.
- Rivedi e aggiorna le impostazioni Autenticazione in base alle esigenze.
- Fai clic su Salva.
Aumenta 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 codice paese, 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 | Problema fornito dall'utente per il codice coupon. | string |
Per configurare il webhook per l'aumento del 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 l'webhook rebuilt_components_offers_and_deals:raise_ticket.
- Sostituisci l'URL nel campo URL webhook degli agenti conversazionali (Dialogflow CX) con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto dal menu a discesa.
- Esamina e aggiorna il corpo della richiesta in modo che corrisponda al formato di richiesta corretto per il webhook.
- Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta dell'webhook. Non modificare i nomi dei parametri, in quanto sono richiesti dal componente per accedere i valori dei campi restituiti.
- Rivedi e aggiorna le impostazioni Autenticazione in base alle esigenze.
- Fai clic su Salva.
Completa
L'agente e i relativi webhook dovrebbero essere configurati e pronti per il test.