Mit der vordefinierten Komponente „Konto eröffnen“ können neue und bestehende Nutzer ein neues Konto eröffnen oder den Status bestehender Anträge prüfen. Diese Komponente verwendet die vordefinierten Komponenten Erfassung des Geburtsdatums, Erfassung des Namens und Erfassung der Telefonnummer, um Nutzerinformationen für die Registrierung eines neuen Kontos zu erfassen.
Kontotypen
Standardmäßig werden die folgenden Kontotypen unterstützt:
- Sparkonten
- Girokonten
- 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
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 verfassen
Die folgenden Beispieldialoge zeigen gängige Szenarien, die von dieser vordefinierten Komponente verarbeitet werden. Die Beispieldialoge zeigen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dadurch werden der Standard-Willkommens-Intent und die erste Antwort des Agents zu Beginn der Unterhaltung ausgelöst.
Neuer Nutzer
Der Agent erfasst die Telefonnummer des Nutzers und stellt fest, dass der Nutzer nicht für ein Konto registriert ist. Der KI-Agent erfasst dann Details wie den vollständigen Namen und das Geburtsdatum des Nutzers und generiert einen Antrag, der an die vom Nutzer angegebene Telefonnummer gesendet wird.
| Nutzereingabe | Antwort des KI-Agenten |
|---|---|
| Bitte geben Sie uns die Telefonnummer zur Bestätigung an. | |
| Der Agent erfasst die Telefonnummer des Nutzers mithilfe der vordefinierten Komponente Telefonnummernerfassung. | |
| Sehr gut, wir haben die Telefonnummer erfasst. 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 Namenserfassung. | |
| Vielen Dank, Jonas Wegener. | |
| Der KI-Agent erfasst die Telefonnummer des Nutzers mithilfe der vordefinierten Komponente Erfassung des Geburtsdatums. | |
| Vielen Dank, wir haben Ihr Geburtsdatum erfasst. Welche Art von Konto möchten Sie eröffnen? Du kannst „Sparkonto“, „Girokonto“, „Gehaltskonto“ oder „Demat-Konto“ sagen. |
|
| Aktuelles Konto | |
| Sie möchten also ein neues Girokonto eröffnen, ist das richtig? | |
| Ja | |
| Vielen Dank für die Informationen. Bitte warten Sie, während wir Ihre Anwendung erstellen. Ihre Anwendungs-ID lautet 81037. Bitte schließen Sie Ihren Antrag ab, indem Sie auf den Link klicken, den Sie an Ihre registrierte Mobilnummer erhalten haben. |
Vorhandener Nutzer
Der Agent erkennt, dass der Nutzer bereits authentifiziert wurde, und bestätigt, welche Art von Konto der Nutzer eröffnen möchte. Der Kundenservicemitarbeiter erstellt einen Antrag für den Nutzer und sendet eine Anleitung an die registrierte Telefonnummer des Nutzers.
| Nutzereingabe | Antwort des KI-Agenten |
|---|---|
| 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 „Sparkonto“, „Girokonto“, „Gehaltskonto“ oder „Demat-Konto“ sagen. |
|
| Sparkonto bitte | |
| Sie möchten also ein neues Sparkonto eröffnen, richtig? | |
| Ja, das ist richtig | |
| Vielen Dank für die Informationen. Bitte warten Sie, während wir Ihre Anwendung generieren. Ihre Anwendungs-ID lautet 21430. Bitte schließen Sie Ihren Antrag ab, indem Sie auf den Link klicken, den Sie an Ihre registrierte Mobilnummer erhalten haben. |
Vorhandene Anwendung
Der Agent erkennt, dass der Nutzer zuvor eine einzelne Anwendung geöffnet hat, und zeigt ihm den aktuellen Status an. Der Nutzer lehnt es ab, eine andere Anwendung für ein neues Konto zu öffnen.
| Nutzereingabe | Antwort des KI-Agenten |
|---|---|
| Bitte geben Sie uns die Telefonnummer zur Bestätigung an. | |
| Der Agent erfasst die Telefonnummer des Nutzers mithilfe der vordefinierten Komponente Telefonnummernerfassung. | |
| Wir haben die Telefonnummer erfasst. Ihr Antrag mit der ID 12234 zur Eröffnung eines Sparkontos wird bearbeitet. Möchten Sie ein weiteres Konto eröffnen? |
|
| Nein | |
| Okay, vielen Dank für Ihren Anruf. |
Namenskonventionen
Für diese vordefinierte Komponente gelten die folgenden Namenskonventionen:
| Funktion | Format | Beispiel |
|---|---|---|
| Flow | [Component Name] | Konto eröffnen |
| Komponentenspezifischer Intent | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_open_account_account_type |
| Entitätstyp | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_open_account_account_type |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | 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 wie unten beschrieben auf der Startseite der Komponente festgelegt werden. Parameter auf Sitzungsebene können entweder von einem 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 Authentifizierungsebene des Aufrufers an. | integer |
| $session.params.phone_number | (Optional) Die registrierte Telefonnummer des Kunden, die für die Authentifizierung verwendet wird. | 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 zulässigen Wiederholungsversuche beim Erfassen eines gültigen Geburtsdatums an. Der Standardwert ist 2. |
integer |
| $flow.max_retry_account_type | Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn der Typ des Kontos erfasst wird, das der Nutzer eröffnen möchte. Der Standardwert ist 2. |
integer |
| $flow.max_retry_another_account | Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn der Nutzer den ausgewählten Kontotyp ändern möchte. Der Standardwert ist 2. |
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 nach dem Verlassen 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 |
|---|---|---|
| phone_number | Die lokale Telefonnummer des Nutzers ohne Ländercode, die zur Identifizierung des Nutzers 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 Endnutzer hat zu einem bestimmten Zeitpunkt während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert.denial_of_information: Der Endnutzer 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 unten im Abschnitt „Webhook-Einrichtung“.
Webhook-Einrichtung
Wenn Sie diese Komponente verwenden möchten, müssen Sie die enthaltenen flexiblen Webhooks so konfigurieren, dass die erforderlichen Informationen von Ihren externen Diensten abgerufen werden.
Bestätigung per Telefon
Der Webhook prebuilt_components_open_account:telephone_verification wird von der Komponente verwendet, um Informationen zu registrierten Konten und früheren Anträgen abzurufen, die mit der Telefonnummer des Nutzers verknüpft 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, um von der Komponente verwendet zu werden.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| 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. Wenn der angegebenen Telefonnummer keine Konten zugeordnet sind, ist dieser Wert null. |
integer |
| user_first_name | Der Vorname des registrierten Nutzers. Wenn die Telefonnummer nicht mit einem registrierten Konto verknüpft ist, ist dieser Wert null. |
String |
| user_last_name | Der Nachname des registrierten Nutzers. Wenn die Telefonnummer nicht mit einem registrierten Konto verknüpft ist, ist dieser Wert null. |
String |
| user_dob | Das Geburtsdatum des registrierten Nutzers im Format „JJJJ-MM-TT“. Wenn die Telefonnummer nicht mit einem registrierten Konto verknüpft ist, ist dieser Wert null. |
String |
| application_count | Die Anzahl der Anträge, die mit der registrierten Telefonnummer verknüpft sind. Wenn der angegebenen Telefonnummer keine Anträge zugeordnet sind, ist dieser Wert null. |
integer |
| application_id | Liste mit der Anwendungs-ID jeder Anwendung, die mit der angegebenen Telefonnummer verknüpft ist, z. B. ["00000", "11111", "22222"]. Jedes Element in dieser Liste stellt dieselbe Anwendung dar wie das Element mit demselben Index in account_type und application_status. Wenn der angegebenen Telefonnummer keine Anträge zugeordnet sind, ist dieser Wert null. |
Liste (String) |
| account_type | Liste mit dem Kontotyp jeder Anwendung, die mit der angegebenen Telefonnummer verknüpft ist, z. B. ["savings", "checking", "demat"]. Jedes Element in dieser Liste stellt dieselbe Anwendung dar wie das Element mit demselben Index in application_id und application_status. Wenn der angegebenen Telefonnummer keine Anträge zugeordnet sind, ist dieser Wert null. |
Liste (String) |
| application_status | Liste mit dem Status der einzelnen Anträge, die mit der angegebenen Telefonnummer verknüpft sind, z. B. ["in progress", "on hold", "completed"]. Jedes Element in dieser Liste stellt dieselbe Anwendung dar wie das Element mit demselben Index in application_id und account_type. Wenn der angegebenen Telefonnummer keine Anträge zugeordnet sind, ist dieser Wert null. |
Liste (String) |
Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren des Webhooks für die Telefonbestätigung 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_open_account:telephone_verification“ 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.
- 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 sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
- Klicken Sie auf Speichern.
Anwendung generieren
Der Webhook prebuilt_components_open_account:generate_application wird von der Komponente verwendet, um einen Antrag 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 |
| user_first_name | Den Vornamen des Nutzers | String |
| user_last_name | Nachname des Nutzers. | String |
| user_dob | Geburtsdatum des Nutzers im Format „JJJJ-MM-TT“. | String |
API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen, um von der Komponente verwendet zu werden.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| application_id | Anwendungs-ID, die für die neue Kontoanwendung generiert wurde. | String |
Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren des Webhooks für die Anwendung „Generate“ 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_open_account:generate_application“ 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.
- 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 sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
- Klicken Sie auf Speichern.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit zum Testen sein.