Einige Produkte und Funktionen werden derzeit umbenannt. Auch die Funktionen für generative Playbooks und Workflows werden zu einer einzigen konsolidierten Console migriert. Weitere Informationen

Diese Seite wurde von der Cloud Translation API übersetzt.

Vordefinierte Authentifizierungskomponente

Die vorgefertigte Komponente für die Authentifizierung erhebt Informationen vom Nutzer, um ihn auf der erforderlichen Authentifizierungsebene zu authentifizieren. Diese Komponente deckt Authentifizierungsanforderungen ab, die zwar häufig, aber nicht ausschließlich für die Finanzdienstleistungsbranche gelten. Diese Komponente verwendet die vordefinierten Komponenten Ablaufdatum der Kreditkarte, Geburtsdatum und Telefonnummer, um Nutzerdetails zu erfassen und zu validieren.

Authentifizierungsebenen

Für verschiedene vorgefertigte Komponenten sind mehrere Authentifizierungsebenen erforderlich. Je höher die Ebene, desto mehr Nutzerinformationen sind für die Authentifizierung erforderlich. Mit der Authentifizierungskomponente können sich Nutzer wie in der Tabelle „Authentifizierungsstufe“ beschrieben auf Stufe 0 (ANI-Übereinstimmung), Stufe 1 (einfach) oder Stufe 2 (Multi-Faktor) authentifizieren.

Authentifizierungsebene	Voraussetzungen
Stufe 0: ANI-Abgleich	Der Nutzer wird authentifiziert, indem er von einer Telefonnummer aus anruft oder eine Telefonnummer angibt, die einem registrierten Konto entspricht. Ein Nutzer kann mit der vordefinierten Komponente „Gruß“ auf Stufe 0 authentifiziert werden.
Stufe 1: Einfach	Der Nutzer wird durch Bestätigung eines Einmalpasswort-Codes authentifiziert, 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 geben, um sich erfolgreich zu authentifizieren: Geburtsdatum, die letzten vier Ziffern der Debit- oder Kreditkartennummer des Nutzers oder das Ablaufdatum der Kreditkarte (je nachdem, ob er Kontoinhaber oder Karteninhaber ist), der Betrag der letzten Transaktion und die Zahlungsmethode der letzten Kreditkartenabrechnung.
Stufe 2: Multi-Faktor-Authentifizierung	Der Nutzer wird zusätzlich durch die Bestätigung eines Sicherheitsschlüssels authentifiziert, der von einer externen Authentifizierungs-App oder Push-Benachrichtigung generiert wurde.

Unterstützte Nutzertypen

Die Authentifizierungskomponente unterstützt Nutzer, die als Bankkunden registriert sind und Kontoinhaber, Karteninhaber oder beides sind. Die Komponente unterstützt auch die Authentifizierung von Nutzern, die keine 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 kannst du 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 Komponentenverhalten für verschiedene Kombinationen von Werten für die Flags für die Konto- und Kartenauthentifizierung beschrieben.

account_auth_enabled	card_auth_enabled	Authentifizierungstyp
`true`	`false`	Der Nutzer wird als Kontoinhaber authentifiziert, indem er bestätigt, dass er ein oder mehrere Konten bei der Bank hat, und Sicherheitsfragen beantwortet, einschließlich der letzten vier Ziffern der registrierten Debitkarte.
`false`	`true`	Der Nutzer wird als Karteninhaber authentifiziert, indem er bestätigt, dass er eine oder mehrere Kreditkarten bei der Bank hat, und Sicherheitsfragen beantwortet, einschließlich des Ablaufdatums der 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 von Kontoinformationen. Wenn der Nutzer kein Konto bei der Bank hat, versucht die Komponente, ihn anhand der Karteninhaberdaten 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 der Authentifizierung der Stufe 0. Wenn der Nutzer kein Konto bei der Bank hat, prüft die Komponente, ob er 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 mit 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 Beispieldialogfelder veranschaulichen gängige Szenarien, die von dieser vorgefertigten Komponente verarbeitet werden. Die Beispieldialoge veranschaulichen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dadurch werden der Standard-Begrüßungs-Intent und die erste Antwort des Kundenservicemitarbeiters zu Beginn der Unterhaltung ausgelöst.

Erfolgreiche Authentifizierung der Stufe 1: OTP

Der Nutzer wurde bereits für die Authentifizierung auf Stufe 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 für Level 1 authentifiziert.

Nutzereingabe	Antwort des Kundenservicemitarbeiters
	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. Das kann einige Sekunden dauern. Können Sie bitte den Code bestätigen?
Der Code lautet 123457.
	Vielen Dank. Sie wurden erfolgreich authentifiziert.

Authentifizierung der Stufe 1 erfolgreich: Sicherheitsfragen

Die Komponente bestätigt die Authentifizierung des Nutzers auf Ebene 0, indem sie die angegebene Telefonnummer erfasst und überprüft. 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 ist erfolgreich für Level 1 authentifiziert.

Nutzereingabe	Antwort des Kundenservicemitarbeiters
	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 Kontodetails abzurufen.
	Kundenservicemitarbeiter erfasst die Telefonnummer des Nutzers mithilfe der vorgefertigten Komponente Telefonnummernerfassung
	Alles klar. Die von Ihnen genannte Nummer lautet +1 6502530000. Ist das richtig?
Ja
	Alles klar, wir haben die Telefonnummer erfasst. Okay, aus Sicherheitsgründen benötigen wir noch einige weitere Informationen, um Ihre Identität zu bestätigen.
	Der Kundenservicemitarbeiter erhebt das Geburtsdatum des Nutzers mithilfe der vorgefertigten Komponente Date of birth collection (Erhebung des Geburtsdatums).
	Okay, Ihr Geburtsdatum ist der 3. Februar 1995. Ist das richtig?
Ja
	Sehr gut, wir haben Ihr Geburtsdatum erfasst. Nennen Sie uns bitte die letzten vier Ziffern Ihrer Debitkartennummer.
Es lautet 1234.
	Wie hoch war der Betrag Ihrer letzten Transaktion? Wenn der Betrag Ihrer letzten Transaktion beispielsweise 100, 30 € betrug, sagen Sie „100“.
500 $
	Vielen Dank. Sie wurden erfolgreich authentifiziert.

Erfolgreiche Authentifizierung der Stufe 2: 2-Faktor-Authentifizierung

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

Nutzereingabe	Antwort des Kundenservicemitarbeiters
	Bitte teilen Sie mir Ihren Sicherheitsschlüssel mit. Erstellen Sie den sechsstelligen Sicherheitsschlüssel in Ihrer Banking-App oder Authenticator App. Sagen oder geben Sie dann die Ziffern ein.
232425
	Vielen Dank. Sie wurden erfolgreich authentifiziert.

Verweigerung von Informationen

Der Nutzer lehnt es ab, die für die Authentifizierung erforderlichen Informationen anzugeben. Die Komponente wird mit einer Fehlermeldung beendet.

Nutzereingabe	Antwort des Kundenservicemitarbeiters
	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 nicht teilen
	Okay, aus Sicherheitsgründen benötigen wir noch einige Informationen, um Ihre Identität zu bestätigen.
	Der Kundenservicemitarbeiter erhebt das Geburtsdatum des Nutzers mithilfe der vorgefertigten Komponente Date of birth collection (Erhebung des Geburtsdatums).
	Okay, Ihr Geburtsdatum ist der 3. Februar 1995. Ist das richtig?
Ja
	Sehr gut, wir haben Ihr Geburtsdatum erfasst. Nennen Sie uns bitte die letzten vier Ziffern Ihrer Debitkartennummer.
Es lautet 1234.
	Bitte geben Sie den Betrag Ihrer letzten Transaktion in US-Dollar an. Wenn der Betrag Ihrer letzten Transaktion beispielsweise 100, 30 € betrug, sagen Sie „100“.
Ich möchte die Details nicht teilen
	Wir konnten Sie nicht authentifizieren. Daher können wir diese Aktion 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
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

Mit Eingabeparametern werden bestimmte Verhaltensweisen der Komponente konfiguriert. Die Parameter werden von einer oder mehreren Bedingungen innerhalb des Ablaufs verwendet, um zu bestimmen, wie sich die Komponente verhalten soll. Parameter auf Ablaufebene müssen wie unten beschrieben auf der Startseite der Komponente festgelegt werden. Parameter auf Sitzungsebene können entweder über einen Aufrufablauf 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 Authentifizierungsebene des Endnutzers an.	integer
$session.params.auth_level_req	Hier wird die Authentifizierungsebene definiert, mit 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, wird die Telefonnummer vom Endnutzer erfasst.	String
$flow.max_retry_telephone_counter	Gibt die Anzahl der zulässigen Wiederholungen an, wenn die Telefonnummer des Nutzers erfasst wird. 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 Abrufen 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 Wiederholungen an, wenn ein Nutzer die angeforderten Informationen nicht angibt. Der Standardwert ist `1`.	integer
$flow.security_ans_mid_count	Gibt an, wie viele falsche Sicherheitsantworten ein Nutzer geben 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 Wiederholungen 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 (OTP) für die Authentifizierung der Stufe 1 an. Der Standardwert ist `6`.	integer

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

Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Erstellen aus.
Klicken Sie im Bereich Abläufe auf die importierte Komponente.
Klicken Sie im Bereich Seiten auf die Startseite.
Klicken Sie auf der Startseite auf die Route true.
Bearbeiten Sie im Fenster „Route“ die Werte für die Parametervorgaben nach Bedarf.
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 Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
transfer_reason	Dieser Parameter gibt den Grund an, warum der Ablauf beendet wurde, falls er nicht erfolgreich war. Der zurückgegebene Wert kann einer der folgenden sein: `agent`: Der Endnutzer hat während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert. `denial_of_information`: Der Endnutzer hat die von der Komponente angeforderten Informationen abgelehnt. `max_no_input`: Die Unterhaltung hat die maximale Anzahl von Wiederholungen für No-Input-Ereignisse erreicht. Weitere Informationen finden Sie unter Ereignisse ohne Eingabe. `max_no_match`: Die maximale Anzahl von Wiederholungen für Ereignisse ohne Übereinstimmung wurde für die Unterhaltung erreicht. Weitere Informationen finden Sie unter Integrierte Ereignisse ohne Übereinstimmung. `webhook_error`: Ein Webhook-Fehler ist aufgetreten. Weitere Informationen finden Sie unter Vordefiniertes Ereignis „webhook.error“. `webhook_not_found`: Eine Webhook-URL war nicht erreichbar. Weitere Informationen finden Sie unter Vordefiniertes Ereignis „webhook.error.not-found“.	String

Grundlegende Einstellungen

So richten Sie diese vorkonfigurierte Komponente ein:

Importieren Sie die vordefinierte Komponente.
Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unten unter „Webhook einrichten“.

Webhook-Einrichtung

Wenn Sie diese Komponente verwenden möchten, müssen Sie die enthaltenen flexiblen Webhooks konfigurieren, um die erforderlichen Informationen aus Ihren externen Diensten abzurufen.

Telefonische Bestätigung

Über den prebuilt_components_authentication:telephony_verification-Webhook werden von der Komponente Nutzerkontodetails anhand der angegebenen Telefonnummer abgerufen.

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 Ortstelefonnummer 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 nur ein Konto hat, werden die letzten vier Ziffern der Kontonummer zurückgegeben. Wenn ein Nutzer mehrere Konten 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

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

Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Webhooks.
Wählen Sie den Webhook „prebuilt_components_authentication:telephony_verification“ aus.
Ersetzen Sie die URL im Feld Webhook-URL für Konversations-Agents (Dialogflow CX) durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
Prüfen und aktualisieren Sie den Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
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 zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
Klicken Sie auf Speichern.

Kreditkartendetails abrufen

Über den prebuilt_components_account_services:get_credit_card_details-Webhook erhält die Komponente Informationen zu den für einen Nutzer registrierten Kreditkarten.

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 Ortstelefonnummer 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

Maximieren Sie die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Get credit card details“ (Kreditkartendetails abrufen) für diese Komponente aufzurufen.

Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Webhooks.
Wählen Sie den Webhook „prebuilt_components_account_services:get_credit_card_details“ aus.
Ersetzen Sie die URL im Feld Webhook-URL für Konversations-Agents (Dialogflow CX) durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
Prüfen und aktualisieren Sie den Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
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 zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
Klicken Sie auf Speichern.

OTP senden

Über den prebuilt_components_authentication:send_otp-Webhook sendet die Komponente ein Einmalpasswort (OTP) an einen registrierten Kanal, 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 Ortstelefonnummer des Nutzers ohne Landesvorwahl, 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 das benutzerdefinierte Element `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 OTP, der generiert und über den ausgewählten Kanal an den Nutzer gesendet wird.	String

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Send OTP“ für diese Komponente aufzurufen.

Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Webhooks.
Wählen Sie den Webhook „prebuilt_components_authentication:send_otp“ aus.
Ersetzen Sie die URL im Feld Webhook-URL für Konversations-Agents (Dialogflow CX) durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
Prüfen und aktualisieren Sie den Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
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 zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
Klicken Sie auf Speichern.

Sicherheitsantworten

Über den prebuilt_components_authentication:security_answers-Webhook ruft die Komponente die Sicherheitsantworten des Endnutzers aus seinem registrierten Konto ab.

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 Ortstelefonnummer 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	Der vollständige Betrag der letzten Transaktion des Nutzers ohne Währungssymbol. Wenn der Wert 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, mit gültigen Werten, die von der benutzerdefinierten Entität `prebuilt_components_authentication_payment_mode` definiert wurden. Standardmäßig sind dies `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 beim Nutzer registrierten Kreditkarten im Format MMJJJJ.	Liste (String)

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

Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Webhooks.
Wählen Sie den Webhook „prebuilt_components_authentication:security_answers“ aus.
Ersetzen Sie die URL im Feld Webhook-URL für Konversations-Agents (Dialogflow CX) durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
Prüfen und aktualisieren Sie den Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
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 zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
Klicken Sie auf Speichern.

Bestätigung in zwei Schritten

Der prebuilt_components_authentication:2fa_validation-Webhook wird von der Komponente verwendet, um den vom Endnutzer für die Zwei-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 Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
$flow.security_key	Der vom Endnutzer bereitgestellte Sicherheitsschlüssel, der mit einer Bank- oder Authentifizierungs-App generiert wird.	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 angegebene Sicherheitsschlüssel des Endnutzers 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

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks für die Bestätigung in zwei Schritten für diese Komponente aufzurufen.

Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Webhooks.
Wählen Sie den Webhook „prebuilt_components_authentication:2fa_validation“ aus.
Ersetzen Sie die URL im Feld Webhook-URL für Konversations-Agents (Dialogflow CX) durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
Prüfen und aktualisieren Sie den Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
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 zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
Klicken Sie auf Speichern.

Abgeschlossen

Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.

Zurück

Termin vereinbaren

Weiter

Authentifizierung (Einzelhandel)