Die vorgefertigte Komponente für die Einzelhandelsauthentifizierung erfasst Informationen vom Nutzer, um ihn auf der erforderlichen Authentifizierungsebene zu authentifizieren. Diese Komponente deckt Authentifizierungsanforderungen ab, die in der Einzelhandelsbranche üblich, aber nicht ausschließlich sind. In dieser Komponente wird die vordefinierte Komponente Telefonnummer erfassen 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 Einzelhandelsauthentifizierungskomponente können sich Nutzer auf Stufe 0 (ANI-Abgleich) oder Stufe 1 (Einfach) 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. |
Unterstützte Nutzertypen
Die Einzelhandels-Authentifizierungskomponente bietet Unterstützung für 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 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 0: ANI-Abgleich
Der Nutzer ruft von einer Telefonnummer an, die für ein bestehendes Konto registriert ist, bestätigt sein Konto und wird erfolgreich auf Stufe 0 authentifiziert.
| Nutzereingabe | Antwort des KI-Agenten |
|---|---|
| Hallo, die von Ihnen gewählte Nummer ist mit dem Konto von Max 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. |
Erfolgreiche Authentifizierung auf Stufe 1: Einmalpasswort
Der Nutzer ruft von einer unbekannten Telefonnummer an. Die Komponente erfasst die registrierte Telefonnummer des Nutzers und sendet dann ein Einmalpasswort an den vom Nutzer ausgewählten Kanal. Der Nutzer wird aufgefordert, das Einmalpasswort zu bestätigen. Der Nutzer kann ein gültiges Einmalpasswort angeben und wird erfolgreich auf Stufe 1 authentifiziert.
| Nutzereingabe | Antwort des KI-Agenten |
|---|---|
| Wir konnten diese Telefonnummer nicht finden. Bitte geben Sie die registrierte Telefonnummer an. | |
| Der Kundenservicemitarbeiter erfasst die Telefonnummer mithilfe der vordefinierten Komponente Telefonnummer erfassen. | |
| Wir haben die Telefonnummer erfasst. 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 | |
| Nur zur Bestätigung: Möchten Sie das Einmalpasswort auf Ihrem Smartphone erhalten? Bitte antworte mit Ja oder Nein. | |
| Ja | |
| 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? | |
| 123457 | |
| Vielen Dank, John. Ihre Identität wurde bestätigt. |
Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
| Funktion | Format | Beispiel |
|---|---|---|
| Flow | [Component Name] | Einzelhandelsauthentifizierung |
| Komponentenspezifische Intention | 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
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_req | Definiert die Authentifizierungsebene, für die der Endnutzer authentifiziert wird. Gültige Werte sind 0 und 1. |
integer |
| $session.params.auth_level | (Optional) Gibt die aktuelle Authentifizierungsebene des Endnutzers an. | integer |
| $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_phone_number | Gibt die Anzahl der Wiederholungsversuche an, die beim Erheben der Telefonnummer des Nutzers zulässig sind. 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 Einmalkennwort nicht empfangen wird. Der Standardwert ist 1. |
integer |
| $flow.max_retry_otp_confirm_channel | Gibt die Anzahl der zulässigen Wiederholungsversuche beim Erfassen des Kanals zum Empfangen des Einmalpassworts (OTP) an. Der Standardwert ist 3. |
integer |
Wenn Sie die Eingabeparameter für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung 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 Bereich Seiten auf die Startseite.
- Klicken Sie auf der Startseite auf die richtige Route.
- Bearbeiten Sie im Fenster „Route“ die Werte für Parameter-Voreinstellungen nach Bedarf.
- 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 |
| all_recent_order_id | Dieser Parameter enthält eine Liste der Bestell-IDs, 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 Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird. | String |
| Die mit dem Konto registrierte E‑Mail-Adresse. | String | |
| user_first_name | Der Vorname des Nutzers, der zur Begrüßung und zur Bestätigung des Kontoinhabers 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:
- Vordefinierte Komponente importieren
- 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.
Nutzerdetails bestätigen
Der prebuilt_components_retail_authentication:verify_user_details-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 |
|---|---|---|
| Die mit dem Konto registrierte E‑Mail-Adresse. | String | |
| all_recent_order_id | Liste der Bestell-IDs, 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) |
| user_first_name | Der Vorname des Nutzers, der zur Begrüßung und zur Bestätigung des Kontoinhabers verwendet wird. | String |
Wenn Sie den Webhook „Nutzerdetails bestätigen“ für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um die Anleitung aufzurufen.
- Ö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 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.
- Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
- 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.
- Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
- Klicken Sie auf Speichern.
OTP senden
Der prebuilt_components_retail_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_channel_email_phone definiert. Standardmäßig werden email und phone 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.
- Ö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 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.
- Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
- 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.
- Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
- Klicken Sie auf Speichern.
Abgeschlossen
Ihr KI‑Agent und seine Webhooks sollten jetzt eingerichtet sein und können getestet werden.