Die vordefinierte Komponente eines offenen Kontos ermöglicht neuen und vorhandenen Nutzern, ein neues Konto zu erstellen oder den Status vorhandener Anwendungen zu prüfen. Diese Komponente verwendet die vordefinierten Komponenten Geburtsdatum, Namenserfassung und Telefonnummernerfassung, um Nutzerinformationen für die Registrierung eines neuen Kontos zu erheben.
Kontotypen
Standardmäßig unterstützt diese Komponente die folgenden Kontotypen:
- Sparkonten
- Girokonten, auch als Girokonten bezeichnet
- Demat-Konten
- Gehaltskonten
Unterstützte Kontotypen können durch Ändern der benutzerdefinierten Entität prebuilt_components_open_account_account_type hinzugefügt oder entfernt werden.
Beschränkungen
Neben 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
In den folgenden Beispieldialogen werden häufige Szenarien gezeigt, die von dieser vordefinierten Komponente verarbeitet werden. Die Beispieldialoge 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.
Neuer Nutzer
Der Agent erfasst die Telefonnummer des Nutzers und identifiziert, dass der Nutzer nicht für ein Konto registriert ist. Der Agent erfasst dann Details wie den vollständigen Namen und das Geburtsdatum des Nutzers und erstellt eine Anwendung, die an die vom Nutzer angegebene Telefonnummer gesendet wird.
| Nutzereingabe | Agent-Antwort |
|---|---|
| Bitte geben Sie zur Bestätigung die Telefonnummer an. | |
| Der Kundenservicemitarbeiter erfasst die Telefonnummer des Nutzers mithilfe der vordefinierten Komponente für die Erfassung der Telefonnummer | |
| Die Erfassung der Telefonnummer ist abgeschlossen. Wir freuen uns, dass Sie ein Konto bei uns eröffnen möchten. |
|
| Der Agent erfasst den vollständigen Namen des Nutzers mithilfe der vordefinierten Komponente der Namenssammlung | |
| Vielen Dank, John Doe. | |
| Der Kundenservicemitarbeiter erhebt die Telefonnummer des Nutzers mithilfe der vordefinierten Komponente Geburtsdatumsdaten | |
| Wir haben dein Geburtsdatum erfasst. Welche Art von Konto möchtest du eröffnen? Du kannst z. B. Sparen, Girokonto, Gehalt oder Abschlusszahlung sagen. |
|
| Aktuelles Konto | |
| Sie möchten ein neues Girokonto eröffnen. Ist das richtig? | |
| Ja | |
| Vielen Dank für die Informationen. Bitte warten Sie, während Ihre Anwendung erstellt wird. Ihre Anwendungs-ID lautet 81037. Bitte schließe deinen Antrag ab, indem du auf den Link unter deiner registrierten Mobilnummer klickst. |
Vorhandener Nutzer
Der Agent erkennt, dass der Nutzer zuvor authentifiziert wurde, und bestätigt, welche Art von Konto der Nutzer öffnen möchte. Der Agent erstellt eine Anwendung für den Nutzer und sendet eine Anleitung an die registrierte Telefonnummer des Nutzers.
| Nutzereingabe | Agent-Antwort |
|---|---|
| Wir freuen uns, dass Sie ein neues Konto bei uns eröffnen möchten. Welche Art von Konto möchten Sie eröffnen? Du kannst z. B. Sparen, Girokonto, Gehalt oder Abschlusszahlung sagen. |
|
| Sparkonto bitte | |
| Sie möchten ein neues Sparkonto eröffnen. Ist das richtig? | |
| Ja, das stimmt | |
| Vielen Dank für die Informationen. Bitte warten Sie, während Ihre Anwendung erstellt wird. Ihre Anwendungs-ID lautet 21430. Bitte schließe deinen Antrag ab, indem du auf den Link unter deiner registrierten Mobilnummer klickst. |
Vorhandene Anwendung
Der Agent erkennt, dass der Nutzer zuvor eine einzelne Anwendung geöffnet hat, und zeigt dem Nutzer den aktuellen Status an. Der Nutzer lehnt das Öffnen einer weiteren Anwendung für ein neues Konto ab.
| Nutzereingabe | Agent-Antwort |
|---|---|
| Bitte geben Sie zur Bestätigung die Telefonnummer an. | |
| Der Kundenservicemitarbeiter erfasst die Telefonnummer des Nutzers mithilfe der vordefinierten Komponente für die Erfassung der Telefonnummer | |
| Die Telefonnummer wurde erfasst. Ihr Antrag mit der ID 12234 zur Eröffnung eines Sparkontos wird bearbeitet. Möchtest du ein weiteres Konto eröffnen? |
|
| Nein | |
| Ok, vielen Dank für Ihren Anruf. |
Namenskonventionen
Diese vordefinierte Komponente verwendet die folgenden Namenskonventionen:
| Funktion | Format | Beispiel |
|---|---|---|
| Flow | [Komponentenname] | Konto öffnen |
| Komponentenspezifischer Intent | vordefinierte_Komponenten_[Komponentenname]_[Absichtsname] | vordefinierter_komponenten_open_account_account_type |
| Entitätstyp | vordefinierte_Komponenten_[Komponentenname]_[Entitätstyp] | vordefinierter_komponenten_open_account_account_type |
| Webhook | vordefinierte_Komponenten_[Komponentenname]:[Webhook-Aktion] | prebuilt_components_open_account:generate_application |
Eingabeparameter
Eingabeparameter sind Parameter, mit denen bestimmte Verhaltensweisen der Komponente konfiguriert werden. Die Parameter werden von einer oder mehreren Bedingungen im Ablauf verwendet, um zu bestimmen, wie sich die Komponente verhalten soll. Ablaufbezogene Parameter müssen auf der Startseite der Komponente wie unten beschrieben festgelegt werden. Parameter auf Sitzungsebene können entweder über 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 Authentifizierungsstufe des Aufrufers an. | integer |
| $session.params.phone_number | Optional: Für die Authentifizierung registrierte Telefonnummer des Kunden. | String |
| $session.params.min_age_limit | Gibt das Mindestalter für Nutzer an, die ein neues Konto eröffnen. Der Standardwert ist 18. |
integer |
| $session.params.max_age_limit | Gibt das maximal zulässige Alter für Nutzer an, die ein neues Konto eröffnen. Der Standardwert ist 100. |
integer |
| $flow.max_dob_retry_count | Gibt die Anzahl der Wiederholungsversuche an, die bei der Erfassung eines gültigen Geburtsdatums zulässig sind. Der Standardwert ist 2. |
integer |
| $flow.max_retry_account_type ($flow.max_retry_account_type) | Gibt die Anzahl der zulässigen Wiederholungsversuche an, um den Kontotyp zu ermitteln, den der Nutzer öffnen möchte. Der Standardwert ist 2. |
integer |
| $flow.max_retry_anderes_Konto | Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn der Nutzer den ausgewählten Kontotyp ändern möchte. Der Standardwert ist 2. |
integer |
Wenn Sie die Eingabeparameter für diese Komponente konfigurieren möchten, maximieren Sie die entsprechende 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 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 (Voreinstellungen für Parameter) nach Bedarf.
- Klicken Sie auf Speichern.
Ausgabeparameter
Ausgabeparameter sind Sitzungsparameter, die auch nach Beenden 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 |
|---|---|---|
| Telefonnummer | Die lokale Telefonnummer des Nutzers ohne Ländercode, die zur Identifizierung des Nutzers verwendet wird. | String |
| Übertragungsgrund | 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 Agent angefordert.denial_of_information: Der Endnutzer hat die Freigabe der von der Komponente angeforderten Informationen abgelehnt.max_no_input: Die Unterhaltung hat die maximale Anzahl von Wiederholungen für Ereignisse ohne Eingabe erreicht. Siehe Integrierte Ereignisse ohne Eingabe.max_no_match: Die Unterhaltung hat die maximale Anzahl von Wiederholungen für Ereignisse ohne Übereinstimmung erreicht. Siehe integrierte Ereignisse mit „no-match“.webhook_error: Ein Webhook-Fehler ist aufgetreten. Siehe Integriertes „webhook.error“-Ereignis. webhook_not_found: Eine Webhook-URL war nicht erreichbar. Siehe 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 zum Einrichten von Webhooks.
Webhook einrichten
Wenn Sie diese Komponente verwenden möchten, müssen Sie die enthaltenen flexiblen Webhooks konfigurieren, um die benötigten Informationen von Ihren externen Diensten abzurufen.
Bestätigung der Telefonnummer
Der Webhook prebuilt_components_open_account:telephone_verification wird von der Komponente verwendet, um Informationen zu registrierten Konten und früheren Anwendungen abzurufen, die der Telefonnummer des Nutzers zugeordnet sind.
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ändercode, 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 |
|---|---|---|
| Kontoanzahl | Die Anzahl der Konten, die mit der registrierten Telefonnummer verknüpft sind. Dazu gehören eigene Konten sowie Konten, für die der Nutzer eine Vollmacht hat. Wenn mit der angegebenen Telefonnummer keine Konten verknüpft sind, lautet dieser Wert null. |
integer |
| Vorname des Nutzers | Der Vorname des registrierten Nutzers. Wenn die Telefonnummer nicht mit einem registrierten Konto verknüpft ist, lautet dieser Wert null. |
String |
| Nachname des Nutzers | Der Nachname des registrierten Nutzers. Wenn die Telefonnummer nicht mit einem registrierten Konto verknüpft ist, lautet dieser Wert null. |
String |
| user_dob (Nutzer-Domain) | Das Geburtsdatum des registrierten Nutzers im Format „JJJJ-MM-TT“. Wenn die Telefonnummer nicht mit einem registrierten Konto verknüpft ist, lautet dieser Wert null. |
String |
| Anwendungsanzahl | Die Anzahl der Anwendungen, die mit der registrierten Telefonnummer verknüpft sind. Wenn mit der angegebenen Telefonnummer keine Apps verknüpft sind, lautet dieser Wert null. |
integer |
| Anwendungs-ID | Liste mit der App-ID jeder App, die der angegebenen Telefonnummer zugeordnet ist, z. B. ["00000", "11111", "22222"]. Jedes Element in dieser Liste stellt dieselbe Anwendung wie das Element mit demselben Index in account_type und application_status dar. Wenn mit der angegebenen Telefonnummer keine Apps verknüpft sind, lautet dieser Wert null. |
Liste (String) |
| account_type (Kontotyp) | Liste mit dem Kontotyp jeder App, die mit der angegebenen Telefonnummer verknüpft ist, z. B. ["savings", "checking", "demat"] Jedes Element in dieser Liste stellt dieselbe Anwendung wie das Element mit demselben Index in application_id und application_status dar. Wenn mit der angegebenen Telefonnummer keine Apps verknüpft sind, lautet dieser Wert null. |
Liste (String) |
| Anwendungsstatus | Liste mit dem Status der einzelnen Anwendungen, die mit der angegebenen Telefonnummer verknüpft sind, z. B. ["in progress", "on hold", "completed"]. Jedes Element in dieser Liste stellt dieselbe Anwendung wie das Element mit demselben Index in application_id und account_type dar. Wenn mit der angegebenen Telefonnummer keine Apps verknüpft sind, lautet dieser Wert null. |
Liste (String) |
Um den Webhook für die Telefonbestätigung für diese Komponente zu konfigurieren, 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_open_account:telephone_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 aktualisieren Sie ihn, damit er das richtige Anfrageformat für den Webhook erstellt.
- Überprüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Webhook-Antwort zu extrahieren. Ändern Sie nicht die Parameternamen, da sie für die Komponente erforderlich sind, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Überprüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie nach Bedarf.
- Klicken Sie auf Speichern.
Anwendung generieren
Der Webhook prebuilt_components_open_account:generate_application wird von der Komponente verwendet, um eine Anwendung für ein neues Konto zu generieren.
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ändercode, die zur Identifizierung des Nutzers verwendet wird. | String |
| Vorname des Nutzers | Den Vornamen des Nutzers | String |
| Nachname des Nutzers | Nachname des Nutzers | String |
| user_dob (Nutzer-Domain) | Das Geburtsdatum des Nutzers im Format „JJJJ-MM-TT“. | String |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| Anwendungs-ID | Die Anwendungs-ID, die für den Antrag auf ein neues Konto generiert wurde. | String |
Um den Anwendungs-Webhook generieren für diese Komponente zu konfigurieren, 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_open_account:generate_application“ 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 aktualisieren Sie ihn, damit er das richtige Anfrageformat für den Webhook erstellt.
- Überprüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Webhook-Antwort zu extrahieren. Ändern Sie nicht die Parameternamen, da sie für die Komponente erforderlich sind, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Überprüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie nach Bedarf.
- Klicken Sie auf Speichern.
Fertig
Der Agent und die zugehörigen Webhooks sollten jetzt eingerichtet und bereit zum Testen sein.