Vordefinierte Komponente „Bestellstatus“

Die vordefinierte Komponente für den Bestellstatus prüft die Authentifizierungsebene eines Kunden und stellt dann einem authentifizierten Kunden Informationen zu seinen letzten oder früheren Bestellungen zur Verfügung. Diese Komponente verwendet die vordefinierte Komponente Retail-Authentifizierung, um Nutzer zu authentifizieren. Die Komponente verwendet auch Generatoren 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 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 Agent-Antwort zu Beginn der Unterhaltung ausgelöst.

Letzte Bestellung

Ein Endnutzer ruft von einer nicht registrierten Nummer an. Der Kundenservicemitarbeiter authentifiziert den Nutzer und stellt dann detaillierte Informationen zu den Sendungen in der Bestellung bereit. Der Nutzer bestätigt, dass er eine SMS mit zusätzlichen Details an seine registrierte Telefonnummer erhalten möchte.

Nutzereingabe	Antwort des KI-Agenten
	Der Agent authentifiziert den Nutzer mithilfe der vordefinierten Komponente Einzelhandelsauthentifizierung.
	Okay, John. Rufen Sie wegen Ihrer letzten Bestellung für John Doe an, die eine Lampe, ein Hemd und 10 weitere Artikel enthält und am 10.11.2023 um 18:00 Uhr aufgegeben wurde?
Ja
	Ihre Bestellung umfasst 2 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 zugestellt. Sendung 2 mit Lampe, Hemd und 6 weiteren Artikeln wurde am 12.11.2023 zugestellt. Möchten Sie eine SMS mit weiteren Details zu Ihren Artikeln erhalten?
Ja
	Wir haben dir eine SMS mit einem Link gesendet, über den du den Status aller deiner Sendungen verfolgen kannst. Vielen Dank für Ihren Anruf.

Doppelte Bestellungen

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

Nutzereingabe	Antwort des KI-Agenten
	Okay, Amber. Rufen Sie wegen Ihrer letzten Bestellung für Amber Doe an, die am 10.11.2023 um 18:00 Uhr aufgegeben wurde und eine Lampe, ein Hemd und zwei weitere Artikel enthält?
Nein
	Könnten Sie bitte die letzten fünf Ziffern der Bestell-ID angeben, 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
	Die Bestell-ID wurde erfasst.
	Laut unseren Daten haben wir zwei Bestellungen gefunden, die mit den gleichen fünf Ziffern 12355 enden. Welche Bestellung suchst du? Bestellung 1, die am 10.11.2023 um 18:00 Uhr aufgegeben wurde, oder Bestellung 2, die am 09.11.2023 um 20:00 Uhr aufgegeben wurde? Wenn du Bestellung 1 auswählen möchtest, sag „1“. Wenn du Bestellung 2 auswählen möchtest, sag „2“. Andernfalls sagen Sie „Nein“.
Bestellen
	Deine Bestellung umfasst 2 Sendungen, die bis zum 15.01.2024 geliefert werden. Möchtest du mehr über diese Sendungen erfahren?
Ja
	Sendung 1 mit Jeans ist unterwegs und wird bis zum 15.01.2024 zugestellt. Sendung 2 mit Lampe, Hemd und 1 weiteren Artikel wurde storniert. Möchten Sie eine SMS mit weiteren Details zu Ihren Artikeln erhalten?
Nein, danke, das ist alles.
	Vielen Dank für Ihren Anruf.

Namenskonventionen

Für diese vordefinierte 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 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. Parameter mit Ablaufbereich müssen 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.phone_number	(Optional) Lokale Telefonnummer des Nutzers ohne Ländervorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
$session.params.all_recent_order_id	(Optional) Mit diesem Parameter werden Bestell-IDs aufgelistet, 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)
$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 vom Webhook zurückgegebenen Wert an, der den Bestellstatus „Geliefert“ angibt. Der Standardwert ist "delivered".	String
$flow.tracking_status_cancelled	Gibt den vom Webhook zurückgegebenen Wert an, der den Bestellstatus „Storniert“ angibt. Der Standardwert ist "cancelled".	String
$flow.tracking_status_returned	Gibt den vom Webhook zurückgegebenen Wert an, der den Bestellstatus einer zurückgegebenen Bestellung angibt. Der Standardwert ist "returned".	String
$flow.tracking_status_partially_returned	Gibt den vom Webhook zurückgegebenen Wert an, der einen teilweise zurückgegebenen Bestellstatus angibt. Der Standardwert ist "partially returned".	String
$flow.max_retry_alternate_profile	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn der Bestellstatus von einer nicht registrierten Telefonnummer oder einem alternativen Profil angefordert wird. 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

Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente 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 Abschnitt Seiten auf die Startseite.
7. Klicken Sie auf der Startseite auf die Route true.
8. Bearbeiten Sie im Fenster „Route“ die Werte für Parametervoreinstellungen 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 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
all_recent_order_id	In diesem Parameter werden die Bestell-IDs aufgeführt, 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 für das Konto registrierte E‑Mail-Adresse.	String
user_first_name	Vorname des Nutzers, der zur Begrüßung und Bestätigung der Inhaberschaft des Kontos 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:

1. Importieren Sie die vordefinierte Komponente.
2. Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie 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 von Ihren externen Diensten abgerufen werden.

Authentifizierung

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

Ruf Bestellinformationen ab

Der Webhook prebuilt_components_order_status:get_order_details 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, um von der Komponente verwendet zu werden.

Parametername	Beschreibung	Ausgabeformat
order_date	Datum, an dem die Bestellung aufgegeben wurde, im Format YYYY-MM-DD.	String
order_time	Der Zeitpunkt, zu dem 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	Gesamtzahl der bestellten Produkte für jedes Produkt innerhalb einer Bestellung.	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 der Bestellung zurückgegeben werden können, im Format YYYY-MM-DD.	Liste (String)
order_customer_billing_name	Vorname des Kunden für die Abrechnung der Bestellung.	String
order_latest_delivery_date	Das späteste Lieferdatum aller voraussichtlichen Liefertermine für die Sendungen innerhalb der Bestellung im Format YYYY-MM-DD.	String
order_shipment_multiple	Gibt an, ob die Bestellung mehrere Sendungen enthält.	boolean
order_shipment_count	Die Anzahl der Sendungen innerhalb der Bestellung.	integer
order_shipment_product_count	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 innerhalb der Bestellung im Format YYYY-MM-DD.	Liste (String)
order_shipment_status	Liste mit dem Status jeder Sendung innerhalb der Bestellung. Beispielwerte sind "pending", "processing", "in-transit", "on-hold", "cancelled", "delivered", "returned", "partially returned".	Liste (String)

Maximieren Sie die Anleitung, um den Webhook „Bestelldetails abrufen“ für diese Komponente zu konfigurieren.

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 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.
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 die Komponente sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

Doppelte Bestellungen abrufen

Der Webhook prebuilt_components_retail_services:get_duplicate_order 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 eine oder mehrere Bestellungen des Nutzers verwendet wurden.	Liste (String)

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen, um von der Komponente verwendet zu werden.

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 demselben Element im Array all_order_time.	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 demselben Element im Array all_order_date.	Zahl

Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren des Webhooks „Doppelte Bestellungen abrufen“ für diese Komponente 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 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.
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 die Komponente sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

SMS senden

Der Webhook prebuilt_components_order_status:send_sms 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 Ländercode, die zur Identifizierung des Nutzers verwendet wird.	String
$flow.order_id	Bestell-ID, für die Bestelldetails gesendet werden sollen.	String

Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren des Webhooks „SMS senden“ für diese Komponente 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 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.
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 die Komponente sie benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

Benachrichtigungen aktivieren

Der Webhook prebuilt_components_order_status:enable_notification 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 Ländercode, die zur Identifizierung des Nutzers verwendet wird.	String
$flow.order_notification	Gibt an, ob Benachrichtigungen für den Nutzer aktiviert werden sollen.	boolean

Maximieren Sie den Bereich, um die Anleitung zum Konfigurieren des Webhooks „Benachrichtigungen aktivieren“ für diese Komponente 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:enable_notification“ aus.
7. 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.
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 die Komponente sie benötigt, 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 seine Webhooks sollten jetzt eingerichtet und bereit zum Testen sein.