Vordefinierte Begrüßungskomponente

Die vorgefertigte Komponente „Begrüßung“ ruft die Telefonnummer des Anrufers (ANI) ab, sofern verfügbar. Wenn die Telefonnummer abgerufen wird, führt die Komponente eine Soft-Authentifizierung mit der Telefonnummer durch und validiert sie anhand der registrierten Telefonnummern. Der Agent begrüßt den Endnutzer dann mit einer personalisierten Nachricht, die auf seinen Kontoinformationen basiert.

Beschränkungen

Zusätzlich zu den allgemeinen Beschränkungen für vorgefertigte Komponenten, gelten für diese vorgefertigte Komponente die folgenden Beschränkungen:

• Die Komponente geht davon aus, dass die Telefonnummern der Kunden in einem CRM-System (Customer Relationship Management) oder einem anderen Dienst verwaltet werden.
• Vorhandene Kunden, die eine alternative Telefonnummer für die Kontaktaufnahme verwenden, werden von dieser Komponente nicht authentifiziert.

Beispieldialoge

Die folgenden Beispieldialoge veranschaulichen gängige Szenarien, die von dieser vorgefertigten Komponente verarbeitet werden. Die Beispieldialoge zeigen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dadurch wird der Standard-Intent „Begrüßung“ und die erste Antwort des Agenten zu Beginn der Unterhaltung ausgelöst.

Authentifizierter Endnutzer

Der Endnutzer wird anhand der Anrufernummer identifiziert und erhält eine personalisierte Begrüßungsnachricht.

Nutzereingabe	Antwort des KI-Agenten
	Hallo [Vorname des Anrufers], vielen Dank, dass Sie sich an [Name des Unternehmens] gewandt haben. Wir möchten Sie dabei unterstützen, Ihre finanzielle Situation zu verbessern. Wie können wir Ihnen heute helfen?

Nicht identifizierter Endnutzer

Die Anrufernummer des Endnutzers wird nicht identifiziert und der Endnutzer wird mit der Standardbegrüßungsnachricht begrüßt.

Nutzereingabe	Antwort des KI-Agenten
	Vielen Dank, dass Sie sich an [Name des Unternehmens] gewandt haben. Wir möchten Sie dabei unterstützen, Ihre finanzielle Situation zu verbessern. Wie können wir Ihnen heute helfen?

Namenskonventionen

Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:

Funktion	Format	Beispiel
Flow	[Komponentenname]	Begrüßung
Parameter	[param_name]	ani_auth
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_greeting:get_account_details

Eingabeparameter

Eingabeparameter werden verwendet, um bestimmte Verhaltensweisen der Komponente zu konfigurieren. Die Parameter werden von einer oder mehreren Bedingungen im Flow 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 von einem aufrufenden Flow oder auf der Startseite dieser Komponente festgelegt werden.

Diese vorgefertigte Komponente akzeptiert die folgenden Eingabeparameter:

Parametername	Beschreibung	Eingabeformat
$flow.company_name	Erfasst den Namen des Unternehmens, der dynamisch im Prompt „Begrüßung“ verwendet wird.	String

Wenn Sie die Eingabeparameter für diese Komponente konfigurieren möchten, maximieren Sie diesen Abschnitt, um die Anleitung einzublenden.

1. Öffnen Sie die Dialogflow CX Console.
2. Wählen Sie Ihr Google Cloud-Projekt aus.
3. Wählen Sie den Agent aus.
4. Wählen Sie den Tab Erstellen aus.
5. Klicken Sie im Abschnitt Abläufe auf die importierte Komponente.
6. Klicken Sie im Abschnitt Seiten auf die Startseite.
7. Klicken Sie auf der Startseite auf die Route true.
8. Bearbeiten Sie im Fenster „Route“ die Werte unter Voreinstellungen für Parameter nach Bedarf.
9. 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 wurden. Diese vorgefertigte Komponente liefert Werte für die folgenden Ausgabeparameter:

Parametername	Beschreibung	Ausgabeformat
ani_auth	Dieser Parameter erfasst das Ergebnis der ANI-basierten Authentifizierung. Der Standardwert ist „false“.	boolean
auth_level	Gibt die Authentifizierungsebene des Anrufers an. Der Standardwert ist „null“. „-1“ gibt an, dass der Nutzer nicht anhand seiner ANI authentifiziert wurde. „0“ gibt an, dass die ANI-Authentifizierung erfolgreich war.	integer

Grundlegende Einrichtung

So richten Sie diese vorgefertigte Komponente ein:

1. Importieren Sie die vorgefertigte Komponente.
2. Konfigurieren Sie den bereitgestellten flexiblen Webhook mit Ihren externen Diensten. Weitere Informationen finden Sie unten unter Webhook-Einrichtung.

Webhook-Einrichtung

Wenn Sie diese Komponente verwenden möchten, müssen Sie die enthaltenen flexiblen Webhooks so konfigurieren, dass die erforderlichen Informationen aus Ihren externen Diensten abgerufen werden.

Kontodetails abrufen

Der Webhook prebuilt_components_greeting:get_account_details wird von der Komponente verwendet, um den Anrufer anhand seiner ANI zu identifizieren. Wenn die Telefonnummer des Anrufers im konfigurierten externen Dienst vorhanden ist, werden die relevanten Informationen zur Personalisierung abgerufen, einschließlich des Namens und der E-Mail-Adresse des Anrufers.

API-Anfrageparameter

Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.

Parametername	Beschreibung	Ausgabeformat
phone_number	Telefonnummer des Anrufers (ANI)	integer

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.

Parametername	Beschreibung	Ausgabeformat
user_first_name	Vorname des Endnutzers, der für eine personalisierte Begrüßung verwendet wird.	String

Wenn Sie den Webhook „Kontodetails abrufen“ für diese Komponente konfigurieren möchten, maximieren Sie diesen Abschnitt, um die Anleitung einzublenden.

1. Öffnen Sie die Dialogflow CX Console.
2. Wählen Sie Ihr Google Cloud-Projekt aus.
3. Wählen Sie den Agent aus.
4. Wählen Sie den Tab Verwalten.
5. Klicken Sie auf Webhooks.
6. Wählen Sie den Webhook „prebuilt_components_greeting:get_account_details“ aus.
7. Ersetzen Sie die URL im Feld Webhook-URL von Dialogflow CX durch den Endpunkt für den Dienst, in den Sie die Komponente einbinden möchten. Wählen Sie im Drop-down-Menü die entsprechende Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext , um das richtige Anfrageformat für Ihren Webhook zu erstellen.
9. 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.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

Abgeschlossen

Ihr Agent und sein Webhook sollten jetzt eingerichtet und bereit für Tests sein.