Bestellung vordefinierter Komponente stornieren

Die vordefinierte Komponente der Stornierungsanforderung prüft die Authentifizierungsstufe eines Nutzers. Sobald der Nutzer authentifiziert wurde, liefert die Komponente Informationen zu den letzten oder vergangenen Bestellungen des Nutzers. Der Nutzer kann dann eine gesamte Bestellung oder nur bestimmte Artikel einer Bestellung stornieren. 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.

Einzelnes Produkt in letzter Bestellung stornieren

Der Endnutzer wurde bereits authentifiziert. Der Kundenservicemitarbeiter bestätigt, welche Artikel der letzten Bestellung storniert werden sollen. Der Kundenservicemitarbeiter prüft die ursprüngliche Zahlungsmethode und bestätigt die Stornierungsdetails mit dem Nutzer.

Nutzereingabe	Agent-Antwort
	Rufen Sie wegen Ihrer letzten Bestellnummer mit den Endziffern 12978 an, die fünf Wasserflaschen und ein T-Shirt enthält, das am 09.11.2023 um 20:00 Uhr aufgegeben wurde?
yes
	Ihre Bestellung enthält einige geeignete Produkte. Teile uns bitte mit, welches Produkt du stornieren möchtest. Produkt 1: Google Wasserflasche, Produkt 2: Google-T-Shirt. Bitte sage oder gib die Produktnummer des Artikels ein, den du auswählen möchtest, oder sage „Weiter“, um weitere Produkte anzuzeigen.
nächste(s/r)
	Es wurden keine weiteren Einträge in unseren Daten gefunden. Bitte wähle einen Eintrag aus der freigegebenen Liste aus. Produkt 1: Google Wasserflasche, Produkt 2: Google-T-Shirt. Sag oder gib die Produktnummer des Artikels ein, den du auswählen möchtest, oder sag „Weiter“, um weitere Produkte anzuzeigen.
1
	Zur Bestätigung: Du möchtest die Google-Wasserflasche stornieren. Ist das richtig?
yes
	Wir sehen, dass die verfügbare Menge des ausgewählten Produkts 5 beträgt. Geben Sie die Anzahl der Produkte an, die Sie stornieren möchten.
4
	Bitte geben Sie den Grund für die Stornierung an. Du könntest zum Beispiel sagen: Ich habe meine Meinung geändert, brauche nicht mehr, ich möchte einen anderen Artikel kaufen, Lieferung verspätet, versehentlich gekauft, möchte die Zahlungsmethode ändern oder andere sagen.
Ich möchte noch einen Artikel kaufen
	Vielen Dank für deine Nachricht. Möchtest du ein weiteres Produkt stornieren?
no
	Bei Käufen mit Google Wallet werden Erstattungen dem Wallet- oder Store-Guthaben-Konto gutgeschrieben. Es kann drei bis fünf Werktage dauern, bis die Erstattung in Ihrem Konto angezeigt wird. Beachten Sie, dass der Erstattungsbetrag keine Versand- und Bearbeitungsgebühren beinhaltet.

Gesamte Bestellung stornieren

Der Endnutzer wurde bereits authentifiziert. Der Agent bestätigt, dass der Nutzer eine bestimmte Bestellung stornieren möchte, und ermittelt dann den Stornierungsgrund. Der Kundenservicemitarbeiter prüft die ursprüngliche Zahlungsmethode und bestätigt die Stornierungsdetails mit dem Nutzer.

Nutzereingabe	Agent-Antwort
	Rufen Sie wegen der letzten Bestellnummer mit den Endziffern 12345 an, die ein T-Shirt enthält, das am 10.11.2023 um 18:00 Uhr aufgegeben wurde?
no
	Möchten Sie eine weitere Bestellung stornieren?
yes
	Könnten Sie bitte die letzten fünf Ziffern Ihrer Bestell-ID angeben, die Sie verfolgen möchten?
12346
	Die letzten fünf Ziffern der Bestell-ID, die wir erhalten haben, sind 12346, richtig?
yes
	Die Erfassung der Bestell-ID ist abgeschlossen. Möchtest du die gesamte Bestellung stornieren?
yes
	Bitte geben Sie den Grund für die Stornierung an. Du könntest zum Beispiel sagen: Ich habe meine Meinung geändert, brauche nicht mehr, ich möchte einen anderen Artikel kaufen, Lieferung verspätet, versehentlich gekauft, möchte die Zahlungsmethode ändern oder andere sagen.
nicht mehr benötigt
	Vielen Dank für deine Nachricht. Dein Kündigungsantrag wurde erstellt.

Namenskonventionen

Diese vordefinierte Komponente verwendet die folgenden Namenskonventionen:

Funktion	Format	Beispiel
Fluss	[Komponentenname]	Bestellung stornieren
Entitätstyp	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_product_cancel_reason
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_cancel_order:post_cancellation_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

Mit dieser vordefinierten Komponente können die folgenden optionalen Parameter das Verhalten der Komponente konfigurieren, einschließlich Wiederholungsversuche.

Parametername	Beschreibung	Format
$flow.max_retry_another_account_counter	Gibt die Anzahl der erlaubten Wiederholungsversuche an, wenn Sie auswählen, ob mit einem alternativen Konto fortgefahren werden soll. Der Standardwert ist 2.	integer
$flow.max_retry_order_number	Gibt die Anzahl der zulässigen Wiederholungen bei Angabe der letzten fünf Ziffern einer Bestellnummer an. Der Standardwert ist 2.	integer
$flow.max_retry_another_order	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn eine andere Bestellung ausgewählt wird und die Bestell-ID nicht gefunden wird oder die Bestellung nicht storniert werden kann. Der Standardwert ist 2.	integer
$flow.max_retry_select_order_number	Gibt die Anzahl der zulässigen Wiederholungsversuche bei Angabe der vollständigen Bestellnummer an, wenn mehrere Bestellungen dieselben letzten fünf Ziffern haben. Der Standardwert ist 2.	integer
$flow.max_product_display_counter	Gibt die maximale Anzahl von Produkten an, die in einer einzigen Runde präsentiert werden sollen. Der Standardwert ist 2.	integer
$flow.max_product_display	Gibt die maximale Anzahl von Produkten an, die in der gesamten Unterhaltung präsentiert werden sollen. Der Standardwert ist 9.	integer
$flow.max_retry_product_number_counter	Gibt die maximale Anzahl der zulässigen Wiederholungsversuche an, wenn ein Produkt, das abgebrochen werden soll, ausgewählt wird. Der Standardwert ist 2.	integer
$flow.max_product_cancel_confirm_counter	Gibt die maximale Anzahl der zulässigen Wiederholungsversuche bei der Bestätigung des ausgewählten Produkts an. Der Standardwert ist 2.	integer
$flow.max_retry_select_quantity	Gibt die maximale Anzahl der zulässigen Wiederholungsversuche an, wenn die Anzahl der zu stornierenden Produkte ausgewählt wird. Der Standardwert ist 2.	integer
$flow.order_product_cancel_reason_others	Gibt den Wert der Entität prebuilt_components_product_cancel_reason an, der angibt, dass der Nutzer den Kündigungsgrund „Sonstige“ ausgewählt hat. Der Standardwert ist "others".	String
$flow.max_retry_cancel_reason	Gibt die Anzahl der zulässigen Wiederholungen an, wenn der Grund für den Abbruch bestätigt wird. Der Standardwert ist 2.	integer
$flow.order_payment_mode_COD	Gibt den Wert des Feldes order_payment_mode an, der vom get_order_details-Webhook zurückgegeben wird und eine COD-Zahlungsmethode (Cash on Delivery) angibt. Der Standardwert ist "COD".	String
$flow.order_payment_mode_store_credit	Gibt den Wert des Feldes order_payment_mode an, der vom Webhook get_order_details zurückgegeben wird und eine Zahlungsmethode für Google Store-Guthaben angibt. Der Standardwert ist "store_credit".	String

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)
E‑Mail	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

Generatoren

Diese Komponente verwendet Generatoren, um bestimmte Teile der Unterhaltung zu aktivieren.

Zusammenfassung

Mit dem Generator Summarization wird nach dem Anruf eine Zusammenfassung der von der Komponente geführten Unterhaltung erstellt.

Grundlegende Einstellungen

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 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_cancel_order: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_product_count	Die Anzahl der eindeutigen Produkte innerhalb einer Bestellung.	integer
order_payment_mode	Gibt die beim Aufgeben der Bestellung verwendete Zahlungsart an.	String
cancelable_product_id	Liste der Produkt-IDs für stornierbare Produkte in der Bestellung.	Liste (String)
cancelable_product_name	Liste der Produktnamen für stornierbare Produkte in der Bestellung.	Liste (String)
cancelable_product_brand_name	Liste der Markennamen für stornierbare Produkte in der Bestellung.	Liste (String)
cancelable_product_quantity	Liste der Mengen für stornierbare Produkte in der Bestellung.	Liste (String)

Doppelte Bestelldetails abrufen

Der Webhook prebuilt_components_retail_services:get_duplicate_order_details 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.	Liste (String)
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.	Liste (String)

Details zur Kündigung nach dem Update

Der Webhook prebuilt_components_cancel_order:post_cancellation_details wird von der Komponente verwendet, um eine Abbruchanfrage 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 ein Ticket eingereicht werden soll.	String
$flow.cancel_product_id_list	Liste der Produkt-IDs, die der Nutzer stornieren möchte.	Liste (String)
$flow.cancel_product_quantity_list	Liste der Produktmengen, die der Nutzer stornieren möchte, entsprechend jedem Element in $flow.cancel_product_id_list.	Liste (String)
$flow.cancel_reason_list	Liste der Kündigungsgründe für jedes stornierte Produkt, die jedem Element in $flow.cancel_product_id_list entsprechen.	Liste (String)
$flow.order_refund_mode	Die Zahlungsart für die Erstattung. Gültige Werte werden durch die Entität prebuilt_components_cancel_mode_of_refund definiert.	String

API-Antwortparameter

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

Parametername	Beschreibung	Ausgabeformat
order_cancellation_ticket_id	Ticket-ID für die eingereichte Stornierung.	String

Fertig

Der Agent und seine Webhooks sollten jetzt eingerichtet und bereit zum Testen sein.