Vordefinierte Authentifizierungskomponente

Die vorgefertigte Authentifizierungskomponente erfasst Informationen vom Nutzer, um ihn auf der erforderlichen Authentifizierungsebene zu authentifizieren. Diese Komponente deckt Authentifizierungsanforderungen ab, die in der Finanzdienstleistungsbranche üblich sind. In dieser Komponente werden die vorgefertigten Komponenten Erfassung des Ablaufdatums der Kreditkarte, Erfassung des Geburtsdatums und Erfassung der Telefonnummer verwendet, um Nutzerdetails zu erfassen und zu validieren.

Authentifizierungsebenen

Für verschiedene integrierte 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 (einfach) oder Stufe 2 (Multi-Faktor) authentifizieren, wie in der Tabelle „Authentifizierungsstufe“ beschrieben.

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

Unterstützte Nutzertypen

Die Authentifizierungskomponente bietet Unterstützung für Nutzer, die bei einer Bank registriert 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 haben möglicherweise ein oder mehrere Konten oder Karten, die bei der Bank registriert sind.

Authentifizierungstypen

Mit dieser Komponente können Sie konfigurieren, ob ein Nutzer als Kontoinhaber, Karteninhaber oder beides authentifiziert werden soll. Diese Optionen werden konfiguriert, indem die Eingabeparameter $session.params.account_auth_enabled und $session.params.card_auth_enabled festgelegt werden. In dieser Tabelle wird das Verhalten der Komponente 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 bestätigt, dass er ein oder mehrere Konten bei der Bank hat, und Sicherheitsfragen werden beantwortet, z. B. die 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 Sicherheitsfragen beantwortet, z. B. das Ablaufdatum 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 mit Authentifizierung auf Stufe 0. Wenn der Nutzer kein Konto bei der Bank hat, wird geprüft, ob er ein Karteninhaber ist. Wenn der Nutzer eine oder mehrere Kreditkarten bei der Bank hat, authentifiziert die Komponente den Nutzer mit Authentifizierung auf 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 Einmalpasswort, um Kunden zu authentifizieren, die von einer alternativen Telefonnummer anrufen, die nicht in ihrem Konto registriert ist. Wenn ein Nutzer von einer alternativen Telefonnummer anruft, werden Sicherheitsfragen verwendet, um den Anrufer zu authentifizieren.
• Diese Komponente verschlüsselt keine Daten.

Beispieldialoge

Die folgenden Beispieldialoge veranschaulichen gängige Szenarien, die von dieser vordefinierten Komponente abgedeckt werden. Die Beispiel-Dialoge zeigen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dies löst den Standard-Begrüßungs-Intent und die erste Agent-Antwort zu Beginn der Unterhaltung aus.

Erfolgreiche Authentifizierung auf Stufe 1: Einmalpasswort

Der Nutzer wurde bereits für die Authentifizierung auf Stufe 0 authentifiziert. Die Komponente sendet ein Einmalpasswort und fordert den Nutzer auf, es zu bestätigen. Das Einmalpasswort wird an den vom Nutzer ausgewählten Kanal gesendet. Der Nutzer kann ein gültiges Einmalpasswort angeben und wird erfolgreich auf Stufe 1 authentifiziert.

Nutzereingabe	Antwort des KI-Agenten
	Aus Sicherheitsgründen müssen wir Ihre Identität bestätigen. Wir senden Ihnen daher 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. Das kann einige Sekunden dauern. Können Sie den Code bitte bestätigen?
Der Code lautet 123457
	Vielen Dank, Sie wurden erfolgreich authentifiziert.

Erfolgreiche Authentifizierung auf Stufe 1: Sicherheitsfragen

Die Komponente bestätigt die Authentifizierung des Nutzers auf Stufe 0, indem sie die angegebene Telefonnummer erhebt und bestätigt. Die Komponente fragt nach den richtigen Antworten des Nutzers auf drei Sicherheitsfragen und validiert sie: Geburtsdatum, die letzten vier Ziffern der Debitkartennummer des Nutzers und der Betrag der letzten Transaktion. Der Nutzer wurde erfolgreich für Stufe 1 authentifiziert.

Nutzereingabe	Antwort des KI-Agenten
	Sind Sie Kunde unserer Bank oder haben Sie eine Vollmacht? Bitte bestätigen Sie mit Ja oder Nein.
Ja
	Okay, wir benötigen Ihre Telefonnummer, um Ihre Kontodaten abzurufen.
	Der Kundenservicemitarbeiter erfasst die Telefonnummer des Nutzers mit der vordefinierten Komponente Telefonnummer erfassen.
	Ok. Die von Ihnen angegebene Nummer ist [phone], richtig?
Ja
	Gut, wir haben die Telefonnummer erfasst. Okay, aus Sicherheitsgründen benötigen wir noch einige weitere Informationen, um Ihre Identität zu bestätigen.
	Der Agent erhebt das Geburtsdatum des Nutzers mithilfe der vordefinierten Komponente Erhebung des Geburtsdatums.
	Okay, dein Geburtsdatum ist der 3. Februar 1995. Ist das richtig?
Ja
	Gut, wir haben Ihr Geburtsdatum erfasst. Bitte nennen Sie uns die letzten vier Ziffern Ihrer Debitkartennummer.
Sie lautet 1234.
	Bitte teilen Sie uns den Betrag Ihrer letzten Transaktion in US-Dollar mit. Wenn Ihr letzter Transaktionsbetrag beispielsweise 100, 30 $betrug, sagen Sie „100“.
Es waren 500 $.
	Vielen Dank, Sie wurden erfolgreich authentifiziert.

Erfolgreiche Authentifizierung auf Stufe 2: 2-Faktor-Authentifizierung

Der Nutzer wurde bereits für die Authentifizierung auf Stufe 1 authentifiziert. Die Komponente fordert den Nutzer auf, einen Sicherheitsschlüssel über seine Bank oder Authenticator-App zu generieren. Der Nutzer bestätigt den generierten Sicherheitsschlüssel und wird auf Stufe 2 authentifiziert.

Nutzereingabe	Antwort des KI-Agenten
	Bitte teilen Sie uns Ihren Sicherheitsschlüssel mit. Generieren Sie den 6‑stelligen Sicherheitsschlüssel in der App Ihrer Bank oder in Ihrer Authenticator App. Sagen oder geben Sie dann die Ziffern ein.
232425
	Vielen Dank, Sie wurden erfolgreich 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. Wir senden Ihnen daher einen Code. Möchten Sie den Code lieber per Telefon oder per E‑Mail erhalten?
Nein, ich möchte nicht teilen
	Okay, aus Sicherheitsgründen benötigen wir einige weitere Informationen, um Ihre Identität zu bestätigen.
	Der Agent erhebt das Geburtsdatum des Nutzers mithilfe der vordefinierten Komponente Erhebung des Geburtsdatums.
	Okay, dein Geburtsdatum ist der 3. Februar 1995. Ist das richtig?
Ja
	Gut, wir haben Ihr Geburtsdatum erfasst. Bitte nennen Sie uns die letzten vier Ziffern Ihrer Debitkartennummer.
Sie lautet 1234.
	Bitte teilen Sie uns den Betrag Ihrer letzten Transaktion in US-Dollar mit. Wenn Ihr letzter Transaktionsbetrag beispielsweise 100, 30 $betrug, sagen Sie „100“.
Ich möchte die Details nicht teilen
	Wir konnten Sie nicht authentifizieren und können diese Aktion daher nicht ausführen. Für eventuell entstehende Unannehmlichkeiten bitten wir Sie um Entschuldigung.

Namenskonventionen

Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:

Funktion	Format	Beispiel
Flow	[Component Name]	Authentifizierung
Komponentenspezifische Intention	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 werden verwendet, um bestimmte Verhaltensweisen der Komponente zu konfigurieren. Die Parameter werden von einer oder mehreren Bedingungen im Ablauf verwendet, um das Verhalten der Komponente zu bestimmen. Parameter mit Flow-Bereich müssen auf der Startseite der Komponente festgelegt werden, wie unten beschrieben. Parameter mit Sitzungsbereich können entweder durch einen aufrufenden Flow oder auf der Startseite dieser Komponente festgelegt werden.

Diese vorgefertigte Komponente akzeptiert die folgenden Eingabeparameter:

Parametername	Beschreibung	Eingabeformat
$session.params.auth_level	(Optional) Gibt die aktuelle Authentifizierungsebene des Endnutzers an.	integer
$session.params.auth_level_req	Definiert die Authentifizierungsebene, für die der Endnutzer authentifiziert wird. Gültige Werte sind 0, 1 und 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 in 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 in Authentifizierungsebenen beschrieben.	boolean
$session.params.phone_number	Optional: Telefonnummer des Endnutzers. Wenn dieser Parameter nicht angegeben wird, erfasst die Komponente die Telefonnummer vom Endnutzer.	String
$flow.max_retry_telephone_counter	Gibt die Anzahl der Wiederholungsversuche an, die beim Erheben der Telefonnummer des Nutzers zulässig sind. Der Standardwert ist 1.	integer
$flow.max_retry_security_ans_count	Gibt die Anzahl der Wiederholungsversuche an, die beim Erfassen von Sicherheitsantworten zulässig sind. 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 Einmalkennwort 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 Wiederholungsversuche an, die zulässig sind, wenn ein Nutzer die angeforderten Informationen nicht bereitstellt. Der Standardwert ist 1.	integer
$flow.security_ans_mid_count	Gibt die Anzahl der falschen Sicherheitsantworten an, die ein Nutzer geben kann. Der Standardwert ist 2. Das bedeutet, dass die Komponente mit einem Fehler beendet wird, wenn der Aufrufer zwei verschiedene Fragen falsch beantwortet.	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 Authenticator 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 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 aufzurufen.

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 Bereich Seiten auf die Startseite.
7. Klicken Sie auf der Startseite auf die richtige Route.
8. Bearbeiten Sie im Fenster „Route“ die Werte für Parameter-Voreinstellungen nach Bedarf.
9. Klicken Sie auf Speichern.

Ausgabeparameter

Ausgabeparameter sind Sitzungsparameter, die nach dem Beenden 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 das aktuelle Authentifizierungsniveau des Endnutzers an.	integer
phone_number	Die lokale Telefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
transfer_reason	Dieser Parameter gibt den Grund für das Beenden des Ablaufs an, falls er nicht erfolgreich war. Der zurückgegebene Wert ist einer der folgenden: agent: Der Endnutzer hat während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert. denial_of_information: Der Endnutzer hat abgelehnt, von der Komponente angeforderte Informationen weiterzugeben. max_no_input: Die Unterhaltung hat die maximale Anzahl von Wiederholungsversuchen für No-Input-Ereignisse 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 ohne Übereinstimmung. webhook_error: Ein Webhook-Fehler ist aufgetreten. Weitere Informationen finden Sie unter webhook.error (integriertes Ereignis). webhook_not_found: Eine Webhook-URL war nicht erreichbar. Weitere Informationen finden Sie unter webhook.error.not-found (integriertes Ereignis).	String

Grundlegende Einrichtung

So richten Sie diese vordefinierte Komponente ein:

1. Vordefinierte Komponente importieren
2. Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unten unter „Webhook-Einrichtung“.

Webhook-Einrichtung

Um diese Komponente verwenden zu können, müssen Sie die enthaltenen flexiblen Webhooks konfigurieren, um die erforderlichen Informationen von Ihren externen Diensten abzurufen.

Telefoniebestätigung

Der prebuilt_components_authentication:telephony_verification-Webhook 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 Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.

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 mit dem Konto registrierte E‑Mail-Adresse. Wenn für das Konto keine E-Mail-Adresse registriert ist, lautet der Wert dieses Parameters null.	String

Wenn Sie den Webhook für die Telefoniebestätigung für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung aufzurufen.

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 Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie von der Komponente benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
11. Klicken Sie auf Speichern.

Kreditkartendetails abrufen

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

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 Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.

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 nur eine 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 mit dem Konto registrierte E‑Mail-Adresse. Wenn für das Konto keine E-Mail-Adresse registriert ist, lautet der Wert dieses Parameters null.	String

Wenn Sie den Webhook „Kreditkartendetails abrufen“ für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um die Anleitung aufzurufen.

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 Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie von der Komponente benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
11. Klicken Sie auf Speichern.

OTP senden

Der prebuilt_components_authentication:send_otp-Webhook 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 Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
$flow.channel	Der Channel, den der Nutzer für den Empfang des Einmalpassworts ausgewählt hat. 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 und von der Komponente verwendet.

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

Wenn Sie den Webhook zum Senden von Einmalpasswörtern für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung 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 Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie von der Komponente benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
11. Klicken Sie auf Speichern.

Sicherheitsantworten

Der prebuilt_components_authentication:security_answers-Webhook 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 Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.

Parametername	Beschreibung	Ausgabeformat
security_last_trans_amount	Gibt den vollständigen Betrag der letzten Transaktion des Nutzers ohne Währungssymbol an. Wenn der Betrag der letzten Transaktion 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. Die gültigen Werte werden durch die benutzerdefinierte Entität prebuilt_components_authentication_payment_mode definiert. Standardmäßig sind die Werte mobile, upi, online, debit, credit und account enthalten.	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 Kreditkarten, die für den Nutzer registriert sind, im Format MMJJJJ.	Liste (String)

Wenn Sie den Webhook für Sicherheitsantworten für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung aufzurufen.

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 Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie von der Komponente benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
11. Klicken Sie auf Speichern.

2‑Faktor-Bestätigung

Der prebuilt_components_authentication:2fa_validation-Webhook 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 Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
$flow.security_key	Der vom Endnutzer bereitgestellte Sicherheitsschlüssel, der mit einer Banking-App oder Authenticator App generiert wurde.	String

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.

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

Wenn Sie den Webhook für die 2‑Faktor-Validierung für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung aufzurufen.

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 Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie von der Komponente benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
11. Klicken Sie auf Speichern.

Abgeschlossen

Ihr KI‑Agent und seine Webhooks sollten jetzt eingerichtet sein und können getestet werden.