Die vorgefertigte Komponente für den Bestellstatus prüft die Authentifizierungsebene eines Kunden und stellt dann einem authentifizierten Kunden Informationen zu seinen letzten oder bisherigen Bestellungen zur Verfügung. Diese Komponente verwendet die vorgefertigte Komponente Einzelhandel – 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
Die folgenden Beispieldialogfelder veranschaulichen gängige Szenarien, die von dieser vorgefertigten Komponente verarbeitet werden. Die Beispieldialoge veranschaulichen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dadurch werden der Standard-Begrüßungs-Intent und die erste Antwort des Kundenservicemitarbeiters zu Beginn der Unterhaltung ausgelöst.
Letzte Bestellung
Der Endnutzer ruft von einer nicht registrierten Nummer an. Der Kundenservicemitarbeiter authentifiziert den Nutzer und stellt ihm dann detaillierte Informationen zu den Sendungen in der Bestellung zur Verfügung. Der Nutzer bestätigt, dass er eine SMS mit weiteren Informationen an seine registrierte Telefonnummer erhalten möchte.
| Nutzereingabe | Antwort des Kundenservicemitarbeiters |
|---|---|
| Kundenservicemitarbeiter authentifiziert Nutzer mit der vorgefertigten Komponente Einzelhändler-Authentifizierung | |
| Okay, John. Geht es um Ihre letzte Bestellung für Max Mustermann mit einer Lampe, einem Hemd und 10 anderen Artikeln, die am 10. 11. 2023 um 18:00 Uhr aufgegeben wurde? | |
| Ja | |
| Ihre Bestellung umfasst zwei Sendungen, die bis zum 15. Januar 2024 geliefert werden. Möchten Sie mehr über diese Sendungen erfahren? |
|
| Ja | |
| Sendung 1 mit Jeans, Gürtel und 2 anderen Artikeln ist auf dem Weg und wird bis zum 12. 01. 2024 zugestellt. Sendung 2 mit Lampe, Hemd und 6 anderen Artikeln wurde am 12. 11. 2023 zugestellt. Möchten Sie eine SMS mit weiteren Informationen zu Ihren Artikeln erhalten? |
|
| Ja | |
| Wir haben Ihnen eine SMS mit einem Link gesendet, über den Sie den Status aller 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 Kundenservicemitarbeiter stellt fest, dass mehrere Bestellungen dieses Nutzers dieselben letzten fünf Ziffern haben. Er bestätigt daher, welche Bestellung der Nutzer wissen möchte, und teilt ihm den Bestellstatus mit.
| Nutzereingabe | Antwort des Kundenservicemitarbeiters |
|---|---|
| Alles klar, Amber. Geht es um Ihre letzte Bestellung für Frau Anna Muster, die am 10. November 2023 um 18:00 Uhr aufgegeben wurde und eine Lampe, ein Hemd und zwei weitere Artikel enthält? | |
| Nein | |
| Nennen Sie mir bitte die letzten fünf Ziffern Ihrer Bestell-ID, die Sie verfolgen möchten. | |
| 12355 | |
| Die letzten fünf Ziffern der Bestell-ID, die wir erhalten haben, lauten 12355. Ist das richtig? | |
| Ja, das ist richtig. | |
| Sehr gut. Wir haben die Bestell-ID erfasst. | |
| Laut unseren Daten haben wir zwei Bestellungen gefunden, die auf dieselben fünf Ziffern enden: 12355. Welche Bestellung suchen Sie? 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? Geben Sie „1“ für Bestellnummer 1 oder „2“ für Bestellnummer 2 ein. Andernfalls sage „Nein“. |
|
| Einen bestellen | |
| Ihre Bestellung umfasst zwei Sendungen, die bis zum 15. Januar 2024 geliefert werden. Möchten Sie mehr über diese Sendungen erfahren? |
|
| Ja | |
| Sendung 1 mit Jeans ist auf dem Weg und wird bis zum 15. 01. 2024 geliefert. Sendung 2 mit Lampe, Hemd und einem weiteren Artikel wurde storniert. Möchten Sie eine SMS mit weiteren Informationen zu Ihren Artikeln erhalten? |
|
| Nein, das ist alles. | |
| Vielen Dank für Ihren Anruf. |
Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
| Funktion | Format | Beispiel |
|---|---|---|
| Flow | [Component Name] | Bestellstatus |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_order_status:get_order_details |
Eingabeparameter
Mit Eingabeparametern werden bestimmte Verhaltensweisen der Komponente konfiguriert. Die Parameter werden von einer oder mehreren Bedingungen innerhalb des Ablaufs verwendet, um zu bestimmen, wie sich die Komponente verhalten soll. Parameter auf Flussebene müssen auf der Startseite der Komponente festgelegt werden. Parameter auf Sitzungsebene können entweder über einen Aufrufablauf oder auf der Startseite dieser Komponente festgelegt werden.
Diese vordefinierte Komponente akzeptiert die folgenden Eingabeparameter:
| Parametername | Beschreibung | Eingabeformat |
|---|---|---|
| $session.params.phone_number | (Optional) Die Ortstelefonnummer des Nutzers ohne Ländervorwahl, die zur Identifizierung des Nutzers verwendet wird. | String |
| $session.params.all_recent_order_id | Optional. Dieser Parameter enthält die Bestell-IDs, die mit dem authentifizierten Nutzer verknüpft sind, sortiert nach dem Datum der Bestellung in absteigender Reihenfolge. Das erste Element des Arrays steht für die letzte Bestellung. 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 Bestätigung der Inhaberschaft des Kontos verwendet wird. | String |
| $flow.max_shipment | Gibt an, wie viele Sendungen 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 „Stornierte Bestellung“ angibt. Der Standardwert ist "cancelled". |
String |
| $flow.tracking_status_returned | Gibt den vom Webhook zurückgegebenen Wert an, der den Status einer zurückgegebenen Bestellung angibt. Der Standardwert ist "returned". |
String |
| $flow.tracking_status_partially_returned | Gibt den vom Webhook zurückgegebenen Wert an, der den Status einer teilweise zurückgegebenen Bestellung 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 zulässige Anzahl von Wiederholungsversuchen an, wenn eine Bestellnummer angegeben wird. 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 eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente 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 Erstellen aus.
- Klicken Sie im Bereich Abläufe auf die importierte Komponente.
- Klicken Sie im Bereich Seiten auf die Startseite.
- Klicken Sie auf der Startseite auf die Route true.
- Bearbeiten Sie im Fenster „Route“ die Werte für die Parametervorgaben 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 liefert Werte für die folgenden Ausgabeparameter:
| Parametername | Beschreibung | Ausgabeformat |
|---|---|---|
| phone_number | Die Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird. | String |
| all_recent_order_id | Dieser Parameter enthält Bestell-IDs, die mit dem authentifizierten Nutzer verknüpft sind, sortiert nach dem Datum der Bestellung in absteigender Reihenfolge. Das erste Element des Arrays steht für die letzte Bestellung. Wenn ein Nutzer keine Bestellungen hat, ist der Wert dieses Parameters null. |
Liste (String) |
| Die mit dem Konto registrierte E-Mail-Adresse. | String | |
| user_first_name | Der Vorname des Nutzers, der zur Begrüßung und Bestätigung der Kontoinhaberschaft 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 kann einer der folgenden sein:agent: Der Endnutzer hat während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert.denial_of_information: Der Endnutzer hat die von der Komponente angeforderten Informationen abgelehnt.max_no_input: Die Unterhaltung hat die maximale Anzahl von Wiederholungen für No-Input-Ereignisse erreicht. Weitere Informationen finden Sie unter Ereignisse ohne Eingabe.max_no_match: Die maximale Anzahl von Wiederholungen für Ereignisse ohne Übereinstimmung wurde für die Unterhaltung erreicht. Weitere Informationen finden Sie unter Integrierte Ereignisse ohne Übereinstimmung.webhook_error: Ein Webhook-Fehler ist aufgetreten. Weitere Informationen finden Sie unter Vordefiniertes Ereignis „webhook.error“. webhook_not_found: Eine Webhook-URL war nicht erreichbar. Weitere Informationen finden Sie unter Vordefiniertes Ereignis „webhook.error.not-found“. |
String |
Grundlegende Einstellungen
So richten Sie diese vorkonfigurierte Komponente ein:
- Importieren Sie die vordefinierte Komponente.
- Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unter Webhook einrichten.
Webhook-Einrichtung
Wenn Sie diese Komponente verwenden möchten, müssen Sie die enthaltenen flexiblen Webhooks konfigurieren, um die erforderlichen Informationen aus Ihren externen Diensten abzurufen.
Authentifizierung
Wenn Sie die für die Authentifizierung erforderlichen externen Dienste noch nicht konfiguriert haben, müssen Sie dies nachholen, um die Authentifizierung von Nutzern für diese Komponente zu ermöglichen. Eine ausführliche Anleitung finden Sie unter Webhook für die Authentifizierung im Einzelhandel 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 | Datum der Bestellung im Format YYYY-MM-DD. |
String |
| order_time | Die Uhrzeit, zu der die Bestellung aufgegeben wurde, im Format HH:MM. |
String |
| order_status | Gibt den Status der Bestellung an. Beispiele für zulässige Werte: "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 bestellten Produkte für jedes Produkt in 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 Datumsangaben, bis zu denen jedes Produkt in der Bestellung zurückgegeben werden kann, im YYYY-MM-DD-Format. |
Liste (String) |
| order_customer_billing_name | Vorname des Kunden für die Rechnungsstellung der Bestellung. | String |
| order_latest_delivery_date | Das späteste Lieferdatum aller voraussichtlichen Liefertermine für die Sendungen innerhalb der Bestellung im YYYY-MM-DD-Format. |
String |
| order_shipment_multiple | Gibt an, ob die Bestellung mehrere Lieferungen enthält. | boolean |
| order_shipment_count | Die Anzahl der Sendungen innerhalb der Bestellung. | integer |
| order_shipment_product_count | Die Gesamtzahl der Produkte in jeder Sendung innerhalb der Bestellung. | Liste (ganze Zahl) |
| 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 für jede Lieferung innerhalb der Bestellung. Beispiele für zulässige Werte: "pending", "processing", "in-transit", "on-hold", "cancelled", "delivered", "returned", "partially returned". |
Liste (String) |
Maximieren Sie die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Get order details“ (Bestelldetails abrufen) für diese Komponente 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 für Konversations-Agents (Dialogflow CX) durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen und aktualisieren Sie den Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
- 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 zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
- Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
- Klicken Sie auf Speichern.
Duplikataufträge abrufen
Der prebuilt_components_retail_services:get_duplicate_order-Webhook 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.duplicate_order_id | Liste mit den letzten fünf Ziffern der Bestellnummern, die für eine oder mehrere Bestellungen des Nutzers freigegeben wurden. | 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 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 |
Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Get duplicate orders“ für diese Komponente 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_retail_services:get_duplicate_order“ aus.
- Ersetzen Sie die URL im Feld Webhook-URL für Konversations-Agents (Dialogflow CX) durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen und aktualisieren Sie den Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
- 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 zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
- Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
- Klicken Sie auf Speichern.
SMS senden
Über den prebuilt_components_order_status:send_sms-Webhook werden die Bestelldetails per SMS an die angegebene Telefonnummer gesendet.
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 Ortstelefonnummer 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 |
Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „SMS senden“ für diese Komponente 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 für Konversations-Agents (Dialogflow CX) durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen und aktualisieren Sie den Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
- 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 zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
- Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
- 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 Ortstelefonnummer 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 |
Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Benachrichtigungen aktivieren“ für diese Komponente 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:enable_notification“ aus.
- Ersetzen Sie die URL im Feld Webhook-URL für Konversations-Agents (Dialogflow CX) durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
- Prüfen und aktualisieren Sie den Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
- 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 zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
- Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
- Klicken Sie auf Speichern.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.