Die vordefinierte Komponente für das Kontoguthaben prüft die Authentifizierungsebene eines Kunden und stellt dann einem authentifizierten Kunden Informationen zum Kontoguthaben zur Verfügung. Wenn die Kundin oder der Kunde mehrere Konten hat, Die Komponente bestätigt das spezifische Konto, das der Kunde abrufen möchte. den Kontostand. Diese Komponente verwendet die vordefinierte Komponente Authentifizierung, um Nutzer zu authentifizieren.
Beschränkungen
Zusätzlich zu den allgemeinen Einschränkungen für vordefinierte Komponenten gelten für diese vordefinierte Komponente die folgenden Einschränkungen:
- Diese Komponente verschlüsselt keine Daten.
Beispieldialoge
Die folgenden Beispieldialogfelder veranschaulichen gängige Szenarien, die von dieser vorgefertigten Komponente verarbeitet werden. Die Beispieldialogfelder zeigen das Verhalten, wenn die Komponente aufgerufen, was den Standard-Begrüßungs-Intent und den ersten Antwort des Kundenservicemitarbeiters zu Beginn der Unterhaltung.
Einzelnes Konto
Der Endnutzer hat ein einzelnes Konto und erhält den Kontostand.
| Nutzereingabe | Antwort des Kundenservicemitarbeiters |
|---|---|
| Agent authentifiziert Nutzer mit vordefinierter Authentifizierungskomponente | |
| Vielen Dank. Sie wurden erfolgreich authentifiziert. | |
| Bitte haben Sie etwas Geduld, während wir Ihre Kontodetails abrufen. Ihr Kontostand für das Konto, das auf 4567 endet, beträgt 50,00 $. |
Mehrere Konten
Der Endnutzer hat mehrere Konten. Der Kundenservicemitarbeiter fordert und bestätigt die letzten vier Ziffern der Kontonummer und gibt das Kontoguthaben für dieses Konto an.
| Nutzereingabe | Antwort des Kundenservicemitarbeiters |
|---|---|
| Der Kundenservicemitarbeiter authentifiziert den Nutzer mit der vorgefertigten Komponente Authentication | |
| Vielen Dank, Sie wurden erfolgreich authentifiziert. | |
| Bitte warten Sie, während wir Ihre Kontodetails abrufen. Wir haben festgestellt, dass mit Ihrer Nummer zwei Konten verknüpft sind. Können Sie uns bitte die letzten vier Ziffern des Kontos nennen, auf das Sie sich beziehen? |
|
| 2002 | |
| Die letzten vier Ziffern der Kontonummer, die wir erhalten haben, sind 2002, ist das richtig? | |
| Ja | |
| Ihr Kontostand für die Kontonummer, die auf 2002 endet, beträgt 5.000 $. |
Mehrere Konten mit Kontext
Der Endnutzer hat mehrere Konten. Die neu geworbene Kontonummer wird aus dem vorherigen Intent beibehalten und mit dem Kontostand verknüpft.
| Nutzereingabe | Antwort des Kundenservicemitarbeiters |
|---|---|
| Bitte warten Sie, während wir Ihre Kontodetails abrufen. Wir haben festgestellt, dass Ihrer Nummer drei Konten zugeordnet sind. Suchen Sie nach der Kontonummer, die auf 4567 endet? |
|
| Ja | |
| Ihr Guthaben auf dem Konto mit der Endziffer 4567 beträgt 50 $. |
Namenskonventionen
Für diese vordefinierte Komponente werden die folgenden Namenskonventionen verwendet:
| Funktion | Format | Beispiel |
|---|---|---|
| Ablauf | [Komponentenname] | Kontostand |
| Komponentenspezifischer Intent | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_account_number_collection_four_digit_account_number |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_account_balance:get_account_balance |
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 Authentifizierungsebene des Aufrufers an. | integer |
| $session.params.auth_level_req | Gibt die Authentifizierungsstufe an, die erforderlich ist, damit ein Nutzer auf sein Guthaben zugreifen kann. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Der Standardwert ist 1. |
integer |
| $session.params.account_auth_enabled | Gibt an, ob der Nutzer wie unter Authentifizierungstypen beschrieben als Kontoinhaber authentifiziert werden soll. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert true. |
boolean |
| $session.params.card_auth_enabled | Gibt an, ob der Nutzer wie unter Authentifizierungstypen beschrieben als Karteninhaber authentifiziert werden soll. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert false. |
boolean |
| $session.params.phone_number | (Optional) Registrierte Telefonnummer des Kunden, die für die Authentifizierung verwendet wird. | String |
| $session.params.account_count | Optional: Anzahl der Konten, die dem authentifizierten Nutzer zugeordnet sind. | integer |
| $session.params.last_four_digit_of_account_number | Optional: Die letzten vier Ziffern der Kundenkontonummer, für die das Guthaben angegeben werden muss. Wenn der Kunde nur ein Konto hat, werden diese Informationen nach der Authentifizierung automatisch abgerufen. Wenn der Kunde mehrere Konten hat, wird die jeweilige Kontonummer vom Kunden erfasst. | String |
| $flow.max_retry_acc_number | Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn die letzten vier Ziffern der Kontonummer des Endnutzers erfasst werden. Der Standardwert ist 3. |
integer |
Wenn Sie die Eingabeparameter für diese Komponente konfigurieren möchten, maximieren Sie das Fenster, 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 Build 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 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 von der Komponente erfasst werden. Diese vordefinierte Komponente liefert Werte für die folgenden Ausgabeparameter:
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| auth_level | Gibt die Authentifizierungsstufe des Aufrufers an. | integer |
| phone_number | Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert wird | String |
| 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, besteht der Wert dieses Parameters aus den letzten vier Ziffern der Kontonummer, für die er Informationen zum Kontostand ausgewählt hat. | String |
| transfer_reason | Dieser Parameter gibt den Grund an, warum der Ablauf beendet wurde, falls er nicht erfolgreich war. Der zurückgegebene Wert ist einer der folgenden:agent: Der Endnutzer hat irgendwann während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert.denial_of_information: Der Endnutzer hat die Freigabe der von der Komponente angeforderten Informationen abgelehnt.max_no_input: Für die Unterhaltung wurde die maximale Anzahl von Wiederholungsversuchen für Ereignisse ohne Eingabe erreicht. Siehe Integrierte Ereignisse ohne Eingabe.max_no_match: Die Unterhaltung hat die maximale Anzahl von Wiederholungsversuchen für No-Match-Ereignisse erreicht. Weitere Informationen finden Sie unter Integrierte Ereignisse ohne Übereinstimmung.webhook_error: Es ist ein Webhook-Fehler aufgetreten. Weitere Informationen finden Sie unter Vordefiniertes Ereignis „webhook.error“. webhook_not_found: Eine Webhook-URL war nicht erreichbar. Siehe webhook.error.not-found built-in event. |
String |
Grundlegende Einstellungen
So richten Sie diese vorkonfigurierte 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
Zur Verwendung dieser Komponente müssen Sie die in flexiblen Webhooks zum Abrufen Informationen von Ihren externen Diensten benötigt.
Authentifizierung
Wenn Sie noch keine externen Dienste konfiguriert haben, die für müssen Sie diese so konfigurieren, dass die Authentifizierung für diese Komponente. Eine ausführliche Anleitung findest du unter Authentifizierungs-Webhook einrichten.
Konto validieren
Der prebuilt_components_account_services:validate_account-Webhook wird von der Komponente verwendet, um anhand der registrierten Telefonnummer des Nutzers und der letzten vier Ziffern der angegebenen Kontonummer zu prüfen, ob ein Konto vorhanden ist.
Der Webhook gibt auch den Kontostand zurück, sofern ein Konto vorhanden ist.
API-Anfrageparameter
Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.
| Parametername | Beschreibung | Eingabeformat |
|---|---|---|
| $session.params.phone_number | Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert wird | String |
| $session.params.last_four_digit_of_account_number | Die letzten vier Ziffern der Kontonummer, die der Nutzer ausgewählt und bestätigt hat, dass er Informationen zum Kontostand erhalten möchte. | String |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| account_found | Gibt an, ob für das registrierte Konto des Nutzers ein Konto mit den angegebenen letzten vier Ziffern existiert. | boolean |
| Kontostand | Der Betrag des aktuellen Kontostands, falls vorhanden. | Zahl |
Erweitern Sie die Anleitung, um den Konto-Webhook für diese Komponente zu konfigurieren.
- Ö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:valid_account“ 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 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.