Vordefinierte Komponente „Bestellstatus“

Die vorgefertigte Komponente „Bestellstatus“ prüft das Authentifizierungsniveau eines Kunden und stellt einem authentifizierten Kunden dann Informationen zu den letzten oder früheren Bestellungen des Nutzers zur Verfügung. Diese Komponente verwendet die vorgefertigte Komponente Einzelhandelsauthentifizierung, um Nutzer zu authentifizieren. Die Komponente verwendet auch Generators für die Zusammenfassung nach dem Anruf.

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 Beispieldialoge veranschaulichen gängige Szenarien, die von dieser vordefinierten Komponente abgedeckt werden. Die Beispiel-Dialoge zeigen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dies löst den Standard-Begrüßungs-Intent und die erste Agent-Antwort zu Beginn der Unterhaltung aus.

Letzte Bestellung

Endnutzeranrufe von einer nicht registrierten Nummer: Der Kundenservicemitarbeiter authentifiziert den Nutzer und gibt dann detaillierte Informationen zu den Sendungen in der Bestellung an. Der Nutzer bestätigt, dass er eine SMS mit weiteren Details an seine registrierte Telefonnummer erhalten möchte.

Nutzereingabe	Antwort des KI-Agenten
	Der Agent authentifiziert den Nutzer mit der vorgefertigten Komponente für die Einzelhandelsauthentifizierung.
	Okay, John. Rufen Sie wegen Ihrer letzten Bestellung für Max Mustermann an, die eine Lampe, ein T-Shirt und 10 weitere Artikel enthält und am 10.11.2023 um 18:00 Uhr aufgegeben wurde?
Ja
	Ihre Bestellung besteht aus zwei Sendungen, die bis zum 15.01.2024 geliefert werden. Möchten Sie mehr über diese Sendungen erfahren?
Ja
	Sendung 1 mit Jeans, Gürtel und 2 weiteren Artikeln ist unterwegs und wird bis zum 12.01.2024 geliefert. Sendung 2 mit Lampe, T-Shirt und 6 weiteren Artikeln wurde am 12.11.2023 geliefert. Möchten Sie eine SMS mit weiteren Details zu Ihren Artikeln erhalten?
Ja
	Wir haben Ihnen eine SMS mit einem Link gesendet, über den Sie den Status aller Ihrer Sendungen verfolgen können. vielen Dank für Ihren Anruf.

Doppelte Bestellungen

Der Endnutzer wurde bereits authentifiziert. Der Nutzer fragt nach Informationen zu einer Bestellung und gibt die letzten fünf Ziffern der Bestellnummer an. Der Kundenservicemitarbeiter stellt fest, dass mehrere Bestellungen dieses Nutzers dieselben letzten fünf Ziffern haben. Er fragt nach, für welche Bestellung der Nutzer den Status wissen möchte, und teilt ihm den Bestellstatus mit.

Nutzereingabe	Antwort des KI-Agenten
	Okay, Amber. Rufen Sie wegen Ihrer letzten Bestellung für Amber Doe an, die eine Lampe, ein T-Shirt und zwei weitere Artikel enthält und am 10.11.2023 um 18:00 Uhr aufgegeben wurde?
Nein
	Können Sie uns bitte die letzten fünf Ziffern der Bestell-ID mitteilen, die Sie verfolgen möchten?
12355
	Die letzten fünf Ziffern der Bestell-ID, die wir erhalten haben, sind 12355. Ist das richtig?
Ja, das ist richtig.
	Wir haben die Bestell-ID erhalten.
	Laut unseren Aufzeichnungen haben wir zwei Bestellungen mit den letzten fünf Ziffern 12355 gefunden. Welche Bestellung suchst du? Bestellnummer 1 vom 10.11.2023 um 18:00 Uhr oder Bestellnummer 2 vom 09.11.2023 um 20:00 Uhr? Wenn du Bestellnummer 1 auswählen möchtest, sage „1“. Wenn du Bestellnummer 2 auswählen möchtest, sage „2“. Andernfalls sag „Nein“.
Eins bestellen
	Ihre Bestellung besteht aus zwei Sendungen, die bis zum 15.01.2024 geliefert werden. Möchten Sie mehr über diese Sendungen erfahren?
Ja
	Sendung 1 mit Jeans ist unterwegs und wird bis zum 15.01.2024 geliefert. Sendung 2 mit Lampe, T-Shirt und einem weiteren Artikel wurde storniert. Möchten Sie eine SMS mit weiteren Details zu Ihren Artikeln erhalten?
Nein, das war alles.
	vielen Dank für Ihren Anruf.

Namenskonventionen

Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:

Funktion	Format	Beispiel
Flow	[Component Name]	Order Status
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_order_status:get_order_details

Eingabeparameter

Eingabeparameter werden verwendet, um bestimmte Verhaltensweisen der Komponente zu konfigurieren. Die Parameter werden von einer oder mehreren Bedingungen im Ablauf verwendet, um das Verhalten der Komponente zu bestimmen. Parameter auf Flow-Ebene müssen auf der Startseite der Komponente festgelegt werden. Parameter mit Sitzungsbereich können entweder durch einen aufrufenden Flow oder auf der Startseite dieser Komponente festgelegt werden.

Diese vorgefertigte Komponente akzeptiert die folgenden Eingabeparameter:

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	(Optional) Die lokale Telefonnummer des Nutzers ohne die Ländervorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
$session.params.all_recent_order_id	(optional) Mit diesem Parameter werden Bestell-IDs aufgeführt, die dem authentifizierten Nutzer zugeordnet sind. Sie sind nach dem Datum der Bestellung in absteigender Reihenfolge sortiert. Das erste Element des Arrays stellt die letzte Bestellung dar. Wenn ein Nutzer keine Bestellungen hat, ist der Wert dieses Parameters null.	Liste (String)
$session.params.email	(Optional) Die mit dem Konto registrierte E-Mail-Adresse.	String
$session.params.user_first_name	(Optional) Vorname des Nutzers, der zur Begrüßung und zur Bestätigung der Inhaberschaft des Kontos verwendet wird.	String
$flow.max_shipment	Gibt die Anzahl der Sendungen an, die dem Nutzer gleichzeitig angezeigt werden. Der Standardwert ist 2.	integer
$flow.tracking_status_delivered	Gibt den Wert an, der vom Webhook zurückgegeben wird und einen gelieferten Bestellstatus angibt. Der Standardwert ist "delivered".	String
$flow.tracking_status_cancelled	Gibt den Wert an, der vom Webhook zurückgegeben wird und einen abgebrochenen Bestellstatus angibt. Der Standardwert ist "cancelled".	String
$flow.tracking_status_returned	Gibt den Wert an, der vom Webhook zurückgegeben wird und einen zurückgegebenen Bestellstatus angibt. Der Standardwert ist "returned".	String
$flow.tracking_status_partially_returned	Gibt den Wert an, der vom Webhook zurückgegeben wird und einen teilweise zurückgegebenen Bestellstatus angibt. Der Standardwert ist "partially returned".	String
$flow.max_retry_alternate_profile	Gibt die Anzahl der Wiederholungsversuche an, die beim Anfordern des Bestellstatus über eine nicht registrierte Telefonnummer oder ein alternatives Profil zulässig sind. Der Standardwert ist 3.	integer
$flow.max_retry_order_number	Gibt die Anzahl der zulässigen Wiederholungsversuche bei der Angabe einer Bestellnummer an. Der Standardwert ist 3.	integer
$flow.max_retry_another_order_id	Gibt die Anzahl der zulässigen Wiederholungsversuche an, nachdem eine ungültige Bestellnummer angegeben wurde. Der Standardwert ist 3.	integer

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

1. Öffnen Sie die Dialogflow CX-Konsole.
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 Bereich Abläufe auf die importierte Komponente.
6. Klicken Sie im Bereich Seiten auf die Startseite.
7. Klicken Sie auf der Startseite auf die richtige Route.
8. Bearbeiten Sie im Fenster „Route“ die Werte für Parameter-Voreinstellungen nach Bedarf.
9. Klicken Sie auf Speichern.

Ausgabeparameter

Ausgabeparameter sind Sitzungsparameter, die nach dem Beenden 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 Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
all_recent_order_id	Dieser Parameter enthält eine Liste der Bestell-IDs, die dem authentifizierten Nutzer zugeordnet sind, sortiert nach dem Datum der Bestellung in absteigender Reihenfolge. Das erste Element des Arrays stellt die letzte Bestellung dar. Wenn ein Nutzer keine Bestellungen hat, ist der Wert dieses Parameters null.	Liste (String)
E-Mail	Die mit dem Konto registrierte E‑Mail-Adresse.	String
user_first_name	Der Vorname des Nutzers, der zur Begrüßung und zur Bestätigung des Kontoinhabers verwendet wird.	String
transfer_reason	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 Kundenservicemitarbeiter angefordert. denial_of_information: Der Endnutzer hat abgelehnt, von der Komponente angeforderte Informationen weiterzugeben. max_no_input: Die Unterhaltung hat die maximale Anzahl von Wiederholungsversuchen für No-Input-Ereignisse 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 ohne Übereinstimmung. webhook_error: Ein Webhook-Fehler ist aufgetreten. Weitere Informationen finden Sie unter webhook.error (integriertes Ereignis). webhook_not_found: Eine Webhook-URL war nicht erreichbar. Weitere Informationen finden Sie unter webhook.error.not-found (integriertes Ereignis).	String

Grundlegende Einrichtung

So richten Sie diese vordefinierte Komponente ein:

1. Vordefinierte Komponente importieren
2. Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unter Webhook-Einrichtung.

Webhook-Einrichtung

Um diese Komponente verwenden zu können, müssen Sie die enthaltenen flexiblen Webhooks konfigurieren, um die erforderlichen Informationen von Ihren externen Diensten abzurufen.

Authentifizierung

Wenn Sie die für die Authentifizierung erforderlichen externen Dienste noch nicht konfiguriert haben, müssen Sie dies tun, um die Authentifizierung von Nutzern für diese Komponente zu aktivieren. Eine ausführliche Anleitung finden Sie unter Webhook für die Einzelhandelsauthentifizierung einrichten.

Ruf Bestellinformationen ab

Der prebuilt_components_order_status:get_order_details-Webhook wird von der Komponente verwendet, um Bestelldetails für eine bestimmte Bestellung abzurufen.

API-Anfrageparameter

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

Parametername	Beschreibung	Eingabeformat
$flow.order_id	Bestell-ID, für die Details abgerufen werden sollen.	String

API-Antwortparameter

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

Parametername	Beschreibung	Ausgabeformat
order_date	Das Datum, an dem die Bestellung aufgegeben wurde, im Format YYYY-MM-DD.	String
order_time	Uhrzeit, zu der die Bestellung aufgegeben wurde, im Format HH:MM.	String
order_status	Gibt den Status der Bestellung an. Beispielwerte sind "pending", "processing", "in-transit", "on-hold", "cancelled", "delivered", "returned", "partially returned".	String
order_product_name	Liste der Produktnamen in der Bestellung.	Liste (String)
order_product_quantity	Die Gesamtzahl der Produkte, die für jedes Produkt in einer Bestellung bestellt wurden.	integer
order_product_count	Die Anzahl der eindeutigen Produkte in einer Bestellung.	integer
order_status_notification	Gibt an, ob Benachrichtigungen für diese Bestellung aktiviert sind.	boolean
return_eligibility_date	Liste der Daten, bis zu denen die einzelnen Produkte in der Bestellung zurückgegeben werden können, im Format YYYY-MM-DD.	Liste (String)
order_customer_billing_name	Der Vorname des Kunden, der für die Bestellung als Rechnungsname angegeben wurde.	String
order_latest_delivery_date	Der späteste Liefertermin aller geschätzten Liefertermine für die Sendungen in der Bestellung im Format YYYY-MM-DD.	String
order_shipment_multiple	Gibt an, ob die Bestellung mehrere Sendungen umfasst.	boolean
order_shipment_count	Die Anzahl der Sendungen in der Bestellung.	integer
order_shipment_product_count	Die Gesamtzahl der Produkte in jeder Sendung innerhalb der Bestellung.	Liste (Ganzzahl)
order_shipment_product_name	Liste der Produktnamen in jeder Sendung innerhalb der Bestellung.	Liste (String)
order_estimated_delivery_date	Liste der voraussichtlichen Liefertermine für jede Sendung in der Bestellung im Format YYYY-MM-DD.	Liste (String)
order_shipment_status	Liste mit dem Status für jede Sendung innerhalb der Bestellung. Beispielwerte sind "pending", "processing", "in-transit", "on-hold", "cancelled", "delivered", "returned", "partially returned".	Liste (String)

Wenn Sie den Webhook „Bestelldetails abrufen“ für diese Komponente konfigurieren möchten, maximieren Sie die Anleitung.

1. Öffnen Sie die Dialogflow CX-Konsole.
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_order_status:get_order_details“ aus.
7. Ersetzen Sie die URL im Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
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 Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
11. Klicken Sie auf Speichern.

Doppelte Bestellungen erhalten

Der prebuilt_components_retail_services:get_duplicate_order-Webhook wird von der Komponente verwendet, um detaillierte Informationen abzurufen, damit Bestellungen unterschieden werden können, wenn mehrere Bestellnummern dieselben letzten fünf Ziffern haben.

API-Anfrageparameter

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

Parametername	Beschreibung	Eingabeformat
$flow.duplicate_order_id	Liste mit den letzten fünf Ziffern der Bestellnummern, die für einen oder mehrere Bestellungen des Nutzers verwendet werden.	Liste (String)

API-Antwortparameter

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

Parametername	Beschreibung	Ausgabeformat
all_order_date	Liste der Bestelldaten für doppelte Bestellungen mit den angegebenen letzten fünf Ziffern im Format YYYY-MM-DD. Jedes Element in diesem Array entspricht dem gleichen Element im all_order_time-Array.	boolean
all_order_time	Liste der Bestellzeiten für doppelte Bestellungen mit den angegebenen letzten fünf Ziffern im Format HH:MM. Jedes Element in diesem Array entspricht dem gleichen Element im all_order_date-Array.	Zahl

Wenn Sie den Webhook „Get duplicate orders“ für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung einzublenden.

1. Öffnen Sie die Dialogflow CX-Konsole.
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_retail_services:get_duplicate_order“ aus.
7. Ersetzen Sie die URL im Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
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 Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
11. Klicken Sie auf Speichern.

SMS senden

Der prebuilt_components_order_status:send_sms-Webhook wird von der Komponente verwendet, um Bestelldetails per SMS an die angegebene Telefonnummer zu senden.

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 Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
$flow.order_id	Bestell-ID, für die Bestelldetails gesendet werden sollen.	String

Wenn Sie den Webhook zum Senden von SMS für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung einzublenden.

1. Öffnen Sie die Dialogflow CX-Konsole.
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_order_status:send_sms“ aus.
7. Ersetzen Sie die URL im Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
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 Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
11. Klicken Sie auf Speichern.

Benachrichtigungen aktivieren

Der prebuilt_components_order_status:enable_notification-Webhook wird von der Komponente verwendet, um Benachrichtigungen für die registrierte Telefonnummer eines Nutzers zu aktivieren.

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 Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
$flow.order_notification	Gibt an, ob Benachrichtigungen für den Nutzer aktiviert werden sollen.	boolean

Wenn Sie den Webhook „Benachrichtigungen aktivieren“ für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung aufzurufen.

1. Öffnen Sie die Dialogflow CX-Konsole.
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_order_status:enable_notification“ aus.
7. Ersetzen Sie die URL im Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
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 Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
11. Klicken Sie auf Speichern.

Abgeschlossen

Ihr KI‑Agent und seine Webhooks sollten jetzt eingerichtet sein und können getestet werden.