Die vordefinierte Komponente des Bestellstatus prüft die Authentifizierungsstufe eines Kunden und stellt einem authentifizierten Kunden dann Informationen zu den letzten oder vergangenen Bestellungen des Nutzers zur Verfügung. Diese Komponente verwendet die vordefinierte Komponente für die Retail-Authentifizierung, um Nutzer zu authentifizieren. Die Komponente verwendet außerdem Generatoren für die Zusammenfassung nach dem Aufruf.
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
Die folgenden Beispieldialogfelder zeigen gängige Szenarien, in denen diese vordefinierte Komponente verwendet wird. Die Beispieldialogfelder 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.
Letzte Bestellung
Der Endnutzer ruft von einer nicht registrierten Nummer an. Der Agent authentifiziert den Nutzer und stellt in der Bestellung detaillierte Informationen zu den Sendungen bereit. Der Nutzer bestätigt, dass er eine SMS mit weiteren Details an seine registrierte Telefonnummer senden möchte.
| Nutzereingabe | Agent-Antwort |
|---|---|
| Der Agent authentifiziert den Nutzer mit der vordefinierten Komponente für die Retail-Authentifizierung | |
| Okay, Max. Rufen Sie wegen Ihrer letzten Bestellung für Max Mustermann an, die eine Lampe, ein Hemd und zehn andere Artikel enthält, die am 10.11.2023 um 18:00 Uhr aufgegeben wurden? | |
| Ja | |
| Deine Bestellung enthält zwei Sendungen, die bis zum 15.01.2024 geliefert werden. Möchtest du mehr über diese Sendungen erfahren? |
|
| Ja | |
| Sendung 1 mit Jeans, Gürtel und 2 weiteren Artikeln ist noch unterwegs und wird bis zum 12.01.2024 geliefert. Versand 2 mit Lampe, Hemd und 6 weiteren Artikeln wurde am 12.11.2023 geliefert. Möchten Sie eine SMS mit weiteren Informationen zu Ihren Artikeln erhalten? |
|
| Ja | |
| Wir haben dir eine SMS mit einem Link gesendet, über den du den Status all deiner Sendungen verfolgen kannst. Vielen Dank für Ihren Anruf. |
Bestellungen duplizieren
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 erkennt, dass mehrere Bestellungen, die von diesem Nutzer aufgegeben wurden, die gleichen letzten fünf Ziffern haben. Er bestätigt daher, welche Bestellung der Nutzer wissen möchte, und stellt dem Nutzer den Bestellstatus zur Verfügung.
| Nutzereingabe | Agent-Antwort |
|---|---|
| Okay, Amber. Rufen Sie wegen Ihrer letzten Bestellung für Amber Doe an, die eine Lampe, ein Hemd und andere zwei Artikel enthält, die am 10.11.2023 um 18:00 Uhr aufgegeben wurden? | |
| Nein | |
| Könnten Sie bitte die letzten fünf Ziffern Ihrer Bestell-ID angeben, die Sie verfolgen möchten? | |
| 12355 | |
| Die letzten fünf Ziffern der Bestell-ID, die wir erhalten haben, sind 12355, richtig? | |
| Ja, das ist richtig | |
| Die Erfassung der Bestell-ID ist abgeschlossen. | |
| Laut unseren Daten haben wir zwei Bestellungen gefunden, die mit denselben fünf Ziffern wie 12355 enden. Welche Bestellung suchst du? Bestellnummer 1, die am 10.11.2023 um 18:00 Uhr aufgegeben wurde, oder Bestellnummer 2, die am 09.11.2023 um 20:00 Uhr aufgegeben wurde? Wenn du Bestellnummer 1 auswählen möchtest, sag „1“. Wenn du Bestellnummer 2 auswählen möchtest, sag „2“. Andernfalls sagen Sie „Nein“. |
|
| Einen bestellen | |
| Deine Bestellung enthält zwei 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 geliefert. Versand 2 mit Lampe, Hemd und 1 weiteren Artikel wurde storniert. Möchtest du eine SMS mit weiteren Details zu deinen Artikeln erhalten? |
|
| Nein, das ist alles | |
| Vielen Dank für Ihren Anruf. |
Namenskonventionen
Diese vordefinierte Komponente verwendet die folgenden Namenskonventionen:
| Funktion | Format | Beispiel |
|---|---|---|
| Fluss | [Komponentenname] | Bestellstatus |
| 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 das Verhalten der Komponente zu bestimmen. Ablaufbezogene Parameter müssen auf der Startseite der Komponente festgelegt werden. Parameter auf Sitzungsebene können entweder durch einen 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: Die lokale Telefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird. | String |
| $session.params.all_recent_order_id | Optional: Über diesen Parameter werden die Bestell-IDs aufgelistet, die dem authentifizierten Nutzer zugeordnet sind und in absteigender Reihenfolge nach dem Datum der Bestellung sortiert sind. Das erste Element des Arrays steht für die letzte Reihenfolge. Wenn für einen Nutzer keine Bestellungen vorhanden sind, lautet der Wert dieses Parameters null. |
Liste (String) |
| $session.params.email | (Optional) Die für das Konto registrierte E-Mail-Adresse. | String |
| $session.params.user_first_name | (Optional) Vorname des Nutzers, der zur Begrüßung und 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 Status einer zugestellten Bestellung angibt. Der Standardwert ist "delivered". |
String |
| $flow.tracking_status_cancelled | Gibt den vom Webhook zurückgegebenen Wert an, der den Status einer stornierten Bestellung angibt. Der Standardwert ist "cancelled". |
String |
| $flow.tracking_status_returned | Gibt den vom Webhook zurückgegebenen Wert an, der einen zurückgegebenen Bestellstatus 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 Wiederholungen bei 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 Bereich, um weitere Anweisungen zu erhalten.
- Ö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 (Parametervoreinstellungen).
- 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 stellt Werte für die folgenden Ausgabeparameter bereit:
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| phone_number | Die lokale Telefonnummer des Nutzers ohne Ländervorwahl, mit der er identifiziert werden kann. | String |
| all_recent_order_id | In diesem Parameter werden die Bestell-IDs aufgelistet, die dem authentifizierten Nutzer zugeordnet sind, und zwar in absteigender Reihenfolge nach dem Datum der Bestellung. Das erste Element des Arrays steht für die letzte Reihenfolge. Wenn für einen Nutzer keine Bestellungen vorhanden sind, lautet der Wert dieses Parameters null. |
Liste (String) |
| Die für das Konto registrierte E-Mail-Adresse. | String | |
| user_first_name | Der Vorname des Nutzers, der zur Begrüßung und Bestätigung der Inhaberschaft des Kontos verwendet wird. | String |
| transfer_reason | Dieser Parameter gibt den Grund an, warum der Ablauf beendet wurde, falls er nicht erfolgreich war. Folgender Wert wird zurückgegeben:agent: Der Endnutzer hat während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert.denial_of_information: Der Endnutzer hat die Weitergabe der von der Komponente angeforderten Informationen abgelehnt.max_no_input: Für die Unterhaltung wurde die maximale Anzahl von Wiederholungen für Ereignisse ohne Eingabe erreicht. Integrierte Ereignisse ohne Eingabe ansehen.max_no_match: Für die Unterhaltung wurde die maximale Anzahl von Wiederholungen für Ereignisse ohne Übereinstimmung erreicht. Weitere Informationen finden Sie unter Integrierte No-Match-Ereignisse.webhook_error: Ein Webhook-Fehler ist aufgetreten. Siehe integriertes Ereignis „webhook.error“. webhook_not_found: Eine Webhook-URL war nicht erreichbar. Weitere Informationen finden Sie unter 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 unter „Webhook-Einrichtung“.
Webhook-Einrichtung
Damit Sie diese Komponente verwenden können, müssen Sie die enthaltenen flexiblen Webhooks so konfigurieren, dass die erforderlichen Informationen von Ihren externen Diensten abgerufen werden.
Authentifizierung
Wenn Sie bisher noch keine externen Dienste konfiguriert haben, die für die Authentifizierung erforderlich sind, müssen Sie diese so konfigurieren, dass die Authentifizierung von Nutzern für diese Komponente aktiviert wird. Eine ausführliche Anleitung finden Sie unter Webhook für Einzelhandelsauthentifizierung einrichten.
Bestelldetails abrufen
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 und von der Komponente verwendet.
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| order_date | Datum der Bestellung im Format YYYY-MM-DD. |
String |
| order_time | Zeitpunkt der Bestellung im Format HH:MM. |
String |
| order_status | Gibt den Status der Bestellung an. Beispielwerte sind "pending", "processing", "in-transit", "on-hold", "cancelled", "delivered", "returned" und "partially returned". |
String |
| order_product_name | Liste der Produktnamen in der Bestellung. | Liste (String) |
| order_product_quantity | Gesamtzahl der Produkte, die für jedes Produkt innerhalb einer Bestellung bestellt wurden. | integer |
| order_product_count | Die Anzahl der eindeutigen Produkte innerhalb einer Bestellung. | integer |
| order_status_notification | Gibt an, ob Benachrichtigungen für diesen Auftrag aktiviert sind. | boolean |
| return_eligibility_date | Liste der Daten im Format YYYY-MM-DD, bis zu denen jedes Produkt der Bestellung zurückgegeben werden kann. |
Liste (String) |
| order_customer_billing_name | Vorname des Rechnungsnamens des Kunden für die Bestellung. | String |
| order_latest_delivery_date | Das späteste Lieferdatum für alle voraussichtlichen Liefertermine für die Sendungen innerhalb der Bestellung im YYYY-MM-DD-Format. |
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 pro Bestellung 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 Lieferung innerhalb der Bestellung im YYYY-MM-DD-Format. |
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" und "partially returned". |
Liste (String) |
Wenn Sie den Webhook „Bestelldetails abrufen“ für diese Komponente konfigurieren möchten, maximieren Sie den Bereich für 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_order_status:get_order_details“ 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 ändern Sie ihn so, dass er das richtige Anfrageformat für den Webhook bildet.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort des Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie für die Komponente erforderlich sind, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
- 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, um Bestellungen zu unterscheiden, 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.double_order_id | Liste mit den letzten fünf Ziffern der Bestellnummern, die in einer oder mehreren Bestellungen für den Nutzer 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 demselben Element im Array all_order_time. |
boolean |
| all_order_time | Liste der Bestellzeiten für doppelte Bestellungen mit den letzten fünf Ziffern im Format HH:MM. Jedes Element in diesem Array entspricht demselben Element im Array all_order_date. |
Zahl |
Wenn Sie den Webhook „Abrufen doppelter Aufträge“ für diese Komponente konfigurieren möchten, 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_retail_services:get_Duplicate_order“ 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 ändern Sie ihn so, dass er das richtige Anfrageformat für den Webhook bildet.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort des Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie für die Komponente erforderlich sind, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
- 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ändervorwahl, mit der er identifiziert werden kann. | 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 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 Verwalten.
- Klicken Sie auf Webhooks.
- Wählen Sie den Webhook „prebuilt_components_order_status:send_sms“ 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 ändern Sie ihn so, dass er das richtige Anfrageformat für den Webhook bildet.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort des Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie für die Komponente erforderlich sind, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
- 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ändervorwahl, mit der er identifiziert werden kann. | String |
| $flow.order_notification | Gibt an, ob Benachrichtigungen für den Nutzer aktiviert werden sollen. | boolean |
Um den Webhook „Benachrichtigungen aktivieren“ 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_order_status:enable_notification“ 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 ändern Sie ihn so, dass er das richtige Anfrageformat für den Webhook bildet.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort des Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da sie für die Komponente erforderlich sind, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Überprüfen Sie die Einstellungen für die Authentifizierung und aktualisieren Sie sie nach Bedarf.
- Klicken Sie auf Speichern.
Fertig
Der Agent und seine Webhooks sollten jetzt eingerichtet und bereit zum Testen sein.