Creare un componente predefinito per i pagamenti

Il componente predefinito Effettua un pagamento autentica l'utente e gli consente di effettuare un pagamento. Questo componente utilizza una versione personalizzata del componente predefinito Autenticazione per autenticare i titolari di account e di carta. Il componente utilizza anche i componenti predefiniti Raccolta del nome, Raccolta della data di scadenza della carta di credito e Raccolta del CVV della carta di credito per raccogliere le informazioni necessarie per effettuare i pagamenti.

Tipi di pagamento

Questo componente supporta i pagamenti per le fatture delle carte di credito e i conti beneficiario. Per le fatture delle carte di credito, gli utenti possono scegliere di pagare l'importo minimo, totale o personalizzato. L'utente può effettuare pagamenti dal proprio conto bancario, con carta di debito o di credito o con pagamento mobile.

Tipo di pagamento	Metodi di pagamento disponibili	Importi dei pagamenti disponibili
Fattura della carta di credito	Conto bancario, carta di debito, pagamento mobile	Importo minimo, totale, personalizzato
Conto beneficiario	Conto bancario, carta di credito, carta di debito, pagamento mobile	Importo personalizzato

Limitazioni

Oltre alle limitazioni comuni dei componenti predefiniti, questo componente predefinito presenta le seguenti limitazioni:

• Questo componente non cripta alcun dato.

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.

Pagamento sul conto del beneficiario

L'agente rileva che l'utente non è stato autenticato in precedenza e raccoglie informazioni per verificare che sia un utente registrato. L'utente indica che vuole effettuare un pagamento a un conto beneficiario e l'agente raccoglie le informazioni richieste, incluso il nome del beneficiario, e conferma il numero di conto. Infine, l'utente sceglie di effettuare un pagamento utilizzando la propria carta di debito, quindi l'agente raccoglie il numero della carta di debito, la data di scadenza, il CVV e conferma il pagamento.

Input utente	Risposta dell'agente
	L'agente autentica l'utente utilizzando il componente predefinito Autenticazione
	Grazie, l'autenticazione è stata completata.
	Vuoi pagare la fattura della tua carta di credito registrata o effettuare un pagamento a un account beneficiario esistente?
Beneficiario
	L'agente raccoglie il nome del beneficiario utilizzando il componente predefinito Raccolta del nome
	Grazie, abbiamo raccolto il nome del beneficiario. Ok, in base ai nostri registri, abbiamo il numero di conto che termina con 7821. Rispondi sì per confermare il numero di conto.
Sì
	Conferma l'importo che vuoi pagare. Ad esempio, se vuoi pagare 100,30 $, di' 100 punto 30.
50 dollari
	Vuoi pagare con il tuo conto bancario, carta di debito, carta di credito o pagamento mobile?
Debito
	Puoi aiutarci a individuare le ultime 4 cifre del numero della carta di debito a cui fai riferimento?
1234
	Le ultime quattro cifre del numero della carta di debito che abbiamo ricevuto sono 1234. È corretto?
Sì, è corretto
	L'agente raccoglie la data di scadenza della carta di debito utilizzando il componente predefinito Raccolta della data di scadenza della carta di credito
	Ottimo, abbiamo terminato la raccolta della data di scadenza della carta di debito.
	L'agente raccoglie il CVV della carta di debito utilizzando il componente predefinito Raccolta del CVV della carta di credito
	Ottimo, abbiamo finito di raccogliere il CVV.
	Ok, stiamo per effettuare un pagamento di 50,00 $a Jane con il numero della carta di debito che termina con 1234. Confermi questa azione?
Sì
	Per procedere, ti invieremo un codice. Preferisci ricevere il codice via telefono o email?
Email, per favore
	Abbiamo inviato un codice all'indirizzo email registrato [e-mail]. L'operazione potrebbe richiedere alcuni secondi. Puoi confermare il codice?
123456
	Ok, attendi qualche secondo mentre eseguiamo il pagamento. Il pagamento sul conto del beneficiario è andato a buon fine.

Pagamento fattura carta di credito

L'agente rileva che l'utente non è stato autenticato in precedenza e raccoglie informazioni per verificare che sia un utente registrato. L'utente indica che vuole effettuare un pagamento della fattura della carta di credito utilizzando il proprio conto bancario. L'agente conferma l'importo e i dettagli del metodo di pagamento e completa il pagamento.

Input utente	Risposta dell'agente
	L'agente autentica l'utente utilizzando il componente predefinito Autenticazione
	Grazie, l'autenticazione è stata completata.
	Vuoi pagare la fattura della tua carta di credito registrata o effettuare un pagamento a un account beneficiario esistente?
Fattura della carta di credito
	Puoi aiutarci a individuare le ultime 4 cifre del numero della carta di credito a cui fai riferimento?
4321
	Le ultime quattro cifre del numero di carta di credito che abbiamo ricevuto sono 4321. È corretto?
Sì
	L'importo totale dovuto è di 300 $e il pagamento minimo è di 20 $. Vuoi pagare l'importo totale, l'importo minimo o un altro importo?
Importo totale
	Vuoi pagare tramite conto bancario, carta di debito o pagamento mobile?
Conto di risparmio
	Abbiamo rilevato che al tuo numero sono associati due account. Puoi aiutarci a individuare le ultime 4 cifre dell'account a cui fai riferimento?
1001
	Le ultime quattro cifre del numero di conto che abbiamo ricevuto sono 1001. È corretto?
Sì
	Ok, stiamo per effettuare un pagamento di 300 $per la fattura della carta di credito che termina con 4321 con il numero di conto che termina con 1001. Confermi questa azione?
Sì
	Per procedere, ti invieremo un codice. Preferisci ricevere il codice via telefono o email?
Invialo alla mia email
	Abbiamo inviato un codice all'indirizzo email registrato [e-mail]. L'operazione potrebbe richiedere alcuni secondi. Puoi confermare il codice?
123456
	Ok, attendi qualche secondo mentre eseguiamo il pagamento. Il pagamento con carta di credito è andato a buon fine.

Fondi o limiti insufficienti

L'agente rileva che l'utente non è stato autenticato in precedenza e raccoglie informazioni per verificare che sia un utente registrato. L'utente tenta di effettuare pagamenti della fattura della carta di credito utilizzando il proprio conto bancario e la propria carta di debito, ma entrambi i pagamenti vengono rifiutati a causa di fondi insufficienti o limiti. Infine, l'utente sceglie di effettuare un pagamento mobile e l'agente gli invia un link per completare il pagamento da dispositivo mobile.

Input utente	Risposta dell'agente
	L'agente autentica l'utente utilizzando il componente predefinito Autenticazione
	Grazie, l'autenticazione è stata completata.
	Vuoi pagare la fattura della tua carta di credito registrata o effettuare un pagamento a un account beneficiario esistente?
Carta di credito
	Puoi aiutarci a individuare le ultime 4 cifre del numero della carta di credito a cui fai riferimento?
4321
	Le ultime quattro cifre del numero di carta di credito che abbiamo ricevuto sono 4321. È corretto?
Sì
	L'importo totale dovuto è di 300 $e il pagamento minimo è di 20 $. Vuoi pagare l'importo totale, l'importo minimo o un altro importo?
Importo totale
	Vuoi pagare tramite conto bancario, carta di debito o pagamento mobile?
Risparmi
	Abbiamo rilevato che al tuo numero sono associati due account. Puoi aiutarci a individuare le ultime 4 cifre dell'account a cui fai riferimento?
1002
	Le ultime quattro cifre del numero di conto che abbiamo ricevuto sono 1002. È corretto?
Sì
	Ok, stiamo per effettuare un pagamento di 300 $per la fattura della carta di credito che termina con 4321 con il numero di conto che termina con 1002. Confermi questa azione?
Sì
	Per procedere, ti invieremo un codice. Preferisci ricevere il codice via telefono o email?
Email
	Abbiamo inviato un codice all'indirizzo email registrato [e-mail]. L'operazione potrebbe richiedere alcuni secondi. Puoi confermare il codice?
123456
	Ok, attendi qualche secondo mentre eseguiamo il pagamento. Il pagamento non è andato a buon fine a causa di fondi insufficienti nell'account. Vuoi riprovare a effettuare il pagamento con un altro metodo di pagamento?
Sì
	Vuoi pagare tramite conto bancario, carta di debito o pagamento mobile?
Carta di debito
	Puoi aiutarci a individuare le ultime 4 cifre del numero della carta di debito a cui fai riferimento?
2345
	Le ultime quattro cifre del numero della carta di debito che abbiamo ricevuto sono 2345. È corretto?
Sì
	L'agente raccoglie la data di scadenza della carta di debito utilizzando il componente predefinito Raccolta della data di scadenza della carta di credito
	Ottimo, abbiamo terminato la raccolta della data di scadenza della carta di debito.
	L'agente raccoglie il CVV della carta di debito utilizzando il componente predefinito Raccolta del CVV della carta di credito
	Ottimo, abbiamo finito di raccogliere il CVV.
	Ok, stiamo per effettuare un pagamento di 300 $per la fattura della carta di credito che termina con 4321 utilizzando il numero della carta di debito che termina con 2345. Confermi questa azione?
Sì
	Per procedere, ti invieremo un codice. Preferisci ricevere il codice via telefono o email?
Email
	Abbiamo inviato un codice all'indirizzo email registrato [e-mail]. L'operazione potrebbe richiedere alcuni secondi. Puoi confermare il codice?
123456
	Ok, attendi qualche secondo mentre eseguiamo il pagamento. Il pagamento non è andato a buon fine perché il limite della carta di debito è stato superato. Vuoi riprovare a effettuare il pagamento con un altro metodo di pagamento?
Sì
	Vuoi pagare tramite conto bancario, carta di debito o pagamento mobile?
Dispositivi mobili
	Ok, stiamo inviando il link di pagamento al tuo numero di cellulare registrato. Questa azione può richiedere alcuni secondi. Conferma di averlo ricevuto rispondendo "Sì".
Sì
	Ottimo, ora puoi aprire il link e continuare il pagamento.

Convenzioni di denominazione

Questo componente predefinito utilizza le seguenti convenzioni di denominazione:

Funzionalità	Formato	Esempio
Flow	[Component Name]	Eseguire un pagamento
Component Specific Intent	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_make_a_payment_payment_type
Tipo di entità	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_make_a_payment_payment_mode
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_make_a_payment:process_payment_credit_card

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 flusso devono essere impostati nella pagina iniziale del componente come descritto di seguito. I parametri con ambito sessione possono essere impostati da 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
$session.params.auth_level	(facoltativo) Indica il livello di autenticazione del chiamante.	integer
$session.params.auth_level_req	Indica il livello di autenticazione necessario prima che un utente possa accedere alla cronologia delle transazioni. Questo valore è configurato nei preset dei parametri del completamento della voce di pagina nella pagina check auth level. Per impostazione predefinita, questo valore è 1.	integer
$session.params.account_auth_enabled	Indica se l'utente deve essere autenticato come titolare dell'account, come descritto in Tipi di autenticazione. Questo valore è configurato nei preset dei parametri del completamento della voce di pagina nella pagina check auth level. Per impostazione predefinita, questo valore è true.	boolean
$session.params.card_auth_enabled	Indica se l'utente deve essere autenticato come titolare della carta, come descritto in Tipi di autenticazione. Questo valore è configurato nei preset dei parametri del completamento della voce di pagina nella pagina check auth level. Per impostazione predefinita, questo valore è false.	boolean
$session.params.phone_number	(facoltativo) Numero di telefono registrato del cliente utilizzato per l'autenticazione.	string
$flow.payment_success_code	Specifica il valore del campo payment_status_code restituito dai webhook process_payment che indica che il pagamento è andato a buon fine. Per impostazione predefinita, questo valore è "200".	string
$flow.insufficient_fund_code	Specifica il valore del campo payment_status_code restituito dai process_payment webhook che indica che il pagamento non è stato completato a causa di fondi insufficienti. Per impostazione predefinita, questo valore è "400".	string
$flow.limit_exceed_code	Specifica il valore del campo payment_status_code restituito dai process_payment webhook che indica che il pagamento non è stato completato perché è stato superato il limite giornaliero. Per impostazione predefinita, questo valore è "401".	string
$flow.max_retry_mop_counter	Specifica il numero di volte in cui un utente può modificare il proprio metodo di pagamento. Il valore predefinito è 2.	integer
$flow.max_retry_credit_card_payment	Specifica il numero di tentativi consentiti quando si tenta di effettuare un pagamento utilizzando una carta di credito come metodo di pagamento. Il valore predefinito è 3.	integer
$flow.max_retry_mobile_payment_counter	Specifica il numero di tentativi consentiti quando si tenta di effettuare un pagamento utilizzando il pagamento mobile come metodo di pagamento. Il valore predefinito è 2.	integer
$flow.max_retry_creditcard_count	Specifica il numero di tentativi consentiti per raccogliere un numero di carta di credito valido per effettuare un pagamento. Il valore predefinito è 3.	integer
$flow.max_retry_acc_number	Specifica il numero di tentativi consentiti per raccogliere i dettagli dell'account validi per effettuare un pagamento. Il valore predefinito è 3.	integer
$flow.max_retry_debit_card_details	Specifica il numero di tentativi consentiti per raccogliere i dati validi della carta di debito per effettuare un pagamento. Il valore predefinito è 3.	integer
$flow.max_retry_credit_card_details	Specifica il numero di tentativi consentiti per raccogliere i dati validi della carta di credito per effettuare un pagamento. Il valore predefinito è 3.	integer
$flow.otp_length	Specifica la lunghezza prevista della password monouso inviata all'utente. Il valore predefinito è 6.	integer
$flow.max_retry_otp_count	Specifica il numero di tentativi consentiti per la raccolta di una password monouso (OTP) valida dall'utente. Il valore predefinito è 3.	integer
$flow.max_waiting_room_counter	Specifica il numero di volte in cui l'utente può chiedere all'agente di attendere mentre riceve il link per il pagamento mobile. Il valore predefinito è 2.	integer

Per configurare i parametri di input per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Crea.
5. Fai clic sul componente importato nella sezione Flussi.
6. Fai clic su Pagina iniziale nella sezione Pagine.
7. Fai clic sulla route true nella pagina iniziale.
8. Nella finestra Route, modifica i valori di Preset parametri in base alle tue esigenze.
9. 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
auth_level	Indica il livello di autenticazione del chiamante.	integer
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 interrotto, se non è andato a buon fine. Il valore restituito è uno dei seguenti: agent: l'utente finale ha richiesto un operatore umano a un certo punto della conversazione. denial_of_information: l'utente finale si è 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 eventi integrati senza corrispondenza. webhook_error: si è verificato un errore webhook. Vedi webhook.error evento integrato. webhook_not_found: un URL webhook non era raggiungibile. Vedi webhook.error.not-found evento integrato.	string

Impostazione di base

Per configurare questo componente predefinito:

1. Importa il componente predefinito.
2. Configura i webhook flessibili forniti con la configurazione che descrive i tuoi servizi esterni. Per informazioni sulla configurazione dei webhook, vedi la sezione Configurazione dei webhook di seguito.

Configurazione webhook

Per utilizzare questo componente, devi configurare i webhook flessibili inclusi per recuperare le informazioni necessarie dai tuoi servizi esterni.

Autenticazione

Se non hai configurato in precedenza i servizi esterni necessari per l'autenticazione, dovrai configurarli per abilitare l'autenticazione degli utenti per questo componente. Per istruzioni dettagliate, consulta Configurazione del webhook di autenticazione.

Convalida account

Il webhook prebuilt_components_account_services:validate_account viene utilizzato dal componente per verificare l'esistenza di un account in base al numero di telefono registrato dell'utente e alle ultime quattro cifre del numero di conto fornito. Il webhook restituisce anche il saldo dell'account, se esiste.

Parametri della 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
$session.params.last_four_digit_of_account_number	Le ultime quattro cifre del numero di conto che l'utente ha selezionato e confermato per effettuare un pagamento.	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
account_found	Indica se esiste un account con le ultime quattro cifre fornite per l'account registrato dell'utente.	boolean
saldo	L'importo del saldo attuale dell'account, se esistente.	numero

Per configurare il webhook di convalida dell'account per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_account_services:validate_account.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Dettagli della carta dell'utente

Il webhook prebuilt_components_make_a_payment:user_card_details viene utilizzato dal componente per ottenere i dettagli delle carte di debito e di credito di un utente registrato.

Parametri della 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

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
credit_card_count	Numero di carte di credito associate al numero di telefono registrato.	integer
last_four_digit_of_credit_card_number	Le ultime quattro cifre della carta di credito dell'utente. Se il cliente ha più carte di credito, questo valore è null.	string
debit_card_count	Numero di carte di debito associate al numero di telefono registrato.	integer
last_four_digit_of_debit_card_number	Ultime quattro cifre della carta di debito dell'utente. Se il cliente ha più carte di debito, questo valore è null.	string

Per configurare il webhook dei dettagli della scheda utente per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_make_a_payment:user_card_details.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Verifica il nome del beneficiario

Il webhook prebuilt_components_make_a_payment:verify_beneficiary_name viene utilizzato dal componente per verificare che esista un account beneficiario per il nome fornito dall'utente.

Parametri della 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
$session.params.name_collection_first_name	Nome del beneficiario.	string
$session.params.name_collection_last_name	Cognome del beneficiario.	string
$session.params.name_collection_middle_name	Secondo nome del beneficiario.	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
beneficiary_account_number	Ultime quattro cifre del numero di conto del beneficiario per il nome del beneficiario fornito. Se non viene trovato un account beneficiario per il nome fornito, il valore è null.	string

Per configurare il webhook Verifica nome beneficiario per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_make_a_payment:verify_beneficiary_name.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Recupera importo dovuto

Il webhook prebuilt_components_make_a_payment:get_due_amount viene utilizzato dal componente per ottenere informazioni sull'importo minimo e totale dovuto per la fattura della carta di credito dell'utente.

Parametri della 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.user_credit_card_number	Le ultime quattro cifre della carta di credito 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
minimum_amount	Importo minimo dovuto per la fattura della carta di credito specificata.	numero
total_amount	Importo totale dovuto per la fattura della carta di credito specificata.	numero

Per configurare il webhook Ottieni importo dovuto per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_make_a_payment:get_due_amount.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Verifica il numero della carta di credito

Il webhook prebuilt_components_make_a_payment:verify_credit_card_number viene utilizzato dal componente per verificare che il numero della carta di credito fornito sia registrato nell'account dell'utente.

Parametri della 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.user_credit_card_number	Le ultime quattro cifre della carta di credito 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
card_found	Indica se la carta di credito fornita è stata trovata.	boolean

Per configurare il webhook Verifica numero di carta di credito per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_make_a_payment:verify_credit_card_number.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Verificare i dati della carta di credito

Il webhook prebuilt_components_make_a_payment:verify_credit_card_details viene utilizzato dal componente per verificare che i dettagli forniti, inclusi data di scadenza e CVV, siano validi per la carta di credito fornita dall'utente.

Parametri della 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.credit_card_number	Le ultime quattro cifre della carta di credito dell'utente.	string
$flow.credit_card_exp_date	Data di scadenza della carta di credito fornita dall'utente per la carta di credito specifica.	{ "year": integer, "month": integer }
$flow.credit_card_cvv_code	Il codice CVV fornito dall'utente per la carta di credito specificata.	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
creditcard_verification_status	Indica se i dati della carta di credito forniti sono stati convalidati.	boolean

Per configurare il webhook Verifica dati carta di credito per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_make_a_payment:verify_credit_card_details.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Verifica i dati della carta di debito

Il webhook prebuilt_components_make_a_payment:verify_debit_card_details viene utilizzato dal componente per verificare che i dettagli forniti, inclusi data di scadenza e CVV, siano validi per la carta di debito fornita dall'utente.

Parametri della 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.debit_card_number	Ultime quattro cifre della carta di debito dell'utente.	string
$flow.debit_card_exp_date	Data di scadenza della carta di debito fornita dall'utente per la carta di debito specificata.	{ "year": integer, "month": integer }
$flow.debit_card_cvv_code	Il codice CVV fornito dall'utente per la carta di debito specificata.	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
debitcard_verification_status	Indica se i dati della carta di debito forniti sono stati convalidati.	boolean

Per configurare il webhook Verifica dettagli carta di debito per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_make_a_payment:verify_debit_card_details.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Elaborare il pagamento con carta di credito

Il webhook prebuilt_components_make_a_payment:process_payment_credit_card viene utilizzato dal componente per elaborare un pagamento utilizzando i dati della carta di credito forniti.

Parametri della 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.payee_number	Ultime quattro cifre del numero di conto del beneficiario del pagamento.	string
$flow.payment_type	Tipo di pagamento per il pagamento. I valori validi sono definiti dall'entità personalizzata prebuilt_components_make_a_payment_payment_type. Per impostazione predefinita, questo componente supporta "beneficiary_pay" e "credit_card_pay".	string
$flow.credit_card_number	Le ultime quattro cifre della carta di credito dell'utente.	string
$flow.credit_card_exp_date	Data di scadenza della carta di credito fornita dall'utente per la carta di credito specificata.	{ "year": integer, "month": integer }
$flow.credit_card_cvv_code	Il codice CVV fornito dall'utente per la carta di credito specificata.	string
$flow.payment_amount	L'importo che l'utente ha scelto di pagare.	numero

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
payment_status_code	Indica se il pagamento è andato a buon fine. I valori validi sono definiti dai parametri di input configurabili $flow.payment_success_code, $flow.insufficient_fund_code e $flow.limit_exceed_code.	string

Per configurare il webhook Elabora pagamento con carta di credito per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_make_a_payment:process_payment_credit_card.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Elaborare il pagamento con carta di debito

Il webhook prebuilt_components_make_a_payment:process_payment_debit_card viene utilizzato dal componente per elaborare un pagamento utilizzando i dati della carta di debito forniti.

Parametri della 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.payee_number	Ultime quattro cifre del numero di conto del beneficiario del pagamento.	string
$flow.payment_type	Tipo di pagamento per il pagamento. I valori validi sono definiti dall'entità personalizzata prebuilt_components_make_a_payment_payment_type. Per impostazione predefinita, questo componente supporta "beneficiary_pay" e "credit_card_pay".	string
$flow.debit_card_number	Ultime quattro cifre della carta di debito dell'utente.	string
$flow.debit_card_exp_date	Data di scadenza della carta di debito fornita dall'utente per la carta di debito specificata.	{ "year": integer, "month": integer }
$flow.debit_card_cvv_code	Il codice CVV fornito dall'utente per la carta di debito specificata.	string
$flow.payment_amount	L'importo che l'utente ha scelto di pagare.	numero

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
payment_status_code	Indica se il pagamento è andato a buon fine. I valori validi sono definiti dai parametri di input configurabili $flow.payment_success_code, $flow.insufficient_fund_code e $flow.limit_exceed_code.	string

Per configurare il webhook Elabora pagamento con carta di debito per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_make_a_payment:process_payment_debit_card.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Elabora pagamento account

Il webhook prebuilt_components_make_a_payment:process_payment_account viene utilizzato dal componente per elaborare un pagamento utilizzando i dati dell'account forniti.

Parametri della 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.payee_number	Ultime quattro cifre del numero di conto del beneficiario del pagamento.	string
$flow.payment_type	Tipo di pagamento per il pagamento. I valori validi sono definiti dall'entità personalizzata prebuilt_components_make_a_payment_payment_type. Per impostazione predefinita, questo componente supporta "beneficiary_pay" e "credit_card_pay".	string
$session.params.last_four_digit_of_account_number	Ultime quattro cifre dell'account dell'utente.	string
$flow.payment_amount	L'importo che l'utente ha scelto di pagare.	numero

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
payment_status_code	Indica se il pagamento è andato a buon fine. I valori validi sono definiti dai parametri di input configurabili $flow.payment_success_code, $flow.insufficient_fund_code e $flow.limit_exceed_code.	string

Per configurare il webhook di pagamento dell'account di elaborazione per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_make_a_payment:process_payment_account.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Elaborare il pagamento mobile

Il webhook prebuilt_components_make_a_payment:process_payment_mobile viene utilizzato dal componente per generare e inviare un link per il pagamento mobile per i dettagli di pagamento selezionati dall'utente.

Parametri della 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.payee_number	Ultime quattro cifre del numero di conto del beneficiario del pagamento.	string
$flow.payment_type	Tipo di pagamento per il pagamento. I valori validi sono definiti dall'entità personalizzata prebuilt_components_make_a_payment_payment_type. Per impostazione predefinita, questo componente supporta "beneficiary_pay" e "credit_card_pay".	string
$flow.payment_amount	L'importo che l'utente ha scelto di pagare.	numero

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
payment_link_generated	Indica se il link per il pagamento mobile è stato generato e inviato correttamente all'utente.	boolean

Per configurare il webhook Elabora pagamento mobile per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona il tuo agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_make_a_payment:process_payment_mobile.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il Metodo corretto nel menu a discesa.
8. Rivedi e aggiorna il corpo della richiesta per formare il formato di richiesta corretto per il webhook.
9. Controlla e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, in quanto sono necessari al componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Completa

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