Vordefinierte Authentifizierungskomponente

Die vordefinierte Komponente für die Authentifizierung erfasst Informationen vom Nutzer, um ihn auf der erforderlichen Authentifizierungsebene zu authentifizieren. Diese Komponente deckt Authentifizierungsanforderungen ab, die in der Finanzdienstleistungsbranche (FSI) üblich, aber nicht ausschließlich sind. Diese Komponente verwendet die vordefinierten Komponenten Erfassung des Ablaufdatums der Kreditkarte, Erfassung des Geburtsdatums und Erfassung der Telefonnummer, um Nutzerdetails zu erfassen und zu validieren.

Authentifizierungsebenen

Für verschiedene vordefinierte Komponenten sind mehrere Authentifizierungsebenen erforderlich. Für höhere Ebenen sind mehr Nutzerinformationen erforderlich, um den Nutzer zu authentifizieren. Mit der Authentifizierungskomponente können sich Nutzer auf Stufe 0 (ANI-Abgleich), Stufe 1 (Basic) oder Stufe 2 (Multi-Faktor) authentifizieren, wie in der Tabelle „Authentifizierungsstufe“ beschrieben.

Authentifizierungsebene	Voraussetzungen
Stufe 0: ANI-Übereinstimmung	Der Nutzer wird authentifiziert, indem er von einer Telefonnummer anruft oder eine Telefonnummer angibt, die einem registrierten Konto entspricht. Ein Nutzer kann mit der vordefinierten Komponente „Begrüßung“ auf Stufe 0 authentifiziert werden.
Stufe 1: Basic	Der Nutzer wird authentifiziert, indem er einen Einmalpasswort-Code (OTP) bestätigt, der an seine E‑Mail-Adresse oder Telefonnummer gesendet wurde. Wenn die OTP-Bestätigung fehlschlägt, kann der Nutzer drei von vier Sicherheitsfragen beantworten, um sich erfolgreich zu authentifizieren: Geburtsdatum, die letzten vier Ziffern der Debitkarte oder das Ablaufdatum der Kreditkarte (je nachdem, ob er Konto- oder Karteninhaber ist), der Betrag der letzten Transaktion und die Zahlungsmethode der letzten Kreditkartenabrechnung.
Stufe 2: Multi-Faktor-Authentifizierung	Der Nutzer wird zusätzlich authentifiziert, indem ein Sicherheitsschlüssel überprüft wird, der von einer externen Authentifizierungs-App oder Push-Benachrichtigung generiert wurde.

Unterstützte Nutzertypen

Die Authentifizierungskomponente bietet Unterstützung für Nutzer, die registrierte Bankkunden sind und Kontoinhaber, Karteninhaber oder beides sind. Die Komponente unterstützt auch die Authentifizierung für Nutzer, die keine registrierten Bankkunden sind, aber eine Vollmacht für bei der Bank registrierte Konten haben. Nutzer können ein oder mehrere Konten oder Karten bei der Bank registriert haben.

Authentifizierungstypen

Mit dieser Komponente können Sie konfigurieren, ob ein Nutzer als Kontoinhaber, Karteninhaber oder beides authentifiziert werden soll. Diese Optionen werden durch Festlegen der Eingabeparameter $session.params.account_auth_enabled und $session.params.card_auth_enabled konfiguriert. In dieser Tabelle wird das Verhalten der Komponenten für verschiedene Kombinationen von Werten für die Flags zur Konto- und Kartenauthentifizierung beschrieben.

account_auth_enabled	card_auth_enabled	Authentifizierungstyp
true	false	Der Nutzer wird als Kontoinhaber authentifiziert. Dabei wird geprüft, ob der Nutzer ein oder mehrere Konten bei der Bank hat, und es werden Sicherheitsfragen gestellt, einschließlich der letzten vier Ziffern der registrierten Debitkarte.
false	true	Der Nutzer wird als Karteninhaber authentifiziert. Dabei wird überprüft, ob er eine oder mehrere Kreditkarten bei der Bank hat, und es werden Sicherheitsfragen gestellt, einschließlich des Ablaufdatums einer registrierten Kreditkarte.
true	true	Die Komponente prüft zuerst, ob der Nutzer ein registrierter Kontoinhaber ist. Wenn der Nutzer ein oder mehrere Konten bei der Bank hat, authentifiziert die Komponente den Nutzer anhand der Kontoinformationen. Wenn der Nutzer kein Konto bei der Bank hat, versucht die Komponente, den Nutzer anhand der Karteninhaberinformationen zu authentifizieren.
false	false	Die Komponente prüft zuerst, ob der Nutzer ein registrierter Kontoinhaber ist. Wenn der Nutzer ein oder mehrere Konten bei der Bank hat, authentifiziert die Komponente den Nutzer auf Authentifizierungsebene 0. Wenn der Nutzer kein Konto bei der Bank hat, prüft die Komponente, ob der Nutzer ein Karteninhaber ist. Wenn der Nutzer eine oder mehrere Kreditkarten bei der Bank hat, authentifiziert die Komponente den Nutzer mit der Authentifizierung der Stufe 0.

Beschränkungen

Zusätzlich zu den allgemeinen Einschränkungen für vordefinierte Komponenten gelten für diese vordefinierte Komponente die folgenden Einschränkungen:

• OTPs werden nur an eine Mobilnummer oder E‑Mail-Adresse gesendet, die zuvor für den Nutzer registriert wurde. Die Komponente verwendet kein OTP, um Kunden zu authentifizieren, die von einer alternativen Telefonnummer anrufen, die nicht in ihrem Konto registriert ist. Wenn ein Nutzer von einer alternativen Telefonnummer aus anruft, werden Sicherheitsfragen verwendet, um den Anrufer zu authentifizieren.
• Diese Komponente verschlüsselt keine Daten.

Beispieldialoge verfassen

Die folgenden Beispieldialoge zeigen gängige Szenarien, die von dieser vordefinierten Komponente verarbeitet werden. Die Beispieldialoge zeigen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dadurch werden der Standard-Willkommens-Intent und die erste Agent-Antwort zu Beginn der Unterhaltung ausgelöst.

Authentifizierung auf Stufe 1 erfolgreich: OTP

Der Nutzer wurde zuvor auf Authentifizierungsstufe 0 authentifiziert. Die Komponente sendet ein OTP an den vom Nutzer ausgewählten Kanal und bittet ihn, es zu bestätigen. Der Nutzer kann ein gültiges OTP angeben und wird erfolgreich auf Stufe 1 authentifiziert.

Nutzereingabe	Antwort des KI-Agenten
	Aus Sicherheitsgründen müssen wir Ihre Identität bestätigen. Dazu senden wir Ihnen einen Code. Möchten Sie den Code lieber per Telefon oder per E‑Mail erhalten?
Telefon
	Wir haben einen Code an Ihre registrierte Telefonnummer mit der Endung 0000 gesendet. Dies kann einige Sekunden dauern. Können Sie den Code bitte bestätigen?
Der Code lautet 123457.
	Vielen Dank, Sie wurden authentifiziert.

Authentifizierung auf Stufe 1 erfolgreich: Sicherheitsfragen

Die Komponente bestätigt die Authentifizierung des Nutzers auf Stufe 0, indem sie die angegebene Telefonnummer erfasst und überprüft. Die Komponente fragt die richtigen Antworten auf drei Sicherheitsfragen ab und validiert sie: Geburtsdatum, die letzten vier Ziffern der Debitkartennummer des Nutzers und der Betrag der letzten Transaktion. Der Nutzer ist erfolgreich auf Stufe 1 authentifiziert.

Nutzereingabe	Antwort des KI-Agenten
	Sind Sie Kunde unserer Bank oder haben Sie eine Vollmacht? Bitte bestätige mit „Ja“ oder „Nein“.
Ja
	Wir benötigen deine Telefonnummer, um deine Kontodetails abzurufen.
	Der Agent erfasst die Telefonnummer des Nutzers mithilfe der vordefinierten Komponente Telefonnummernerfassung.
	Ok. Die von Ihnen genannte Nummer ist [phone], ist das richtig?
Ja
	Die Telefonnummer wurde erfasst. Aus Sicherheitsgründen benötigen wir noch weitere Informationen, um Ihre Identität zu bestätigen.
	Der KI-Agent erfasst das Geburtsdatum des Nutzers mithilfe der vordefinierten Komponente Geburtsdatum erfassen.
	Okay, Ihr Geburtsdatum ist der 3. Februar 1995, richtig?
Ja
	Wir haben Ihr Geburtsdatum erfasst. Nennen Sie uns bitte die letzten vier Ziffern Ihrer Debitkartennummer.
Es ist 1234
	Gib den Betrag deiner letzten Transaktion an. Wenn der Betrag Ihrer letzten Transaktion beispielsweise 100, 30 € betrug, sagen Sie „100“.
Es waren 500 Dollar.
	Vielen Dank, Sie wurden authentifiziert.

Authentifizierung auf Stufe 2 erfolgreich: 2-Faktor-Authentifizierung

Der Nutzer wurde bereits auf Authentifizierungsebene 1 authentifiziert. Die Komponente fordert den Nutzer auf, einen Sicherheitsschlüssel mit seiner Bank- oder Authentifizierungs-App zu generieren. Der Nutzer bestätigt den generierten Sicherheitsschlüssel und wird auf Stufe 2 authentifiziert.

Nutzereingabe	Antwort des KI-Agenten
	Bitte gib deinen Sicherheitsschlüssel an. Generiere den 6-stelligen Sicherheitsschlüssel in deiner Banking- oder Authentifizierungs-App. Sag oder gib dann die Ziffern ein.
232425
	Vielen Dank, Sie wurden authentifiziert.

Verweigerung von Informationen

Der Nutzer weigert sich, die für die Authentifizierung erforderlichen Informationen anzugeben. Die Komponente wird mit einer Fehlermeldung beendet.

Nutzereingabe	Antwort des KI-Agenten
	Aus Sicherheitsgründen müssen wir Ihre Identität bestätigen. Dazu senden wir Ihnen einen Code. Möchten Sie den Code lieber per Telefon oder per E‑Mail erhalten?
Nein, ich möchte sie nicht teilen
	Aus Sicherheitsgründen benötigen wir weitere Informationen, um Ihre Identität zu bestätigen.
	Der KI-Agent erfasst das Geburtsdatum des Nutzers mithilfe der vordefinierten Komponente Erfassung des Geburtsdatums.
	Okay, Ihr Geburtsdatum ist der 3. Februar 1995, richtig?
Ja
	Wir haben Ihr Geburtsdatum erfasst. Nennen Sie uns bitte die letzten vier Ziffern Ihrer Debitkartennummer.
Es ist 1234
	Gib den Betrag deiner letzten Transaktion an. Wenn der Betrag Ihrer letzten Transaktion beispielsweise 100, 30 € betrug, sagen Sie „100“.
Ich möchte die Details nicht teilen
	Wir konnten dich nicht authentifizieren und die Aktion daher nicht abschließen. Für eventuell entstehende Unannehmlichkeiten bitten wir Sie um Entschuldigung.

Namenskonventionen

Für diese vordefinierte Komponente gelten die folgenden Namenskonventionen:

Funktion	Format	Beispiel
Flow	[Component Name]	Authentifizierung
Komponentenspezifischer Intent	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_authentication_power_of_attorney
Entitätstyp	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_authentication_payment_mode
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_authentication:telephony_verification

Eingabeparameter

Eingabeparameter sind Parameter, mit denen bestimmte Verhaltensweisen der Komponente konfiguriert werden. Die Parameter werden von einer oder mehreren Bedingungen im Ablauf verwendet, um zu bestimmen, wie sich die Komponente verhalten soll. Ablaufbezogene Parameter müssen wie unten beschrieben auf der Startseite der Komponente festgelegt werden. Parameter auf Sitzungsebene können entweder von einem aufrufenden Ablauf oder auf der Startseite dieser Komponente festgelegt werden.

Diese vordefinierte Komponente akzeptiert die folgenden Eingabeparameter:

Parametername	Beschreibung	Eingabeformat
$session.params.auth_level	(Optional) Gibt die aktuelle Authentifizierungsstufe des Endnutzers an.	integer
$session.params.auth_level_req	Definiert die Authentifizierungsebene, auf der der Endnutzer authentifiziert wird. Gültige Werte sind 0, 1 oder 2.	integer
$session.params.account_auth_enabled	Gibt an, ob der Nutzer als Kontoinhaber authentifiziert werden soll. Das Verhalten der Komponente hängt von diesem Wert und dem Wert von $session.params.card_auth_enabled ab, wie unter Authentifizierungsebenen beschrieben.	boolean
$session.params.card_auth_enabled	Gibt an, ob der Nutzer als Karteninhaber authentifiziert werden soll. Das Verhalten der Komponente hängt von diesem Wert und dem Wert von $session.params.account_auth_enabled ab, wie unter Authentifizierungsebenen beschrieben.	boolean
$session.params.phone_number	(Optional) Telefonnummer des Endnutzers. Wenn dieser Parameter nicht angegeben ist, erfasst die Komponente die Telefonnummer des Endnutzers.	String
$flow.max_retry_telephone_counter	Gibt die Anzahl der zulässigen Wiederholungsversuche beim Erfassen der Telefonnummer des Nutzers an. Der Standardwert ist 1.	integer
$flow.max_retry_security_ans_count	Gibt die Anzahl der zulässigen Wiederholungsversuche beim Erfassen von Sicherheitsantworten an. Der Standardwert ist 3.	integer
$flow.max_retry_security_key	Gibt die Anzahl der zulässigen Wiederholungsversuche beim Erfassen des Sicherheitsschlüssels an. Der Standardwert ist 3.	integer
$flow.max_retry_otp_not_received	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn das Einmalpasswort (OTP) nicht empfangen wird. Der Standardwert ist 1.	integer
$flow.max_retry_otp_count	Gibt die Anzahl der zulässigen Wiederholungsversuche beim Erfassen des Einmalpassworts (OTP) an. Der Standardwert ist 3.	integer
$flow.security_ans_denial_count	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn ein Nutzer die angeforderten Informationen nicht angibt. Der Standardwert ist 1.	integer
$flow.security_ans_mid_count	Gibt die Anzahl der falschen Sicherheitsantworten an, die ein Nutzer eingeben kann. Der Standardwert ist 2. Das bedeutet, dass die Komponente mit einem Fehler beendet wird, wenn der Anrufer auf zwei verschiedene Fragen falsche Antworten gibt.	integer
$flow.max_retry_card_counter	Gibt die Anzahl der zulässigen Wiederholungsversuche beim Erfassen der letzten vier Ziffern der Debitkarte des Endnutzers an. Der Standardwert ist 2.	integer
$flow.security_key_length	Gibt die gültige Länge des Sicherheitsschlüssels an, der von der Authentifizierungs-App für die Authentifizierung der Stufe 2 bereitgestellt wird. Der Standardwert ist 6.	integer
$flow.otp_length	Gibt die gültige Länge des Einmalpassworts (OTP) für die Authentifizierung der Stufe 1 an. Der Standardwert ist 6.	integer

Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente einzublenden.

1. Öffnen Sie die Dialogflow CX-Konsole.
2. Wählen Sie Ihr Google Cloud-Projekt aus.
3. Wählen Sie den Agent aus.
4. Wählen Sie den Tab Erstellen aus.
5. Klicken Sie im Bereich Abläufe auf die importierte Komponente.
6. Klicken Sie im Abschnitt Seiten auf die Startseite.
7. Klicken Sie auf der Startseite auf die Route true.
8. Bearbeiten Sie im Fenster „Route“ die Werte für Parametervoreinstellungen nach Bedarf.
9. Klicken Sie auf Speichern.

Ausgabeparameter

Ausgabeparameter sind Sitzungsparameter, die nach dem Verlassen der Komponente aktiv bleiben. Diese Parameter enthalten wichtige Informationen, die von der Komponente erfasst werden. Diese vordefinierte Komponente liefert Werte für die folgenden Ausgabeparameter:

Parametername	Beschreibung	Ausgabeformat
auth_level	Gibt die aktuelle Authentifizierungsebene des Endnutzers an.	integer
phone_number	Die lokale Telefonnummer des Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird.	String
transfer_reason	Dieser Parameter gibt den Grund für das Beenden des Ablaufs an, wenn er nicht erfolgreich war. Der zurückgegebene Wert ist einer der folgenden: agent: Der Endnutzer hat zu einem bestimmten Zeitpunkt während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert. denial_of_information: Der Endnutzer hat sich geweigert, die von der Komponente angeforderten Informationen weiterzugeben. max_no_input: Die Unterhaltung hat die maximale Anzahl von Wiederholungsversuchen für Ereignisse ohne Eingabe erreicht. Weitere Informationen finden Sie unter Integrierte Ereignisse ohne Eingabe. max_no_match: Die maximale Anzahl von Wiederholungsversuchen für Ereignisse ohne Übereinstimmung wurde erreicht. Weitere Informationen finden Sie unter Integrierte Ereignisse für „Keine Übereinstimmung“. webhook_error: Ein Webhook-Fehler ist aufgetreten. Weitere Informationen finden Sie unter Integriertes Ereignis „webhook.error“. webhook_not_found: Eine Webhook-URL war nicht erreichbar. Siehe Integriertes Ereignis „webhook.error.not-found“.	String

Grundlegende Einrichtung

So richten Sie diese vordefinierte Komponente ein:

1. Importieren Sie die vordefinierte Komponente.
2. Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unten im Abschnitt „Webhook-Einrichtung“.

Webhook-Einrichtung

Wenn Sie diese Komponente verwenden möchten, müssen Sie die enthaltenen flexiblen Webhooks so konfigurieren, dass die erforderlichen Informationen von Ihren externen Diensten abgerufen werden.

Bestätigung per Telefon

Der Webhook prebuilt_components_authentication:telephony_verification wird von der Komponente verwendet, um Nutzerkontodetails anhand der angegebenen Telefonnummer abzurufen.

API-Anfrageparameter

Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Die lokale Telefonnummer des Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird.	String

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen, um von der Komponente verwendet zu werden.

Parametername	Beschreibung	Ausgabeformat
account_count	Die Anzahl der Konten, die mit der registrierten Telefonnummer verknüpft sind. Dazu gehören eigene Konten und Konten, für die der Nutzer eine Vollmacht hat.	integer
last_four_digit_of_account_number	Wenn ein Nutzer ein einzelnes Konto hat, werden die letzten vier Ziffern der Kontonummer zurückgegeben. Wenn ein Nutzer mehr als ein Konto hat, ist der Wert dieses Parameters null.	String
E-Mail	Die für das Konto registrierte E‑Mail-Adresse. Wenn für das Konto keine E-Mail-Adresse registriert ist, lautet der Wert dieses Parameters null.	String

Maximieren Sie den Abschnitt, um die Anleitung zum Konfigurieren des Webhooks für die Telefoniebestätigung für diese Komponente einzublenden.

1. Öffnen Sie die Dialogflow CX-Konsole.
2. Wählen Sie Ihr Google Cloud-Projekt aus.
3. Wählen Sie den Agent aus.
4. Wählen Sie den Tab Verwalten.
5. Klicken Sie auf Webhooks.
6. Wählen Sie den Webhook „prebuilt_components_authentication:telephony_verification“ aus.
7. Ersetzen Sie die URL im Dialogflow CX-Feld Webhook-URL durch den Endpunkt für den Dienst, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

Kreditkartendetails abrufen

Der Webhook prebuilt_components_account_services:get_credit_card_details wird von der Komponente verwendet, um Informationen zu den für einen Nutzer registrierten Kreditkarten abzurufen.

API-Anfrageparameter

Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Die lokale Telefonnummer des Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird.	String

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen, um von der Komponente verwendet zu werden.

Parametername	Beschreibung	Ausgabeformat
credit_card_count	Die Anzahl der Kreditkarten, die mit der registrierten Telefonnummer verknüpft sind.	integer
last_four_digit_of_credit_card_number	Wenn ein Nutzer eine einzelne Kreditkarte hat, werden die letzten vier Ziffern der Kartennummer zurückgegeben. Wenn ein Nutzer mehr als eine Karte hat, ist der Wert dieses Parameters null.	String
E-Mail	Die für das Konto registrierte E‑Mail-Adresse. Wenn für das Konto keine E-Mail-Adresse registriert ist, lautet der Wert dieses Parameters null.	String

Maximieren Sie die Anleitung, um den Webhook „Kreditkartendetails abrufen“ für diese Komponente zu konfigurieren.

1. Öffnen Sie die Dialogflow CX-Konsole.
2. Wählen Sie Ihr Google Cloud-Projekt aus.
3. Wählen Sie den Agent aus.
4. Wählen Sie den Tab Verwalten.
5. Klicken Sie auf Webhooks.
6. Wählen Sie den Webhook „prebuilt_components_account_services:get_credit_card_details“ aus.
7. Ersetzen Sie die URL im Dialogflow CX-Feld Webhook-URL durch den Endpunkt für den Dienst, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

OTP senden

Der Webhook prebuilt_components_authentication:send_otp wird von der Komponente verwendet, um ein Einmalpasswort (OTP) an einen registrierten Kanal zu senden, der vom Endnutzer ausgewählt wurde.

API-Anfrageparameter

Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Die lokale Telefonnummer des Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird.	String
$flow.channel	Der Kanal, über den der Nutzer das OTP erhalten möchte. Gültige Werte werden durch die benutzerdefinierte Entität prebuilt_components_authentication_channel definiert. Standardmäßig werden email und mobile unterstützt.	String

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen, um von der Komponente verwendet zu werden.

Parametername	Beschreibung	Ausgabeformat
generated_otp	Der Wert des OTP, das generiert und über den ausgewählten Kanal an den Nutzer gesendet wurde.	String

Maximieren Sie den Abschnitt, um die Anleitung zum Konfigurieren des Webhooks „OTP senden“ für diese Komponente einzublenden.

1. Öffnen Sie die Dialogflow CX-Konsole.
2. Wählen Sie Ihr Google Cloud-Projekt aus.
3. Wählen Sie den Agent aus.
4. Wählen Sie den Tab Verwalten.
5. Klicken Sie auf Webhooks.
6. Wählen Sie den Webhook „prebuilt_components_authentication:send_otp“ aus.
7. Ersetzen Sie die URL im Dialogflow CX-Feld Webhook-URL durch den Endpunkt für den Dienst, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

Sicherheitsantworten

Der Webhook prebuilt_components_authentication:security_answers wird von der Komponente verwendet, um die Sicherheitsantworten des Endnutzers aus seinem registrierten Konto abzurufen.

API-Anfrageparameter

Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Die lokale Telefonnummer des Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird.	String

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen, um von der Komponente verwendet zu werden.

Parametername	Beschreibung	Ausgabeformat
security_last_trans_amount	Gibt den vollen Betrag der letzten Transaktion des Nutzers ohne Währungssymbol an. Wenn der letzte Transaktionsbetrag des Nutzers beispielsweise 100, 30 € beträgt, ist der erwartete Wert dieses Felds "100.30".	String
last_payment_mode	Die Zahlungsmethode, die für die letzte Transaktion des Nutzers verwendet wurde. Gültige Werte werden durch die benutzerdefinierte Entität prebuilt_components_authentication_payment_mode definiert. Standardmäßig sind dies die Werte mobile, upi, online, debit, credit und account.	String
security_card_number	Die letzten vier Ziffern der Debitkartennummer des Nutzers.	String
user_dob	Das Geburtsdatum des Nutzers im Format JJJJ-MM-TT.	String
cards_exp_date_all	Die Ablaufdaten aller für den Nutzer registrierten Kreditkarten im Format MMJJJJ.	Liste (String)

Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren des Webhooks für Sicherheitsantworten für diese Komponente einzublenden.

1. Öffnen Sie die Dialogflow CX-Konsole.
2. Wählen Sie Ihr Google Cloud-Projekt aus.
3. Wählen Sie den Agent aus.
4. Wählen Sie den Tab Verwalten.
5. Klicken Sie auf Webhooks.
6. Wählen Sie den Webhook „prebuilt_components_authentication:security_answers“ aus.
7. Ersetzen Sie die URL im Dialogflow CX-Feld Webhook-URL durch den Endpunkt für den Dienst, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

2-Faktor-Authentifizierung

Der Webhook prebuilt_components_authentication:2fa_validation wird von der Komponente verwendet, um den vom Endnutzer für die 2-Faktor-Authentifizierung bereitgestellten Sicherheitsschlüssel zu validieren.

API-Anfrageparameter

Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Die lokale Telefonnummer des Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird.	String
$flow.security_key	Der vom Endnutzer bereitgestellte Sicherheitsschlüssel, der mit einer Banking-App oder Authentifizierungs-App generiert wurde.	String

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen, um von der Komponente verwendet zu werden.

Parametername	Beschreibung	Ausgabeformat
security_key_verified	Gibt an, ob der vom Endnutzer bereitgestellte Sicherheitsschlüssel gültig ist. true gibt an, dass der bereitgestellte Sicherheitsschlüssel gültig ist. false gibt an, dass der angegebene Sicherheitsschlüssel ungültig ist.	boolean

Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren des validierenden Webhooks für die Zwei-Faktor-Authentifizierung für diese Komponente einzublenden.

1. Öffnen Sie die Dialogflow CX-Konsole.
2. Wählen Sie Ihr Google Cloud-Projekt aus.
3. Wählen Sie den Agent aus.
4. Wählen Sie den Tab Verwalten.
5. Klicken Sie auf Webhooks.
6. Wählen Sie den Webhook „prebuilt_components_authentication:2fa_validation“ aus.
7. Ersetzen Sie die URL im Dialogflow CX-Feld Webhook-URL durch den Endpunkt für den Dienst, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

Abgeschlossen

Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit zum Testen sein.