Die vordefinierte Komponente für den Bestellstatus prüft die Authentifizierungsebene eines Kunden und stellt dann einem authentifizierten Kunden Informationen über die letzten oder vergangenen Bestellungen des Nutzers zur Verfügung. Diese Komponente verwendet die vordefinierte Komponente Retail Authentication zur Authentifizierung von Nutzern. Die Komponente verwendet auch Generatoren für die Zusammenfassung nach einem Anruf.
Beschränkungen
Zusätzlich zu den allgemeinen Einschränkungen für vordefinierte Komponenten gelten für diese Komponente die folgenden Einschränkungen:
- Diese Komponente verschlüsselt keine Daten.
Beispieldialoge
Die folgenden Beispieldialogfelder veranschaulichen häufige Szenarien, die von dieser vordefinierten Komponente verarbeitet werden. Die Beispieldialogfelder zeigen 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 dann detaillierte Informationen zu den Sendungen in der Bestellung bereit. Der Nutzer bestätigt, dass eine SMS mit weiteren Details an seine registrierte Telefonnummer gesendet werden soll.
| Nutzereingabe | Antwort des Kundenservicemitarbeiters |
|---|---|
| Agent authentifiziert Nutzer mit der vordefinierten Komponente Retail Authentication | |
| Ok, John. Rufen Sie wegen Ihrer letzten Bestellung für Max Mustermann mit einer Lampe, einem Hemd und 10 weiteren Artikeln an, die Sie am 10.11.2023 um 18:00 Uhr aufgegeben haben? | |
| Yes | |
| Deine Bestellung besteht aus 2 Sendungen, die bis zum 15.01.2024 geliefert werden. Möchtest du mehr über diese Sendungen erfahren? |
|
| Yes | |
| Lieferung 1 mit Jeans, Gürtel und 2 weiteren Artikeln ist noch unterwegs und wird bis zum 12.01.2024 geliefert. Lieferung 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? |
|
| Yes | |
| Wir haben Ihnen eine SMS mit einem Link gesendet, über den Sie den Status all Ihrer Sendungen verfolgen können. 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 erkennt, dass mehrere von diesem Nutzer aufgegebene Bestellungen die gleichen letzten fünf Ziffern haben. Er bestätigt also, bei welcher Bestellung der Nutzer den Status hören möchte, und teilt dem Nutzer den Bestellstatus mit.
| Nutzereingabe | Antwort des Kundenservicemitarbeiters |
|---|---|
| Okay, Bernstein. Rufen Sie wegen Ihrer letzten Bestellung für Bernstein Mustermann mit einer Lampe, einem Hemd und anderen 2 Artikeln an, die am 10.11.2023 um 18:00 Uhr aufgegeben wurde? | |
| Nein | |
| Bitte geben Sie die letzten fünf Ziffern der Bestell-ID an, 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 | |
| Sehr gut, wir haben die Bestell-ID erfasst. | |
| Unseren Daten zufolge haben wir zwei Bestellungen gefunden, die mit denselben fünf Ziffern enden: 12355. 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 die erste Bestellung auswählen möchtest, sag 1 und sag 2. Andernfalls sagen Sie „Nein“. |
|
| Einen Artikel bestellen | |
| Deine Bestellung besteht aus 2 Sendungen, die bis zum 15.01.2024 geliefert werden. Möchtest du mehr über diese Sendungen erfahren? |
|
| Yes | |
| Lieferung 1 mit Jeans ist unterwegs und wird bis zum 15.01.2024 geliefert. Versand 2 mit Lampe, T-Shirt und einem weiteren Artikel ist storniert. Möchten Sie eine SMS mit weiteren Details zu Ihren Artikeln erhalten? |
|
| Nein, das ist alles | |
| Vielen Dank für Ihren Anruf. |
Namenskonventionen
Für diese vordefinierte Komponente werden die folgenden Namenskonventionen verwendet:
| Feature | Format | Beispiel |
|---|---|---|
| Flow | [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 festzulegen. Parameter für den Datenfluss 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) Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert wird. | String |
| $session.params.all_recent_order_id | (Optional) Dieser Parameter listet die mit dem authentifizierten Nutzer verknüpften Bestell-IDs auf, die nach dem Datum der Auftragsplatzierung in absteigender Reihenfolge sortiert sind. Das erste Element des Arrays stellt die letzte Bestellung dar. Hat ein Nutzer keine Bestellungen, hat dieser Parameter den Wert 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 Lieferungen an, die dem Nutzer gleichzeitig angezeigt werden. Der Standardwert ist 2. |
integer |
| $flow.tracking_status_deliveryed | Gibt den vom Webhook zurückgegebenen Wert an, der den Status einer übermittelten Bestellung angibt. Der Standardwert ist "delivered". |
String |
| $flow.tracking_status_cancelled | Gibt den vom Webhook zurückgegebenen Wert an, der den Status eines stornierten Auftrags 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 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 nach der Angabe einer ungültigen Bestellnummer an. Der Standardwert ist 3. |
integer |
Wenn Sie die Eingabeparameter für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um die Anleitung aufzurufen.
- Ö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 Abschnitt Seiten auf die Startseite.
- Klicken Sie auf der Startseite auf die Route true.
- Bearbeiten Sie im Fenster „Route“ die 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 stellt Werte für die folgenden Ausgabeparameter bereit:
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| phone_number | Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert wird | String |
| all_recent_order_id | Dieser Parameter listet die mit dem authentifizierten Nutzer verknüpften Bestell-IDs auf, die nach dem Datum der Auftragsplatzierung in absteigender Reihenfolge sortiert sind. Das erste Element des Arrays stellt die letzte Bestellung dar. Hat ein Nutzer keine Bestellungen, hat dieser Parameter den Wert 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. Der zurückgegebene Wert ist einer der folgenden:agent: Der Endnutzer hat irgendwann während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert.denial_of_information: Der Endnutzer hat die Freigabe der von der Komponente angeforderten Informationen abgelehnt.max_no_input: Für die Unterhaltung wurde die maximale Anzahl von Wiederholungsversuchen für Ereignisse ohne Eingabe erreicht. Siehe Integrierte Ereignisse ohne Eingabe.max_no_match: Die Unterhaltung hat die maximale Anzahl von Wiederholungsversuchen für No-Match-Ereignisse erreicht. Siehe Integrierte Ereignisse ohne Übereinstimmung.webhook_error: Ein Webhook-Fehler ist aufgetreten. Siehe webhook.error built-in event. webhook_not_found: Eine Webhook-URL war nicht erreichbar. Siehe webhook.error.not-found built-in event. |
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. Siehe Webhook-Einrichtung.
Webhook-Einrichtung
Damit Sie diese Komponente verwenden können, müssen Sie die enthaltenen flexiblen Webhooks so konfigurieren, dass die benötigten 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 sie so konfigurieren, dass die Nutzerauthentifizierung für diese Komponente aktiviert wird. Eine ausführliche Anleitung finden Sie unter Retail-Authentifizierungs-Webhook 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 HH:MM-Format. |
String |
| order_status | Zeigt 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 im Auftrag. | 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 diese Bestellung aktiviert sind. | boolean |
| return_eligibility_date | Liste der Daten, bis zu denen jedes Produkt in der Bestellung zurückgegeben werden kann, im Format YYYY-MM-DD. |
Liste (String) |
| order_customer_billing_name | Vorname des Rechnungsnamens des Kunden für die Bestellung. | String |
| order_latest_delivery_date | Der späteste Liefertermin für alle geschätzten Liefertermine für die Sendungen innerhalb 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 innerhalb der Bestellung. | integer |
| order_shipment_product_count | Gesamtzahl der Produkte in jeder Lieferung innerhalb der Bestellung. | Liste (Ganzzahl) |
| order_shipment_product_name | Liste der Produktnamen in jeder Lieferung innerhalb der Bestellung. | Liste (String) |
| order_estimated_delivery_date | Liste der voraussichtlichen Liefertermine für jede Lieferung der Bestellung im Format YYYY-MM-DD. |
Liste (String) |
| order_shipment_status | Liste mit dem Status jeder Lieferung 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, um die Anleitung aufzurufen.
- Ö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) von Dialogflow durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die gewünschte Methode aus.
- Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für den Webhook zu bilden.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Webhook-Antwort zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente diese benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Prüfen und aktualisieren Sie die Authentifizierungseinstellungen 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 und so zwischen Bestellungen zu unterscheiden, wenn mehrere Bestellnummern die 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 freigegeben sind. | 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 Aufträge mit den angegebenen letzten fünf Stellen im Format YYYY-MM-DD. Jedes Element in diesem Array entspricht demselben 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 demselben Element im all_order_date-Array. |
Zahl |
Wenn Sie den Webhook „Doppelte Bestellungen abrufen“ 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 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) von Dialogflow durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die gewünschte Methode aus.
- Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für den Webhook zu bilden.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Webhook-Antwort zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente diese benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Prüfen und aktualisieren Sie die Authentifizierungseinstellungen 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 | Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert wird | String |
| $flow.order_id | Bestell-ID, für die Bestelldetails gesendet werden sollen. | String |
Wenn Sie den Webhook „SMS senden“ für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um die Anleitung aufzurufen.
- Ö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) von Dialogflow durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die gewünschte Methode aus.
- Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für den Webhook zu bilden.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Webhook-Antwort zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente diese benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Prüfen und aktualisieren Sie die Authentifizierungseinstellungen 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 | Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert wird | String |
| $flow.order_notification | Gibt an, ob Benachrichtigungen für den Nutzer aktiviert werden sollen. | boolean |
Zum Konfigurieren des Webhooks zum Aktivieren von Benachrichtigungen für diese Komponente maximieren Sie das Fenster, um die Anleitung anzuzeigen.
- Ö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) von Dialogflow durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die gewünschte Methode aus.
- Prüfen und aktualisieren Sie den Anfragetext, um das richtige Anfrageformat für den Webhook zu bilden.
- Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Webhook-Antwort zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente diese benötigt, um auf die zurückgegebenen Feldwerte zuzugreifen.
- Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
- Klicken Sie auf Speichern.
Fertig
Der Agent und seine Webhooks sollten jetzt eingerichtet und zum Testen bereit sein.