Die vordefinierte Komponente für die Einzelhandelsauthentifizierung erfasst Informationen, um Ihren Kunden auf der erforderlichen Authentifizierungsebene zu authentifizieren. Diese vordefinierte Komponente deckt Authentifizierungsanforderungen ab, die im Einzelhandel üblich, aber nicht ausschließlich dort zu finden sind. Dabei wird die vordefinierte Komponente Telefonnummernerfassung verwendet, um die Telefonnummer des Kunden zu erfassen und zu validieren.
Authentifizierungsebenen
Für verschiedene vordefinierte Komponenten sind mehrere Authentifizierungsebenen erforderlich, wobei für höhere Ebenen mehr Nutzerinformationen erforderlich sind. Mit der Einzelhandelsauthentifizierungskomponente kann sich der Nutzer auf Ebene 0 (ANI-Abgleich) oder Ebene 1 (Basic) authentifizieren, wie in der folgenden Tabelle beschrieben.
| Authentifizierungsebene | Voraussetzungen |
|---|---|
| Stufe 0: ANI-Abgleich | 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. |
Unterstützte Nutzertypen
Die Einzelhandelsauthentifizierungskomponente unterstützt Nutzer mit einer registrierten Telefonnummer und E‑Mail-Adresse.
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 Kunden registriert wurde. Die Komponente verwendet kein OTP, um Kunden zu authentifizieren, die von einer alternativen Telefonnummer anrufen, die nicht im Konto registriert ist. Wenn der Nutzer von einer alternativen Telefonnummer aus anruft, verwendet das System Sicherheitsfragen, um ihn zu authentifizieren.
- Diese Komponente verschlüsselt keine Daten.
Beispieldialoge verfassen
Diese Beispieldialoge zeigen gängige Szenarien, die von der vordefinierten Komponente verarbeitet werden. Sie zeigen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dadurch werden der Standard-Willkommens-Intent und die erste Antwort des KI-Agenten zu Beginn der Unterhaltung ausgelöst.
Authentifizierung auf Stufe 0 erfolgreich: ANI-Übereinstimmung
Der Nutzer ruft von einer Telefonnummer an, die für ein bestehendes Konto registriert ist, bestätigt seine Identität und authentifiziert sich erfolgreich auf Stufe 0.
| Nutzereingabe | Antwort des KI-Agenten |
|---|---|
| Hallo, die von Ihnen gewählte Nummer ist mit dem Konto von John verknüpft. Haben Sie Fragen zur Bestellung einer anderen Person? Bitte antworte mit „Ja“, wenn das der Fall ist, andernfalls mit „Nein“. | |
| Nein | |
| Vielen Dank, John. Ihre Identität wurde bestätigt. |
Authentifizierung auf Stufe 1 erfolgreich: OTP
- Der Nutzer ruft von einer unbekannten Telefonnummer an.
- Die Komponente erfasst die registrierte Telefonnummer des Nutzers, sendet ein OTP an den vom Nutzer ausgewählten Kanal und bittet ihn, dieses zu bestätigen.
- Der Nutzer gibt ein gültiges OTP an und authentifiziert sich erfolgreich für Level 1.
| Nutzereingabe | Antwort des KI-Agenten |
|---|---|
| Wir konnten diese Telefonnummer nicht in unseren Systemen finden. Bitte teilen Sie uns die registrierte Telefonnummer mit. | |
| Der Agent erfasst die Telefonnummer mithilfe der vordefinierten Komponente Erfassung von Telefonnummern. | |
| Die Telefonnummer wurde erfasst. 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 | |
| Möchten Sie das OTP auf Ihrem Smartphone erhalten? Bitte antworte mit „Ja“ oder „Nein“. | |
| Ja | |
| Wir haben einen Code an deine registrierte Telefonnummer mit der Endung 0000 gesendet. Dies kann einige Sekunden dauern. Können Sie den Code bitte bestätigen? | |
| 123457 | |
| Vielen Dank, John. Ihre Identität wurde bestätigt. |
Namenskonventionen
Für diese vordefinierte Komponente gelten die folgenden Namenskonventionen:
| Funktion | Format | Beispiel |
|---|---|---|
| Flow | [Component Name] | Retail Authentication |
| Komponentenspezifischer Intent | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_retail_authentication_incorrect_phone_number |
| Entitätstyp | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_channel_email_phone |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_retail_authentication:verify_user_details |
Eingabeparameter
Mit Eingabeparametern wird das Verhalten der Komponente konfiguriert. Eine oder mehrere Bedingungen im Ablauf verwenden die Parameter, um das Verhalten der Komponente zu bestimmen. Der Nutzer muss auf der Startseite dieser Komponente Parameter für den Ablauf festlegen. Sie können Parameter auf Sitzungsebene entweder über einen aufrufenden Ablauf oder auf der Startseite dieser Komponente festlegen.
Diese vordefinierte Komponente akzeptiert die folgenden Eingabeparameter:
| Parametername | Beschreibung | Eingabeformat |
|---|---|---|
| $session.params.auth_level_req | Definiert die Authentifizierungsebene, auf der der Nutzer authentifiziert wird. Gültige Werte sind 0 und 1. |
integer |
| $session.params.auth_level | (Optional) Gibt die aktuelle Authentifizierungsebene des Nutzers an. | integer |
| $session.params.phone_number | (Optional) Telefonnummer des Nutzers. Wenn dieser Parameter nicht angegeben ist, wird die Telefonnummer des Nutzers von der Komponente erfasst. | String |
| $flow.max_retry_phone_number | Gibt die Anzahl der zulässigen Wiederholungsversuche beim Erfassen der Telefonnummer des Nutzers an. Der Standardwert ist 3. |
integer |
| $flow.max_retry_otp | Gibt die Anzahl der zulässigen Wiederholungsversuche beim Erfassen des Einmalpassworts (OTP) 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_confirm_channel | Gibt die Anzahl der zulässigen Wiederholungsversuche beim Abrufen des Kanals zum Empfangen des Einmalpassworts (OTP) an. Der Standardwert ist 3. |
integer |
Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente einzublenden.
- Öffnen Sie die Dialogflow CX-Konsole.
- 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 Abschnitt Seiten auf die Startseite.
- Klicken Sie auf der Startseite auf die Route true.
- Bearbeiten Sie im Fenster „Route“ die Werte für Parametervoreinstellungen nach Bedarf.
- Klicken Sie auf Speichern.
Ausgabeparameter
Ausgabeparameter sind Sitzungsparameter, die aktiv bleiben, nachdem der Nutzer die Komponente verlassen hat. 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 Nutzers an. | integer |
| all_recent_order_id | Dieser Parameter listet die Bestell-IDs auf, die dem authentifizierten Nutzer zugeordnet sind, sortiert nach dem Datum der Bestellung in absteigender Reihenfolge. Das erste Element des Arrays stellt die letzte Bestellung dar. Wenn ein Nutzer keine Bestellungen hat, ist der Wert dieses Parameters null. |
Liste (String) |
| phone_number | Die lokale Telefonnummer des Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird. | String |
| Die mit dem Konto verknüpfte E‑Mail-Adresse. | String | |
| user_first_name | Vorname des Nutzers, der zur Begrüßung und Bestätigung der Inhaberschaft des Kontos 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 Nutzer hat zu einem bestimmten Zeitpunkt während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert.denial_of_information: Der Nutzer 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:
- Importieren Sie die vordefinierte Komponente.
- Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unter Webhook-Einrichtung.
Webhook-Einrichtung
Um diese Komponente zu verwenden, muss der Nutzer die enthaltenen flexiblen Webhooks konfigurieren, um die erforderlichen Informationen von seinen externen Diensten abzurufen.
Nutzerdetails bestätigen
Der Webhook prebuilt_components_retail_authentication:verify_user_details ruft Nutzerkontodetails anhand der angegebenen Telefonnummer ab.
API-Anfrageparameter
Die Komponente stellt die folgenden Parameter als Eingaben für die API-Anfrage bereit:
| 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 Komponente ruft die folgenden Parameter aus der API-Antwort ab:
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| Die mit dem Konto verknüpfte E‑Mail-Adresse. | String | |
| all_recent_order_id | Liste der Bestell-IDs, die mit dem authentifizierten Nutzer verknüpft sind, sortiert nach dem Datum der Bestellung in absteigender Reihenfolge. Das erste Element des Arrays stellt die letzte Bestellung dar. Wenn ein Nutzer keine Bestellungen hat, ist der Wert dieses Parameters null. |
Liste (String) |
| user_first_name | Vorname des Nutzers, der zur Begrüßung und Bestätigung der Inhaberschaft des Kontos verwendet wird. | String |
Maximieren Sie den Bereich, um eine Anleitung zum Konfigurieren des Webhooks „Nutzerdetails bestätigen“ für diese Komponente zu erhalten.
- Öffnen Sie die Dialogflow CX-Konsole.
- 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_retail_authentication:verify_user_details“ aus.
- 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.
- Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
- Überprü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.
- Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
- Klicken Sie auf Speichern.
OTP senden
Die Komponente verwendet den Webhook prebuilt_components_retail_authentication:send_otp, um ein Einmalpasswort (OTP) an einen registrierten Kanal zu senden, der vom Nutzer ausgewählt wurde.
API-Anfrageparameter
Die Komponente stellt die folgenden Parameter als Eingaben für die API-Anfrage bereit:
| 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_channel_email_phone definiert. Standardmäßig werden email und phone unterstützt. |
String |
API-Antwortparameter
Die Komponente ruft die folgenden Parameter aus der API-Antwort ab:
| 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 diesen Abschnitt, um die Anleitung zum Konfigurieren des Webhooks „OTP senden“ für diese Komponente einzublenden.
- Öffnen Sie die Dialogflow CX-Konsole.
- 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_retail_authentication:send_otp“ aus.
- 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.
- Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
- Überprü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.
- Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
- Klicken Sie auf Speichern.
Abgeschlossen
Diese vordefinierte Komponente und ihre Webhooks sind jetzt eingerichtet und können getestet werden.