Vordefinierte Komponente für Eintauschbestellungen

Die vordefinierte Komponente für die Umtauschbestellung prüft die Authentifizierungsebene eines Nutzers. Nachdem der Nutzer authentifiziert wurde, stellt die Komponente Informationen zu den letzten oder früheren Bestellungen des Nutzers bereit. Der Nutzer kann dann mehrere Artikel in einer Bestellung umtauschen und Optionen wie Erstattungs- und Versandmethoden auswählen. Diese Komponente verwendet die vordefinierte Komponente Retail-Authentifizierung, um Nutzer zu authentifizieren. Die Komponente verwendet auch Generatoren für die Zusammenfassung nach dem Anruf und für FAQs.

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.

Umtausch eines defekten Artikels im Geschäft

Der Endnutzer wurde bereits authentifiziert. Der Kundenservicemitarbeiter bestätigt, welche Artikel aus der letzten Bestellung umgetauscht werden sollen, und erfragt den Grund für den Umtausch. Der Nutzer entscheidet sich, die Artikel in einem Geschäft umzutauschen, und der Kundenservicemitarbeiter stellt eine Liste der nächstgelegenen Geschäfte bereit. Der Nutzer wählt ein Geschäft aus und der Agent generiert ein Versandlabel, das an die registrierten Kanäle des Nutzers gesendet wird.

Nutzereingabe	Antwort des KI-Agenten
	Rufen Sie wegen Ihrer letzten Bestellung mit der Nummer 12375 an, die am 10.11.2023 aufgegeben wurde und 2 Lampen, 2 Pixel und 10 andere Produkte enthält?
Ja
	Wir haben in Ihrer Bestellung einige Produkte gefunden, die für eine Rückgabe infrage kommen. Bitte teilen Sie uns mit, welches Produkt Sie umtauschen möchten. Produkt 1: Google-Lampe, Produkt 2: Google Pixel, Produkt 3: Google-LED-Leuchte. Bitte nenne oder gib die Produktnummer des Artikels ein, den du auswählen möchtest, oder sage „Weiter“, um weitere Produkte anzuzeigen.
1
	Sie möchten also die Google-Lampe umtauschen. Ist das richtig?
Ja
	Die verfügbare Menge des ausgewählten Produkts ist 2. Bitte gib die Anzahl der Produkte an, die du umtauschen möchtest.
Zwei
	Bitte gib den Grund für den Umtausch an. Sie können beispielsweise Folgendes sagen: „Artikel defekt oder funktioniert nicht“, „Problem mit Größe oder Passform“, „Unvollständige Bestellung“, „Problem mit Stil“, „Falsche Farbe“ oder „Sonstiges“.
Artikel ist fehlerhaft
	Vielen Dank für die Information. Wie möchtest du das Produkt umtauschen? Du kannst beispielsweise „Im Geschäft umtauschen“ oder „Abholung planen“ sagen.
Ich möchte das Gerät in einem Geschäft umtauschen.
	Lass uns ein Geschäft in deiner Nähe finden.
	Der KI-Agent erfasst die Postleitzahl mithilfe der vordefinierten Komponente Postleitzahlenerfassung.
	Hier ist die Liste der Standorte in der Nähe der von Ihnen eingegebenen Postleitzahl. Adresse 1: Google Texas, 500 W 2nd St, Suite 2900, Austin, Texas 78701, USA. Adresse 2: Google California, 19510 Jamboree Road, Irvine, California 92612, USA. Sagen Sie die Nummer der Adresse, die Sie auswählen möchten, oder geben Sie sie ein. Sie können auch „Weiter“ sagen, um weitere Adressen von Geschäften zu sehen.
Das erste Geschäft
	Sie haben Google Texas, 500 W 2nd St, Suite 2900, Austin, Texas 78701, USA ausgewählt. Ist das richtig?
Ja
	Perfekt. Wir haben ein Versandlabel und eine Ticketnummer an deine registrierte Telefonnummer und E‑Mail-Adresse gesendet. Bitte drucke es aus, bringe es am Paket an und gib das Paket innerhalb von 30 Tagen ab. Sobald der Artikel in unserem Lager eingegangen ist, dauert es 3 bis 5 Arbeitstage, bis der Umtausch in deinem Konto angezeigt wird. Hinweis: Der Erstattungsbetrag enthält keine Versand- und Bearbeitungsgebühren. Das Ersatzprodukt hat einen höheren Wert. Die Preisdifferenz beträgt 20 $. Sie erhalten demnächst den Zahlungslink an Ihre registrierte Mobilnummer. Bitte zahle den Betrag innerhalb von 24 Stunden, um den Umtausch abzuschließen. Möchtest du noch etwas umtauschen?
Nein, das war alles.
	Vielen Dank für deinen Anruf.

Erstattung der Preisdifferenz

Der Endnutzer wurde bereits authentifiziert. Der Agent erfasst die Bestellnummer, das umzutauschende Produkt und den Grund für den Umtausch. Der Nutzer entscheidet sich, die Artikel gegen eine andere Größe umzutauschen, und vereinbart eine Abholung. Der KI-Agent stellt fest, dass der umgetauschte Artikel günstiger ist als der neue Artikel, und bestätigt mit dem Nutzer die Zahlungsmethode für eine Erstattung.

Nutzereingabe	Antwort des KI-Agenten
	Rufen Sie wegen Ihrer letzten Bestellung mit der Bestellnummer, die auf 12345 endet, an? Sie enthält 2 Lampen und wurde am 10.11.2023 aufgegeben.
Nein
	Möchten Sie eine andere Bestellung umtauschen?
Ja
	Könntest du mir bitte die letzten fünf Ziffern der Bestell-ID des Artikels nennen, den du umtauschen möchtest?
12346
	Die letzten fünf Ziffern der Bestell-ID, die wir erhalten haben, sind 12346. Ist das richtig?
Ja
	Wir haben die Bestell-ID erfasst. Wir haben einige Produkte in Ihrer Bestellung gefunden, die für eine Rückgabe infrage kommen. Bitte teilen Sie uns mit, welches Produkt Sie umtauschen möchten. Produkt 1: Google-Wasserflasche, Produkt 2: Google-T-Shirt. Nennen oder geben Sie die Produktnummer des Artikels ein, den Sie auswählen möchten, oder sagen Sie „Weiter“, um weitere Produkte anzuzeigen.
Zwei
	Du möchtest das Google-T-Shirt umtauschen. Ist das richtig?
Ja
	Bitte gib den Grund für den Umtausch an. Sie können beispielsweise Folgendes sagen: „Artikel defekt oder funktioniert nicht“, „Problem mit Größe oder Passform“, „Unvollständige Bestellung“, „Problem mit Stil“, „Falsche Farbe“ oder „Sonstiges“.
Problem mit der Größe oder Passform
	Vielen Dank, dass du uns den Grund für den Umtausch mitgeteilt hast. Können Sie uns bitte mitteilen, in welche Größe Sie das Produkt umtauschen möchten? Wir haben die folgenden Größen verfügbar: Sagen Sie 1 für S. Sagen Sie 2 für M. Sagen Sie 3 für L. Sagen Sie 4 für XL. Sagen Sie 5 für XXL.
1
	Wie möchten Sie das Produkt umtauschen? Du kannst beispielsweise „Im Geschäft umtauschen“ oder „Abholung vereinbaren“ sagen.
Abholung planen
	Perfekt. Wir haben ein Versandlabel an deine registrierte Telefonnummer und E‑Mail-Adresse gesendet. Bitte drucke es aus und klebe es auf dein Paket. Unser Team wird sich innerhalb der nächsten 24 bis 48 Stunden bei dir melden, um einen Abholtermin zu vereinbaren. Sobald der Artikel in unserem Lager eingegangen ist, dauert es 3 bis 5 Arbeitstage, bis die Erstattung für den Umtausch auf deinem Konto eingeht. Das umgetauschte Produkt hat einen geringeren Wert und du hast Anspruch auf eine Erstattung in Höhe von 5 $. Bitte teile uns mit, wie du die Erstattung erhalten möchtest. Du kannst beispielsweise „Store-Guthaben“ oder „Quellkonto“ sagen.
Store-Guthaben
	Vielen Dank für die Bestätigung, dass du deine Erstattung in Form von Guthaben in deiner Wallet erhalten möchtest. Möchtest du eine weitere Bestellung umtauschen?
no
	Vielen Dank für deinen Anruf.

Nicht zulässige Bestellung

Der Endnutzer wurde bereits authentifiziert. Der Kundenservicemitarbeiter prüft die letzte Bestellung und stellt fest, dass keine Produkte für einen Umtausch infrage kommen. Der Agent erfasst eine Bestellnummer vom Nutzer und stellt fest, dass die angegebene Bestellung keine infrage kommenden Produkte enthält.

Nutzereingabe	Antwort des KI-Agenten
	Wir haben in deiner letzten Bestellung keine Produkte gefunden, die umgetauscht werden können. Möchtest du Produkte aus einer anderen Bestellung umtauschen?
Ja
	Könntest du mir bitte die letzten fünf Ziffern der Bestell-ID des Artikels nennen, den du umtauschen möchtest?
23487
	Die letzten fünf Ziffern der Bestell-ID, die wir erhalten haben, sind 23487. Ist das richtig?
Ja
	Die Bestell-ID wurde erfasst.
	Leider enthält deine Bestellung keine Produkte, die gemäß unseren Richtlinien umgetauscht werden können. Weitere Informationen zu unseren Umtauschrichtlinien findest du auf unserer Website. Möchtest du eine weitere Bestellung umtauschen?
no
	Vielen Dank für deinen Anruf.

Namenskonventionen

Für diese vordefinierte Komponente gelten die folgenden Namenskonventionen:

Funktion	Format	Beispiel
Flow	[Component Name]	Order Status
Entitätstyp	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_exchange_order_location
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_exchange_order:get_product_exchange_availability

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

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

Parametername	Beschreibung	Format
$flow.max_retry_another_account	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn ausgewählt wird, ob mit einem alternativen Konto fortgefahren werden soll. Der Standardwert ist 3.	integer
$flow.max_retry_order_number	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn die letzten fünf Ziffern einer Bestellnummer angegeben werden. Der Standardwert ist 3.	integer
$flow.max_retry_another_order	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn eine andere Bestellung für die Rückgabe ausgewählt wird, falls die Bestell-ID nicht gefunden wird oder die Bestellung nicht für den Umtausch infrage kommt. Der Standardwert ist 2.	integer
$flow.max_retry_select_order_number	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn die vollständige Bestellnummer angegeben wird, falls mehr als eine Bestellung dieselben letzten fünf Ziffern hat. Der Standardwert ist 2.	integer
$flow.max_retry_exchange_reason	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn der Grund für den Umtausch angegeben wird. Der Standardwert ist 3.	integer
$flow.max_retry_exchange_reason_counter	Gibt die Anzahl der zulässigen Wiederholungsversuche beim Bestätigen des Grundes für den Umtausch an. Der Standardwert ist 2.	integer
$flow.order_product_exchange_reason_others	Gibt den Wert der Entität prebuilt_components_exchange_order_reason an, der darauf hinweist, dass der Nutzer „Andere“ als Grund für den Umtausch ausgewählt hat. Der Standardwert ist "others".	String
$flow.max_product_display_counter	Gibt die maximale Anzahl von Produkten an, die in einer einzelnen Runde präsentiert werden sollen. Der Standardwert ist 2.	integer
$flow.max_product_display	Gibt die maximale Anzahl von Produkten an, die während der gesamten Unterhaltung präsentiert werden sollen. Der Standardwert ist 9.	integer
$flow.max_product_exchange_confirm	Gibt die maximal zulässige Anzahl von Wiederholungsversuchen beim Bestätigen des ausgewählten Produkts an. Der Standardwert ist 2.	integer
$flow.max_retry_product_number_counter	Gibt die maximal zulässige Anzahl von Wiederholungsversuchen beim Auswählen eines Produkts für den Umtausch an. Der Standardwert ist 3.	integer
$flow.max_retry_select_quantity	Gibt die maximal zulässige Anzahl von Wiederholungsversuchen an, wenn die Menge des umzutauschenden Produkts ausgewählt wird. Der Standardwert ist 2.	integer
$flow.max_retry_size_number_counter	Gibt die maximal zulässige Anzahl von Wiederholungsversuchen an, wenn die Größe für den Umtausch ausgewählt wird. Der Standardwert ist 2.	integer
$flow.max_retry_another_zip_code	Gibt die maximal zulässige Anzahl von Versuchen an, eine Postleitzahl anzugeben. Der Standardwert ist 2.	integer
$flow.max_store_display_counter	Gibt die maximale Anzahl von Geschäften an, die in einer einzelnen Runde präsentiert werden sollen. Der Standardwert ist 1.	integer
$flow.max_store_display	Gibt die maximale Anzahl von Geschäften an, die während der gesamten Unterhaltung präsentiert werden sollen. Der Standardwert ist 10.	integer
$flow.max_retry_store_number_counter	Gibt die maximal zulässige Anzahl von Wiederholungsversuchen bei der Auswahl eines Geschäfts an. Der Standardwert ist 2.	integer
$flow.max_retry_store_selection	Gibt die Anzahl der zulässigen Wiederholungsversuche beim Bestätigen der Geschäftsauswahl an. Der Standardwert ist 3.	integer
$flow.max_available_address_reselection_counter	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn bestätigt werden soll, ob der Nutzer eine andere Geschäftsadresse auswählen möchte. Der Standardwert ist 2.	integer
$flow.order_payment_mode_COD	Gibt den Wert des Felds order_payment_mode an, das vom get_order_details-Webhook zurückgegeben wird und eine Zahlungsmethode per Nachnahme angibt. Der Standardwert ist "COD".	String
$flow.order_payment_mode_store_credit	Gibt den Wert des Felds order_payment_mode an, das vom get_order_details-Webhook zurückgegeben wird und eine Zahlungsmethode mit Store-Guthaben angibt. Der Standardwert ist "store_credit".	String
$flow.order_refund_mode_source_account	Gibt den Wert der Entität prebuilt_components_exchange_order_refund_mode an, der zeigt, dass der Nutzer die Erstattung auf sein ursprüngliches Konto ausgewählt hat. Der Standardwert ist source_account.	String
$flow.order_exchange_location_scheduled_for_pickup	Gibt den Wert der Entität prebuilt_components_exchange_order_location an, der angibt, dass der Nutzer eine Abholung für den Umtausch geplant hat. Der Standardwert ist scheduled_for_pickup.	String

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

Generatoren

Diese Komponente verwendet Generatoren, um bestimmte Teile der Unterhaltung zu ermöglichen.

FAQ

Der FAQ-Generator wird verwendet, um häufig gestellte Fragen zu Rückgaben und Umtausch zu beantworten, darunter:

• Gibt es eine Frist für die Rückgabe?
• Kann ich ein Geschenk umtauschen?
• Der Produktpreis und der Erstattungsbetrag sind unterschiedlich. Warum ist das so?

Zusammenfassung

Der Generator Summarization wird verwendet, um eine Zusammenfassung nach dem Anruf zu erstellen, in der die von der Komponente verarbeitete Unterhaltung beschrieben wird.

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_exchange_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, 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_product_count	Die Anzahl der eindeutigen Produkte in einer Bestellung.	integer
order_payment_mode	Gibt die Zahlungsart an, die bei der Bestellung verwendet wurde.	String
exchangeable_product_id	Liste der Produkt-IDs für umtauschbare Produkte innerhalb der Bestellung.	Liste (String)
exchangeable_product_name	Liste der Produktnamen für umtauschbare Produkte innerhalb der Bestellung.	Liste (String)
exchangeable_product_brand_name	Liste der Markennamen für austauschbare Produkte innerhalb der Bestellung.	Liste (String)
exchangeable_product_quantity	Liste der Mengen für umtauschbare Produkte innerhalb der Bestellung.	Liste (String)
exchangeable_product_price	Liste der Preise für umtauschbare Produkte innerhalb der Bestellung.	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_exchange_order: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.

Details zu doppelten Bestellungen abrufen

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

Maximieren Sie die Anleitung, um den Webhook „Get duplicate order details“ 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_retail_services:get_duplicate_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.

Verfügbare Umtauschgröße abrufen

Der Webhook prebuilt_components_exchange_order:get_available_exchange_size wird von der Komponente verwendet, um verfügbare Größen für den Umtausch abzurufen, wenn der Nutzer einen Artikel aufgrund von Größen- oder Passformproblemen umtauschen möchte.

API-Anfrageparameter

Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.

Parametername	Beschreibung	Eingabeformat
$flow.selected_order_product_id	Produkt-ID des Produkts, das der Nutzer umtauschen möchte.	String

API-Antwortparameter

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

Parametername	Beschreibung	Ausgabeformat
product_available_sizes	Liste der verfügbaren Größen für das ausgewählte Produkt.	Liste (String)

Maximieren Sie die Anleitung, um den Webhook „Verfügbare Umtauschgröße 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_exchange_order:get_available_exchange_size“ 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.

Verfügbarkeit des Produktumtauschs abrufen

Der Webhook prebuilt_components_exchange_order:get_product_exchange_availability wird von der Komponente verwendet, um zu prüfen, ob das vom Nutzer ausgewählte Produkt, die Menge und die optionale Größe für den Umtausch verfügbar sind.

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
$flow.selected_order_product_id	Produkt-ID des Produkts, das der Nutzer umtauschen möchte.	String
$flow.order_product_quantity_exchange_count	Anzahl der Produkte, die der Nutzer umtauschen möchte.	integer
$flow.product_selected_size	Größe des Produkts, gegen das der Nutzer das Produkt umtauschen möchte.	String

API-Antwortparameter

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

Parametername	Beschreibung	Ausgabeformat
product_exchange_availability	Gibt an, ob das ausgewählte Produkt, die Menge und die Größe für einen Umtausch verfügbar sind.	boolean
product_exchange_price	Gibt den Umtauschpreis für einen einzelnen Artikel des ausgewählten Produkts und der ausgewählten Größe an.	Zahl

Maximieren Sie die Anleitung, um den Webhook „Verfügbarkeit des Produktumtauschs 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_exchange_order:get_product_exchange_availability“ 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.

Ticket für unvollständige Bestellung erstellen

Der Webhook prebuilt_components_exchange_order:raise_incomplete_order_ticket wird von der Komponente verwendet, um ein Ticket zu erstellen, wenn der Nutzer ein Produkt innerhalb einer Bestellung umtauschen möchte, weil es unvollständig ist.

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 ein Ticket eingereicht werden soll.	String
$flow.selected_order_product_id	Produkt-ID des Produkts, das der Nutzer umtauschen möchte.	String
$flow.order_product_quantity_exchange_count	Anzahl der Produkte, die der Nutzer umtauschen möchte.	integer
$flow.order_product_exchange_reason	Der Grund, warum der Nutzer das Produkt umtauschen möchte.	String

Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren des Webhooks „Raise incomplete order ticket“ 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_exchange_order:raise_incomplete_order_ticket“ 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.

Details zum App-Shop abrufen

Der Webhook prebuilt_components_exchange_order:get_store_details wird von der Komponente verwendet, um die Liste der Geschäfte in der Nähe der vom Nutzer angegebenen Postleitzahl abzurufen.

API-Anfrageparameter

Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.

Parametername	Beschreibung	Eingabeformat
$flow.zip_code	Postleitzahl, um nach Geschäften in der Nähe zu suchen.	String

API-Antwortparameter

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

Parametername	Beschreibung	Ausgabeformat
store_id	Liste der Geschäfts-IDs.	Liste (String)
store_address	Liste der Geschäftsadressen, die den einzelnen Elementen von store_id entsprechen.	Liste (String)

Maximieren Sie die Anleitung, um den Webhook „Get store details“ 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_exchange_order:get_store_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.

Details zum Post-Exchange

Der Webhook prebuilt_components_exchange_order:post_exchange_details wird von der Komponente verwendet, um einen Austausch 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 ein Ticket eingereicht werden soll.	String
$flow.selected_order_product_id	Produkt-ID des Produkts, das der Nutzer umtauschen möchte.	String
$flow.order_product_quantity_exchange_count	Anzahl der Produkte, die der Nutzer umtauschen möchte.	integer
$flow.product_selected_size	Größe des Produkts, gegen das der Nutzer das Produkt umtauschen möchte.	String
$flow.order_product_exchange_reason	Der Grund, warum der Nutzer das Produkt umtauschen möchte.	String
$flow.order_exchange_location	Der ausgewählte Modus für die Anzeigenplattform. Gültige Werte werden durch die Entität prebuilt_components_exchange_order_location definiert.	String
$flow.order_exchange_store_id	Die ID des Geschäfts, das der Nutzer für einen Umtausch im Geschäft ausgewählt hat.	String
$flow.order_refund_mode	Die Zahlungsart für die Erstattung, falls zutreffend. Gültige Werte werden durch die Entität prebuilt_components_exchange_order_refund_mode definiert. Wenn keine Erstattung erforderlich ist, ist dieser Wert null.	String
$flow.total_refund_amount	Der zu erstattende Betrag, wenn der Preis des umzutauschenden Produkts höher ist als der des neuen Produkts. Wenn keine Erstattung erforderlich ist, ist dieser Wert null.	integer

API-Antwortparameter

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

Parametername	Beschreibung	Ausgabeformat
order_exchange_ticket_id	Ticket-ID für den eingereichten Umtausch.	String

Maximieren Sie die Anleitung, um den Webhook „Post exchange details“ 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_exchange_order:post_exchange_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.

Informationen zur Erstattung per Nachnahme senden

Der Webhook prebuilt_components_exchange_order:send_COD_refund_information wird von der Komponente verwendet, um einem Nutzer umtauschbezogene Zahlungsinformationen 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 ein Ticket eingereicht werden soll.	String
$flow.channel	Der spezifische Kanal, an den Informationen gesendet werden sollen. Gültige Werte werden durch die Entität prebuilt_components_channel_email_phone definiert. Standardmäßig werden phone und email unterstützt.	String

Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren des Webhooks „Send COD refund information“ 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_exchange_order:send_COD_refund_information“ 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.