Die vordefinierte Komponente für die Authentifizierung erfasst vom Nutzer Informationen, um ihn bei der erforderlichen Authentifizierungsebene zu authentifizieren. Diese Komponente deckt Authentifizierungsanforderungen ab, die in der Finanzdienstleistungsbranche (FSI) üblich sind, aber nicht ausschließlich. Diese Komponente verwendet die vordefinierten Komponenten für das Erheben des Ablaufdatums der Kreditkarte, das Erheben des Geburtsdatums und die Erfassung der Telefonnummer, um Nutzerdetails zu erheben und zu validieren.
Authentifizierungsebenen
Für die verschiedenen vordefinierten Komponenten sind mehrere Authentifizierungsebenen erforderlich. Höhere Ebenen erfordern mehr Nutzerinformationen zur Authentifizierung des Nutzers. Mit der Authentifizierungskomponente können sich Nutzer bei Level 0 (ANI-Übereinstimmung), Level 1 (Basic) oder Level 2 (Multi-Faktor) authentifizieren, wie in der Tabelle mit den Authentifizierungsebenen beschrieben.
| Authentifizierungsstufe | Voraussetzungen |
|---|---|
| Ebene 0: ANI-Übereinstimmung | Der Nutzer wird authentifiziert, indem er anruft oder eine Telefonnummer angibt, die einem registrierten Konto entspricht. Ein Nutzer kann mithilfe der vordefinierten Komponente für Begrüßung bei Ebene 0 authentifiziert werden. |
| Stufe 1: Einfach | Der Nutzer wird durch Bestätigung eines Einmalpassworts (OTP) authentifiziert, der an seine E-Mail-Adresse oder Telefonnummer gesendet wurde. Wenn die OTP-Überprüfung fehlschlägt, kann der Nutzer drei von vier Sicherheitsfragen beantworten, um sich erfolgreich zu authentifizieren: Geburtsdatum (Geburtsdatum), letzte vier Ziffern des Ablaufdatums der Debit- oder Kreditkarte des Nutzers (je nachdem, ob er Konto- oder Karteninhaber ist), den Betrag der letzten Transaktion und die Zahlungsmethode der letzten Kreditkartenrechnung. |
| Stufe 2: Multi-Faktor-Authentifizierung | Der Nutzer wird zusätzlich durch Bestätigung eines Sicherheitsschlüssels authentifiziert, 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, die 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, als Karteninhaber oder als beides authentifiziert werden soll. Zum Konfigurieren dieser Optionen werden die Eingabeparameter $session.params.account_auth_enabled und $session.params.card_auth_enabled festgelegt. In dieser Tabelle wird das Komponentenverhalten für verschiedene Wertekombinationen für die Flags zur Kontoauthentifizierung und Kartenauthentifizierung beschrieben.
| account_auth_enabled | card_auth_enabled | Authentifizierungstyp |
|---|---|---|
true |
false |
Der Nutzer wird als Kontoinhaber authentifiziert, um zu bestätigen, dass er ein oder mehrere Konten bei der Bank besitzt. Außerdem werden Sicherheitsfragen bestätigt, einschließlich der letzten vier Ziffern der registrierten Debitkarte. |
false |
true |
Der Nutzer wird als Karteninhaber authentifiziert, um bei der Bank nachzuweisen, dass er über eine oder mehrere Kreditkarten verfügt. Außerdem werden Sicherheitsfragen bestätigt, 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 keine Konten bei der Bank hat, versucht die Komponente, den Nutzer anhand von 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 für die Level-0-Authentifizierung. Wenn der Nutzer keine Konten 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 für die Level-0-Authentifizierung. |
Beschränkungen
Neben 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 wurden. Die Komponente verwendet kein OTP, um Kunden zu authentifizieren, die von einer anderen Telefonnummer aus anrufen, die nicht in ihrem Konto registriert ist. Wenn ein Nutzer von einer anderen Telefonnummer anruft, werden Sicherheitsfragen zur Authentifizierung des Anrufers verwendet.
- Diese Komponente verschlüsselt keine Daten.
Beispieldialoge
Die folgenden Beispieldialogfelder zeigen gängige Szenarien, in denen diese vordefinierte Komponente verwendet wird. Die Beispieldialogfelder veranschaulichen das Verhalten, wenn die Komponente über Telefonie aufgerufen wird. Dadurch werden der Standard-Begrüßungs-Intent und die erste Agent-Antwort zu Beginn der Unterhaltung ausgelöst.
Level 1 – Authentifizierung erfolgreich: OTP
Der Nutzer wurde zuvor bei der Authentifizierung der Stufe 0 authentifiziert. Die Komponente sendet den Nutzer und fordert ihn auf, ein OTP zu bestätigen, das an den vom Nutzer ausgewählten Kanal gesendet wurde. Der Nutzer kann ein gültiges OTP angeben und ist bei Level 1 authentifiziert.
| Nutzereingabe | Agent-Antwort |
|---|---|
| Aus Sicherheitsgründen müssen wir deine Identität überprüfen. Daher senden wir dir einen Code. Möchtest du den Code lieber per Telefon oder E-Mail erhalten? | |
| Telefon | |
| Wir haben einen Code an Ihre registrierte Telefonnummer mit den Endziffern 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. |
Stufe 1 Authentifizierung erfolgreich: Sicherheitsfragen
Die Komponente bestätigt die Authentifizierung des Nutzers auf Ebene 0, indem die angegebene Telefonnummer erfasst und verifiziert wird. Die Komponente fragt nach den richtigen Antworten des Nutzers auf drei Sicherheitsfragen: Geburtsdatum, letzte vier Ziffern der Debitkartennummer des Nutzers und Betrag der letzten Transaktion. Der Nutzer ist bei Level 1 authentifiziert.
| Nutzereingabe | Agent-Antwort |
|---|---|
| Sind Sie Kunde unserer Bank oder haben Sie eine Vollmacht? Bitte bestätige das, indem du „Ja“ oder „Nein“ sagst. | |
| Ja | |
| Wir benötigen deine Telefonnummer, um deine Kontodetails abzurufen. | |
| Der Kundenservicemitarbeiter erfasst die Telefonnummer des Nutzers mithilfe der vordefinierten Komponente für die Erfassung der Telefonnummer | |
| Alles klar. Die von Ihnen genannte Nummer lautet „Plus 1 6502530000“, ist das richtig? | |
| Ja | |
| Die Erfassung der Telefonnummer ist abgeschlossen. Okay, aus Sicherheitsgründen benötigen wir noch einige Informationen, um Ihre Identität zu bestätigen. |
|
| Der Kundenservicemitarbeiter erfasst das Geburtsdatum des Nutzers mithilfe der vordefinierten Komponente für die Erfassung des Geburtsdatums | |
| Okay, dein Geburtsdatum ist der 3. Februar 1995, ist das richtig? | |
| Ja | |
| Sehr gut, wir haben dein Geburtsdatum erfasst. Bitte nenne uns die letzten vier Ziffern deiner Debitkartennummer. |
|
| Es ist 1.234 | |
| Bitte teilen Sie uns den Betrag Ihrer letzten Transaktion mit. Wenn der letzte Transaktionsbetrag beispielsweise 100, 30 € betrug, sagen Sie „100“. | |
| Es waren 500 Dollar | |
| Vielen Dank, Sie wurden erfolgreich authentifiziert. |
Level-2-Authentifizierung erfolgreich: 2-Faktor-Authentifizierung
Der Nutzer wurde zuvor bei der Authentifizierung der Stufe 1 authentifiziert. Die Komponente fordert den Nutzer auf, mithilfe seiner Bank oder Authentifizierungsanwendung einen Sicherheitsschlüssel zu generieren. Der Nutzer bestätigt den generierten Sicherheitsschlüssel und wird für Level 2 authentifiziert.
| Nutzereingabe | Agent-Antwort |
|---|---|
| Bitte teile deinen Sicherheitsschlüssel. Generiere den sechsstelligen Sicherheitsschlüssel in der App deiner Bank oder Authentifizierungs-App. Sage dann die Ziffern oder gib sie ein. |
|
| 232425 | |
| Vielen Dank, Sie wurden erfolgreich authentifiziert. |
Leugnung von Informationen
Der Nutzer lehnt die Angabe von Informationen ab, die zur Authentifizierung erforderlich sind. Die Komponente wird mit einer Fehlermeldung beendet.
| Nutzereingabe | Agent-Antwort |
|---|---|
| Aus Sicherheitsgründen müssen wir deine Identität überprüfen. Daher senden wir dir einen Code. Möchtest du den Code lieber per Telefon oder E-Mail erhalten? | |
| Nein, ich möchte keine Informationen teilen | |
| Okay. Aus Sicherheitsgründen benötigen wir weitere Informationen, um Ihre Identität zu bestätigen. | |
| Der Kundenservicemitarbeiter erfasst das Geburtsdatum des Nutzers mithilfe der vordefinierten Komponente für die Erfassung des Geburtsdatums | |
| Okay, dein Geburtsdatum ist der 3. Februar 1995, ist das richtig? | |
| Ja | |
| Sehr gut, wir haben dein Geburtsdatum erfasst. Bitte nenne uns die letzten vier Ziffern deiner Debitkartennummer. |
|
| Es ist 1.234 | |
| Bitte teilen Sie uns den Betrag Ihrer letzten Transaktion mit. Wenn der letzte Transaktionsbetrag beispielsweise 100, 30 € betrug, sagen Sie „100“. | |
| Ich möchte keine Details teilen | |
| Wir konnten Sie nicht authentifizieren, daher können wir diese Aktion nicht abschließen. Für eventuell entstehende Unannehmlichkeiten bitten wir Sie um Entschuldigung. |
Namenskonventionen
Diese vordefinierte Komponente verwendet die folgenden Namenskonventionen:
| Funktion | Format | Beispiel |
|---|---|---|
| Fluss | [Komponentenname] | 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 das Verhalten der Komponente zu bestimmen. Ablaufbezogene Parameter müssen wie unten beschrieben auf der Startseite der Komponente festgelegt werden. Parameter auf Sitzungsebene können entweder durch einen 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 Authentifizierungsstufe, bei der 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 $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 $session.params.account_auth_enabled ab, wie unter 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 zulässigen Wiederholungsversuche 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 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 Bereitstellung der angeforderten Informationen ablehnt. 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 an, wenn die letzten vier Ziffern der Debitkarte des Endnutzers erfasst werden. 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 auf 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 |
Wenn Sie die Eingabeparameter für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um weitere Anweisungen zu erhalten.
- Ö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 Build aus.
- Klicken Sie im Abschnitt Abläufe auf die importierte Komponente.
- Klicken Sie im Bereich Seiten auf die Startseite.
- Klicken Sie auf der Startseite auf die true-Route.
- Bearbeiten Sie im Fenster „Route“ die Werte unter Parameter Presets (Parametervoreinstellungen).
- 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 stellt Werte für die folgenden Ausgabeparameter bereit:
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| auth_level | Gibt die aktuelle Authentifizierungsstufe des Endnutzers an. | integer |
| phone_number | Die lokale Telefonnummer des Nutzers ohne Ländervorwahl, mit der er identifiziert werden kann. | String |
| transfer_reason | Dieser Parameter gibt den Grund an, warum der Ablauf beendet wurde, falls er nicht erfolgreich war. Folgender Wert wird zurückgegeben:agent: Der Endnutzer hat während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert.denial_of_information: Der Endnutzer hat die Weitergabe der von der Komponente angeforderten Informationen abgelehnt.max_no_input: Für die Unterhaltung wurde die maximale Anzahl von Wiederholungen für Ereignisse ohne Eingabe erreicht. Integrierte Ereignisse ohne Eingabe ansehen.max_no_match: Für die Unterhaltung wurde die maximale Anzahl von Wiederholungen für Ereignisse ohne Übereinstimmung erreicht. Weitere Informationen finden Sie unter Integrierte No-Match-Ereignisse.webhook_error: Ein Webhook-Fehler ist aufgetreten. Siehe integriertes Ereignis „webhook.error“. webhook_not_found: Eine Webhook-URL war nicht erreichbar. Weitere Informationen finden Sie unter Integriertes Ereignis „webhook.error.not-found“. |
String |
Grundlegende Einstellungen
So richten Sie diese vordefinierte Komponente ein:
- Importieren Sie die vordefinierte Komponente.
- Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dialogflow-Dienste beschreibt. Weitere Informationen finden Sie unten im Abschnitt „Webhook-Einrichtung“.
Webhook-Einrichtung
Damit Sie diese Komponente verwenden können, müssen Sie die enthaltenen flexiblen Webhooks so konfigurieren, dass die erforderlichen Informationen von Ihren externen Diensten abgerufen werden.
Überprüfung der Telefonie
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ändervorwahl, mit der er identifiziert werden kann. | 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 der registrierten Telefonnummer zugeordnet 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 mehr als ein Konto hat, lautet der Wert dieses Parameters null. |
String |
| E‑Mail | Die für das Konto registrierte E-Mail-Adresse. Wenn für dieses Konto keine E-Mail-Adresse registriert ist, lautet der Wert dieses Parameters null. |
String |
Wenn Sie den Webhook für die Telefonieüberprüfung für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um eine Anleitung zu sehen.
- Ö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 (Webhook-URL) in Dialogflow durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen Sie den Anfragetext und ändern Sie ihn so, dass er das richtige Anfrageformat für den Webhook bildet.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort des Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie für die Komponente erforderlich sind, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
- 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ändervorwahl, mit der er identifiziert werden kann. | 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 der registrierten Telefonnummer zugeordnet 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, lautet der Wert dieses Parameters null. |
String |
| E‑Mail | Die für das Konto registrierte E-Mail-Adresse. Wenn für dieses 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 eine Anleitung zu sehen.
- Ö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 (Webhook-URL) in Dialogflow durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen Sie den Anfragetext und ändern Sie ihn so, dass er das richtige Anfrageformat für den Webhook bildet.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort des Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie für die Komponente erforderlich sind, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
- 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 wird.
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ändervorwahl, mit der er identifiziert werden kann. | String |
| $flow.channel | Der Kanal, den der Nutzer für den Erhalt des OTP 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 | Wert des OTP, das über den ausgewählten Kanal generiert und an den Nutzer gesendet wurde. | String |
Wenn Sie den Webhook zum Senden des OTP für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um Anweisungen zu erhalten.
- Ö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 (Webhook-URL) in Dialogflow durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen Sie den Anfragetext und ändern Sie ihn so, dass er das richtige Anfrageformat für den Webhook bildet.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort des Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie für die Komponente erforderlich sind, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
- 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ändervorwahl, mit der er identifiziert werden kann. | 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 letzte Transaktionsbetrag des Nutzers beispielsweise 100, 30 € beträgt, wird in diesem Feld "100.30" erwartet. |
String |
| last_payment_mode | Die Zahlungsmethode, die für die letzte Transaktion des Nutzers verwendet wurde. Gültige Werte sind durch die benutzerdefinierte Entität prebuilt_components_authentication_payment_mode definiert. Standardmäßig sind diese 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 beim Nutzer registrierten Kreditkarten im Format MMJJJJ. | Liste (String) |
Wenn Sie den Webhook „Sicherheitsantworten“ für diese Komponente konfigurieren möchten, maximieren Sie die Anleitung.
- Ö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 (Webhook-URL) in Dialogflow durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen Sie den Anfragetext und ändern Sie ihn so, dass er das richtige Anfrageformat für den Webhook bildet.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort des Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie für die Komponente erforderlich sind, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
- Klicken Sie auf Speichern.
2-Faktor-Validierung
Der Webhook prebuilt_components_authentication:2fa_validation wird von der Komponente verwendet, um den vom Endnutzer für die Bestätigung in zwei Schritten 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ändervorwahl, mit der er identifiziert werden kann. | String |
| $flow.security_key | Der vom Endnutzer bereitgestellte Sicherheitsschlüssel, der mit einer Bank- oder Authentifizierungs-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 |
Um den Webhook für die Bestätigung in zwei Schritten für diese Komponente zu konfigurieren, maximieren Sie den Abschnitt, um Anweisungen zu erhalten.
- Ö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 (Webhook-URL) in Dialogflow durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen Sie den Anfragetext und ändern Sie ihn so, dass er das richtige Anfrageformat für den Webhook bildet.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort des Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie für die Komponente erforderlich sind, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
- Klicken Sie auf Speichern.
Fertig
Der Agent und seine Webhooks sollten jetzt eingerichtet und bereit zum Testen sein.