Il componente predefinito di saluto recupera il numero di telefono del chiamante (ANI), se disponibile. Se il sistema recupera il numero di telefono, il componente esegue un'autenticazione soft utilizzando il numero di telefono e convalidandolo rispetto ai numeri di telefono registrati. L'agente saluta l'utente con un messaggio personalizzato in base ai dati del suo account.
Limitazioni
Oltre alle limitazioni comuni dei componenti predefiniti, questo componente predefinito presenta le seguenti limitazioni:
- Il componente presuppone che i numeri di telefono siano gestiti in un sistema di gestione dei rapporti con i clienti (CRM) o in un altro servizio.
- I clienti esistenti che utilizzano un numero di telefono alternativo per contattarti non vengono autenticati da questo componente.
Finestre di dialogo di esempio
Le seguenti finestre di dialogo di esempio mostrano scenari comuni gestiti da questo componente predefinito. Illustrano cosa succede quando la telefonia avvia il componente, che attiva l'intent di benvenuto predefinito e la prima risposta dell'agente all'inizio della conversazione.
Utente autenticato
L'utente viene identificato in base al numero chiamante e riceve un messaggio di saluto personalizzato.
| Input utente | Risposta dell'agente |
|---|---|
| Ciao [Caller First Name]. Grazie per aver contattato [Nome dell'azienda]. Abbiamo a cuore la tua salute finanziaria. Come possiamo aiutarti oggi? |
Utente non identificato
Il sistema non identifica il numero del chiamante e accoglie l'utente con il messaggio di saluto standard.
| Input utente | Risposta dell'agente |
|---|---|
| Grazie per aver contattato [Nome dell'azienda]. Abbiamo a cuore la tua salute finanziaria. Come possiamo aiutarti oggi? |
Convenzioni di denominazione
Questo componente predefinito utilizza le seguenti convenzioni di denominazione:
| Funzionalità | Formato | Esempio |
|---|---|---|
| Flow | [Component Name] | Saluti |
| Parametro | [param_name] | ani_auth |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_greeting:get_account_details |
Parametri di input
I parametri di input configurano determinati comportamenti del componente. Una o più condizioni all'interno del flusso utilizzano questi parametri per determinare il comportamento del componente. Devi impostare i parametri con ambito di flusso nella pagina iniziale del componente, come descritto di seguito. Puoi impostare i parametri con ambito sessione utilizzando 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 |
|---|---|---|
| $flow.company_name | Acquisisce il nome dell'azienda da utilizzare dinamicamente nel prompt di saluto. | 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 l'agente.
- Seleziona la scheda Build.
- Fai clic sul componente importato nella sezione Flussi.
- Fai clic sulla pagina iniziale nella sezione Pagine.
- Fai clic sulla route 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 rimangono attivi dopo l'uscita dal componente. Questi parametri contengono informazioni importanti raccolte dal componente.
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| ani_auth | Acquisisce il risultato dell'autenticazione basata su ANI. Per impostazione predefinita, il valore è false. |
boolean |
| auth_level | Indica il livello di autenticazione del chiamante. Per impostazione predefinita, il valore è null. -1 indica che l'utente non è stato autenticato tramite il suo ANI. 0 indica che l'autenticazione ANI è andata a buon fine. |
integer |
Impostazione di base
Per configurare questo componente predefinito:
- Importa il componente predefinito.
- Configura il webhook flessibile fornito con i tuoi servizi esterni. Consulta Configurazione del webhook.
Configurazione del webhook
Per utilizzare questo componente, configura i webhook flessibili inclusi per recuperare le informazioni necessarie dai tuoi servizi esterni.
Recupera i dettagli dell'account
Il componente utilizza il webhook prebuilt_components_greeting:get_account_details per identificare il chiamante utilizzando il suo ANI. Se il numero di telefono del chiamante esiste nel servizio esterno configurato, il componente recupera le informazioni pertinenti per personalizzare l'esperienza, inclusi il nome e l'indirizzo email del chiamante.
Parametri di richiesta API
Il componente fornisce i seguenti parametri come input per la richiesta API:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| phone_number | Il numero di telefono del chiamante (ANI). | integer |
Parametri di risposta dell'API
Il componente recupera i seguenti parametri dalla risposta dell'API:
| Nome parametro | Descrizione | Formato di output |
|---|---|---|
| user_first_name | Il nome dell'utente, utilizzato per fornire un saluto personalizzato. | string |
| user_email | L'indirizzo email dell'utente. | string |
Per configurare il webhook Get Account 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_greeting:get_account_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.
Completa
Il componente predefinito e il relativo webhook sono ora configurati e pronti per il test.