Einzelhandelsauthentifizierung vordefinierte Komponente erfasst Informationen vom Nutzer, um ihn bis zur erforderlichen Authentifizierungsebene zu authentifizieren. Diese Komponente deckt gängige Authentifizierungsanforderungen ab, exklusiv für den Einzelhandel. Diese Komponente verwendet den Erhebung von Telefonnummern vordefinierte Komponente zum Erfassen und Validieren von Nutzerdetails.
Authentifizierungsebenen
Es gibt mehrere Authentifizierungsebenen, die von verschiedenen vordefinierten -Komponenten, wobei auf höheren Ebenen mehr Nutzerinformationen zur Authentifizierung erforderlich sind. Nutzenden. Mit der Authentifizierungskomponente für den Einzelhandel können sich Nutzer wie in der Tabelle „Authentifizierungsebene“ beschrieben auf Ebene 0 (ANI-Abgleich) oder Ebene 1 (einfach) authentifizieren.
| Authentifizierungsebene | Voraussetzungen |
|---|---|
| Ebene 0: ANI-Übereinstimmung | Der Nutzer wird authentifiziert, indem er von einem registrierten Konto aus anruft oder eine Telefonnummer angibt, die zu einem registrierten Konto gehört. Ein Nutzer kann mit der vordefinierten Begrüßungskomponente für Level 0 authentifiziert werden. |
| Stufe 1: Einfach | 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 Retail-Authentifizierungskomponente bietet Support für Nutzer mit einem 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 wurden bisher nur an eine Mobiltelefonnummer oder E-Mail-Adresse gesendet die für den Nutzer registriert sind. Die Komponente verwendet kein OTP zur Authentifizierung von Kunden Anrufen von einer alternativen Telefonnummer, die nicht in ihrem Konto registriert ist Wenn ein Nutzer von einer alternativen Telefonnummer anruft, werden Sicherheitsfragen gestellt zur Authentifizierung des Anrufers verwendet wird.
- Diese Komponente verschlüsselt keine Daten.
Beispieldialoge
Die folgenden Beispieldialogfelder veranschaulichen häufige Szenarien, die von diesem vordefinierte Komponente. Die Beispieldialogfelder zeigen das Verhalten, wenn die Komponente wird per Telefonie aufgerufen, wodurch der Standard-Begrüßungs-Intent und der erste Antwort des Kundenservicemitarbeiters zu Beginn der Unterhaltung.
Authentifizierung der Stufe 0 erfolgreich: ANI-Übereinstimmung
Nutzer ruft von einer Telefonnummer an, die in einem bestehenden Konto registriert ist, bestätigt ihre und wurde erfolgreich auf Level 0 authentifiziert.
| Nutzereingabe | Antwort des Kundenservicemitarbeiters |
|---|---|
| Hallo, die von Ihnen gewählte Nummer ist mit dem Konto von Max verknüpft. Haben Sie Fragen zur Bestellung einer anderen Person? Bitte sagen Sie in diesem Fall „Ja“, andernfalls „Nein“. | |
| Nein | |
| Vielen Dank, John. Sie wurden erfolgreich identifiziert. |
Erfolgreiche Authentifizierung der Stufe 1: OTP
Nutzer ruft von einer unbekannten Telefonnummer an. Die Komponente erfasst die registrierte Telefonnummer und fordert den Nutzer dann auf, ein OTP zu bestätigen, das an die vom Nutzer ausgewählt wird. Der Nutzer kann ein gültiges OTP angeben und ist bei Stufe 1 authentifiziert.
| Nutzereingabe | Antwort des Kundenservicemitarbeiters |
|---|---|
| Wir konnten diese Telefonnummer nicht mit uns verknüpfen. Bitte geben Sie uns die registrierte Telefonnummer an. | |
| Kundenservicemitarbeiter erfasst Telefonnummer mithilfe der vorgefertigten Komponente Telefonnummernerfassung | |
| Super, wir haben die Telefonnummer erfasst. Aus Sicherheitsgründen müssen wir Ihre Identität bestätigen. Dazu senden wir Ihnen einen Code. Möchten Sie den Code lieber telefonisch oder per E-Mail erhalten? |
|
| Telefon | |
| Nur zur Bestätigung: Möchten Sie das OTP auf Ihr Smartphone erhalten? Bitte sagen Sie Ja oder Nein. | |
| Ja | |
| Wir haben einen Code an Ihre registrierte Telefonnummer mit den Endziffern 0000 gesendet. Das kann einige Sekunden dauern. Könnten Sie bitte den Code bestätigen? | |
| 123457 | |
| Vielen Dank, John. Sie wurden erfolgreich identifiziert. |
Namenskonventionen
Für diese vordefinierte Komponente werden die folgenden Namenskonventionen verwendet:
| Funktion | Format | Beispiel |
|---|---|---|
| Ablauf | [Component Name] | Authentifizierung im Einzelhandel |
| 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
Eingabeparameter sind Parameter, mit denen bestimmte Verhaltensweisen eines Komponente. Die Parameter werden von einer oder mehreren Bedingungen innerhalb des Ablaufs verwendet, um zu bestimmen, wie sich die Komponente verhalten soll. Parameter auf Flussebene müssen auf der Startseite der Komponente wie unten beschrieben 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_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 zulässigen Wiederholungen an, wenn die Telefonnummer des Nutzers erfasst wird. 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 nicht empfangen wird. Der Standardwert ist 1. |
integer |
| $flow.max_retry_otp_confirm_channel | Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn der Kanal für den Empfang des Einmalpassworts (OTP) erfasst wird. Der Standardwert ist 3. |
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 Build 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 Beenden aktiv bleiben. Komponente. Diese Parameter enthalten wichtige Informationen, die vom Komponente. Diese vordefinierte Komponente stellt Werte für die folgende Ausgabe bereit Parameter:
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| auth_level | Gibt die aktuelle Authentifizierungsebene des Endnutzers an. | integer |
| all_recent_order_id | Dieser Parameter listet die mit dem authentifizierten Nutzer verknüpften Bestell-IDs auf, die nach dem Datum der Auftragsplatzierung in absteigender Reihenfolge sortiert sind. 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 | Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert wird | String |
| Die für das Konto registrierte E-Mail-Adresse. | String | |
| user_first_name | Der Vorname des Nutzers, der zur Begrüßung und Bestätigung der Inhaberschaft des Kontos 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: Bei der Unterhaltung wurde 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. Siehe Integrierte Ereignisse ohne Übereinstimmung.webhook_error: Ein Webhook-Fehler ist aufgetreten. Siehe webhook.error built-in event. webhook_not_found: Eine Webhook-URL war nicht erreichbar. Siehe webhook.error.not-found built-in event. |
String |
Grundlegende Einstellungen
So richten Sie diese vordefinierte Komponente ein:
- Importieren Sie die vordefinierte Komponente.
- Konfigurieren Sie die flexible Webhooks mit Konfiguration, die Ihre externen Dienste beschreibt, siehe Webhook Einrichtung unten.
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.
Nutzerdetails bestätigen
Über den prebuilt_components_retail_authentication:verify_user_details-Webhook ruft die Komponente die Kontodetails des Nutzers anhand der angegebenen Telefonnummer 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 |
|---|---|---|
| Die für das Konto registrierte E-Mail-Adresse. | String | |
| all_recent_order_id | Liste der Bestell-IDs, die mit dem authentifizierten Nutzer verknüpft sind, sortiert nach dem Bestelldatum in absteigender Reihenfolge. Das erste Element des Arrays stellt die letzte Bestellung dar. Hat ein Nutzer keine Bestellungen, hat dieser Parameter den Wert null. |
Liste (String) |
| user_first_name | Der Vorname des Nutzers, der zur Begrüßung und Bestätigung der Inhaberschaft des Kontos verwendet wird. | String |
Maximieren Sie die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Nutzerdetails überprüfen“ 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_retail_authentication:verify_user_details“ aus.
- Ersetzen Sie die URL im Feld Webhook-URL für Conversational Agents (Dialogflow CX) durch den Endpunkt des Dienstes. die Sie integrieren möchten. Wählen Sie im Drop-down-Menü die gewünschte Methode aus.
- Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für den Webhook zu bilden.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente diese für den Zugriff benötigt. den zurückgegebenen Feldwerten.
- Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
- Klicken Sie auf Speichern.
OTP senden
Über den prebuilt_components_retail_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 von der benutzerdefinierten 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 OTP, der generiert und über den ausgewählten Kanal an den Nutzer gesendet wird. | String |
Wenn Sie den OTP-Webhook für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um die Anleitung 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_retail_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 gewünschte Methode aus.
- Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für den Webhook zu bilden.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente diese für den Zugriff benötigt. den zurückgegebenen Feldwerten.
- Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
- Klicken Sie auf Speichern.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.