Componente predefinito per offerte e promozioni

Il componente predefinito per offerte e deal verifica se il chiamante è un utente registrato. Se l'utente ha un account registrato, il componente può fornire informazioni su offerte e deal specifici 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 riassunto 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.

Finestre di dialogo 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, 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 della categoria. L'agente propone di inviare i dettagli dell'offerta all'utente, ma l'utente rifiuta.

Input utente	Risposta dell'agente
	Ti diamo il benvenuto. Vuoi scoprire le nostre ultime offerte o hai riscontrato problemi con un codice coupon specifico?
Voglio vedere le ultime offerte
	Per conferma, che stai cercando offerte. È corretto?
sì
	Abbiamo trovato le seguenti offerte per te, ecco i dettagli: Offerta 1: ricevi il 5% di sconto sui capi di abbigliamento, utilizza il codice APPARELS5, valido fino al 28/03/2024. Offerta 2: ricevi il 15% di sconto sui prodotti alimentari, utilizza il codice GROCERY500, valido fino al 28/03/2024. Spero che queste offerte siano interessanti. Hai domande su offerte o promozioni a cui possiamo rispondere?
È previsto un importo minimo per l'acquisto dell'offerta di generi alimentari?
	Sì, è previsto un valore minimo di acquisto di 10 per usufruire dello sconto del 15% sui generi alimentari. Utilizza il codice GROCERY500 per usufruire di questa offerta, valida fino al 28/03/2024. Ci auguriamo di poterti fornire i dettagli che hai bisogno. Hai domande su offerte o promozioni a cui possiamo rispondere?
Ci sono offerte per dispositivi elettronici?
	Certo. Ecco i dettagli dell'offerta: Offerta 1: Usufruisci del 5% di sconto sui dispositivi elettronici, usa il codice ELECTRIC5, valido fino al 28/03/2024. Offerta 2: ricevi il 15% di sconto sui dispositivi elettronici, usa il 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 tramite indirizzo email o cellulare registrato?
No grazie
	Grazie per aver chiamato.

Problema con un codice coupon

L'utente finale è stato autenticato in precedenza. L'utente comunica di avere un problema con un codice coupon. L'agente raccoglie il codice coupon e fornisce all'utente i dettagli sull'utilizzo del codice. 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 scoprire le nostre ultime offerte o hai riscontrato problemi con un codice coupon specifico?
Ho problemi con un codice coupon
	Per conferma: 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 richiesto per un valore di acquisto minimo di 100$ è valido fino al 28/03/2024. Assicurati che le condizioni come il requisito di acquisto minimo siano soddisfatte. Queste informazioni sono utili per te?
no
	Specifica il tuo problema. Potresti dire che il mio codice coupon non funziona o che il codice non funziona nella mia zona.
il codice coupon non funziona
	Per conferma, il codice coupon fornito non funziona. È corretto?
sì
	Abbiamo aperto una richiesta di assistenza per segnalare il tuo problema. Grazie per aver chiamato.

Convenzioni di denominazione

Questo componente predefinito utilizza le seguenti convenzioni di denominazione:

Selezione delle	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 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 a flusso devono essere impostati nella pagina iniziale del componente. I parametri basati sulle sessioni possono essere impostati tramite un flusso di chiamata o nella pagina iniziale di questo componente.

Questo componente predefinito accetta i seguenti parametri di input:

Nome parametro	Descrizione	Formato 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 ai seguenti parametri facoltativi di configurare il comportamento del componente, compresi i nuovi tentativi.

Nome parametro	Descrizione	Formato
$flow.max_retry_concern_type	Specifica il numero di nuovi tentativi consentiti quando selezioni 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 nuovi tentativi consentiti quando specifichi una categoria per cui 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 riscontrato il problema. Il valore predefinito è 2.	integer
$flow.max_retry_coupon_code_issue_counter	Specifica il numero di nuovi tentativi consentiti quando viene segnalato 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 specifichi 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

Parametri di output

I parametri di output sono parametri di sessione che rimarranno attivi dopo l'uscita dal componente. Questi parametri contengono importanti informazioni raccolte dal componente. Questo componente predefinito fornisce valori per i seguenti parametri di output:

Nome parametro	Descrizione	Formato di output
phone_number	Numero di telefono locale dell'utente senza il codice paese, utilizzato per identificare l'utente.	string
transfer_reason	Questo parametro indica il motivo dell'uscita dal flusso, se l'operazione non è riuscita. 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 eventi senza input. Vedi gli eventi integrati senza input. max_no_match: la conversazione ha raggiunto il numero massimo di nuovi tentativi per gli eventi senza corrispondenza. Visualizza gli eventi integrati senza corrispondenza. webhook_error: si è verificato un errore relativo al webhook. Vedi l'evento integrato webhook.error. webhook_not_found: un URL webhook non è raggiungibile. Vedi l'evento integrato webhook.error.not-found.	string

generatori

Questo componente utilizza Generatori per abilitare parti specifiche della conversazione.

Riassunto

Il generatore Summarization viene utilizzato per generare un riepilogo post-chiamata che descriva 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à.

• Se cambio idea, posso restituire prodotti in saldo?
• Posso ricevere campioni o regali gratuiti con l'acquisto di determinati prodotti?
• Offri un adeguamento del prezzo se l'articolo che ho acquistato verrà messo in vendita in un secondo momento?
• Esiste un limite di tempo per l'utilizzo dei premi del programma fedeltà?

Dettagli dell'offerta specifica 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 webhook get_offers_details.

Dettagli su offerte e promozioni

Il generatore Offers and deals details viene utilizzato per fornire dettagli su offerte generali e promozioni in base alle informazioni fornite dal webhook get_offers_details. 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 Offers and deals FAQ viene utilizzato per gestire le domande frequenti relative a offerte e deal.

• 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 aggiunti nuovi deal sulla 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 su un singolo ordine?
• Come faccio a utilizzare un codice sconto al momento del pagamento?
• Cosa succede se ho dimenticato di applicare un codice sconto durante il pagamento?

Configurazione di base

Per configurare questo componente predefinito:

1. Importa il componente predefinito.
2. Configura i webhook flessibili forniti con una configurazione che descrive i servizi esterni di Dialogflow. Vedi Configurazione webhook.

Configurazione webhook

Per utilizzare questo componente, devi configurare i hook flessibili inclusi per recuperare le informazioni necessarie dai 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 generiche e specifiche per gli utenti.

Parametri delle richieste API

I seguenti parametri sono forniti dal componente come input per la richiesta API.

Nome parametro	Descrizione	Formato input
$session.params.phone_number	Numero di telefono di 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 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 nell'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 e le 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 che ha lo stesso formato del campo user_offer.	Elenco (oggetto)

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 cui un utente ha segnalato problemi.

Parametri delle richieste API

I seguenti parametri sono forniti dal componente come input per la richiesta API.

Nome parametro	Descrizione	Formato input
$flow.coupon_code	Codice coupon di 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	La data in cui il codice coupon è valido fino al giorno, nel formato YYYY-MM-DD.	string
minimum_order_value	Valore minimo dell'ordine per il codice coupon.	string

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 delle richieste API

I seguenti parametri sono forniti dal componente come input per la richiesta API.

Nome parametro	Descrizione	Formato input
$session.params.phone_number	Numero di telefono locale dell'utente senza il codice paese, utilizzato per identificare l'utente.	string
$flow.confirmation_channel	Canale su cui l'utente ha scelto di ricevere i dettagli dell'offerta. I valori validi sono definiti dall'entità prebuilt_components_channel_email_phone.	string

Aumenta biglietto

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 delle richieste API

I seguenti parametri sono forniti dal componente come input per la richiesta API.

Nome parametro	Descrizione	Formato input
$session.params.phone_number	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

Completi

L'agente e i relativi webhook dovrebbero essere configurati e pronti per i test.