Vordefinierte Komponente für Eintauschbestellungen

Die vorgefertigte Komponente für den Tauschauftrag 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 Erstattung und Versandmethoden auswählen. Diese Komponente verwendet die vorgefertigte Komponente Retail authentication (Einzelhandelsauthentifizierung), um Nutzer zu authentifizieren. Die Komponente verwendet auch Generators für die Zusammenfassung nach dem Anruf und 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

Die folgenden Beispieldialoge veranschaulichen gängige Szenarien, die von dieser vordefinierten Komponente abgedeckt werden. Die Beispiel-Dialoge zeigen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dies löst den Standard-Begrüßungs-Intent und die erste Agent-Antwort zu Beginn der Unterhaltung aus.

Umtausch im Geschäft wegen eines defekten Artikels

Der Endnutzer wurde bereits authentifiziert. Der Kundenservicemitarbeiter bestätigt, welche Artikel aus der letzten Bestellung getauscht werden sollen, und erfragt den Grund für den Tausch. Der Nutzer wählt aus, 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 Kundenservicemitarbeiter generiert ein Versandlabel, das an die registrierten Channels des Nutzers gesendet wird.

Nutzereingabe	Antwort des KI-Agenten
	Rufen Sie wegen Ihrer letzten Bestellung mit der Nummer, die auf 12375 endet, an? Diese Bestellung wurde am 10.11.2023 aufgegeben und enthält 2 Lampen, 2 Pixel und 10 weitere Produkte.
Ja
	Wir haben einige berechtigte Produkte in Ihrer Bestellung gefunden. Bitte teilen Sie uns mit, welches Produkt Sie umtauschen möchten. Produkt 1: Google-Lampe, Produkt 2: Google Pixel, Produkt 3: Google-LED-Licht. Bitte nennen oder geben Sie die Produktnummer des Artikels ein, den Sie auswählen möchten, oder sagen Sie „Weiter“, um weitere Produkte anzeigen zu lassen.
1
	Bitte bestätige, dass du die Google-Lampe umtauschen möchtest. Ist das richtig?
Ja
	Wir sehen, dass die verfügbare Menge des von Ihnen ausgewählten Produkts 2 ist. Geben Sie bitte die Anzahl der Produkte an, die Sie umtauschen möchten.
Zwei
	Geben Sie den Grund für den Umtausch an. Sie können beispielsweise angeben, dass der Artikel defekt ist oder nicht funktioniert, dass es Probleme mit der Größe oder Passform gibt, dass die Bestellung unvollständig ist, dass es Probleme mit dem Stil gibt oder dass die Farbe falsch ist.
Artikel ist mangelhaft
	Vielen Dank für die Information. Wie möchten Sie das Produkt tauschen? Sie können beispielsweise sagen: „Im Geschäft umtauschen“ oder „Abholung planen“.
Ich möchte den Artikel in einem Geschäft umtauschen
	Lass uns ein Geschäft in deiner Nähe finden.
	Der Agent erfasst die Postleitzahl mithilfe der vorgefertigten Komponente Postleitzahl erfassen.
	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. Nennen oder geben Sie die Adressnummer ein, die Sie auswählen möchten, oder sagen Sie „Weiter“, um weitere Geschäftsadressen aufzurufen.
Das erste Geschäft
	Zur Bestätigung: 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 Ihre registrierte Telefonnummer und E‑Mail-Adresse gesendet. Bitte drucken Sie es aus, bringen Sie es an Ihrem Paket an und geben Sie das Gerät innerhalb von 30 Tagen ab. Sobald der Artikel in unserem Lager eingegangen ist, dauert es drei bis fünf Arbeitstage, bis ein eventueller Umtausch in deinem Konto angezeigt wird. Hinweis: Der Erstattungsbetrag beinhaltet keine Versand- und Bearbeitungsgebühren. Das Ersatzprodukt hat einen höheren Wert. Die Preisdifferenz beträgt 20$. Sie erhalten den Zahlungslink in Kürze auf Ihre registrierte Mobiltelefonnummer. Bitte führe die Zahlung innerhalb von 24 Stunden durch, um den Umtausch zu veranlassen. Möchtest du eine weitere Bestellung umtauschen?
Nein, das war alles.
	Vielen Dank für Ihren Anruf.

Erstattung für Preisdifferenz

Der Endnutzer wurde bereits authentifiziert. Der Kundenservicemitarbeiter erfasst die Bestellnummer, das Produkt, das getauscht werden soll, und den Grund für den Tausch. Der Nutzer entscheidet sich, die Artikel gegen eine andere Größe einzutauschen, und plant eine Abholung. Der Kundenservicemitarbeiter stellt fest, dass der Preis des getauschten Artikels niedriger ist als der des neuen Artikels, und fragt den Nutzer nach der Zahlungsmethode für die Erstattung.

Nutzereingabe	Antwort des KI-Agenten
	Rufen Sie wegen Ihrer letzten Bestellung mit der Bestellnummer, die auf 12345 endet, an? Die Bestellung vom 10.11.2023 enthält zwei Lampen.
Nein
	Möchten Sie eine weitere Bestellung umtauschen?
Ja
	Könnten Sie uns bitte die letzten fünf Ziffern der Bestell-ID des Artikels mitteilen, den Sie umtauschen möchten?
12346
	Die letzten fünf Ziffern der Bestell-ID, die wir erhalten haben, sind 12346. Stimmt das?
Ja
	Wir haben die Bestell-ID erfasst. Wir haben einige berechtigte Produkte in deiner Bestellung gefunden. Bitte teilen Sie uns mit, welches Produkt Sie umtauschen möchten. Produkt 1: Google-Wasserflasche, Produkt 2: Google-T-Shirt. Bitte nennen oder geben Sie die Produktnummer des Artikels ein, den Sie auswählen möchten, oder sagen Sie „Weiter“, um weitere Produkte anzeigen zu lassen.
Zwei
	Bitte bestätige, dass du das Google-T-Shirt umtauschen möchtest. Ist das richtig?
Ja
	Geben Sie den Grund für den Umtausch an. Sie können beispielsweise Folgendes angeben: „Artikel defekt oder funktioniert nicht“, „Größe oder Passform nicht passend“, „Bestellung unvollständig“, „Stil nicht passend“, „Falsche Farbe“ oder „Sonstiges“.
Probleme mit der Größe oder Passform
	Vielen Dank, dass Sie uns den Grund für den Umtausch mitgeteilt haben. Bitte teilen Sie uns mit, welche Größe Sie möchten. Wir haben die folgenden Größen verfügbar: Sag 1 für Small. Sag 2 für Medium. Sag 3 für Large. Sag 4 für XL. Sag 5 für Double-XL.
1
	Wie möchten Sie das Produkt umtauschen? Sie können beispielsweise sagen: „Im Geschäft umtauschen“ oder „Abholung planen“.
Abholung planen
	Perfekt. Wir haben ein Versandlabel an Ihre registrierte Telefonnummer und E‑Mail-Adresse gesendet. Bitte drucken Sie es aus und legen Sie es Ihrem Paket bei. Unser Team wird sich innerhalb der nächsten 24 bis 48 Stunden bei Ihnen melden, um eine Abholung zu vereinbaren. Sobald wir den Artikel in unserem Lager erhalten haben, dauert es drei bis fünf Arbeitstage, bis die Erstattung für den Umtausch in Ihrem Konto angezeigt wird. Ihr umgetauschtes Produkt hat einen geringeren Wert und Sie haben Anspruch auf eine Erstattung von 5$. Bitte teilen Sie uns mit, wo Sie die Erstattung erhalten möchten. Sie können beispielsweise „Gutschrift“ oder „Quellkonto“ sagen.
Store-Guthaben
	Vielen Dank für die Bestätigung, dass Sie die Erstattung auf Ihr Guthabenkonto erhalten möchten. Möchten Sie eine weitere Bestellung umtauschen?
no
	Vielen Dank für Ihren Anruf.

Nicht berechtigte Bestellung

Der Endnutzer wurde bereits authentifiziert. Der Agent prüft die letzte Bestellung und stellt fest, dass keine Produkte für einen Umtausch infrage kommen. Der Kundenservicemitarbeiter erfragt 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 Ihrer letzten Bestellung keine Produkte gefunden, die für einen Umtausch infrage kommen. Möchten Sie ein anderes Produkt umtauschen?
Ja
	Könntest du uns bitte die letzten fünf Ziffern der Bestell-ID des Artikels mitteilen, den du umtauschen möchtest?
23487
	Die letzten fünf Ziffern der Bestell-ID, die wir erhalten haben, sind 23487. Ist das richtig?
Ja
	Wir haben die Bestell-ID erhalten.
	Leider sind keine Produkte in Ihrer Bestellung enthalten, die gemäß unseren Richtlinien für einen Umtausch infrage kommen. Weitere Informationen zu unseren Umtauschrichtlinien finden Sie auf unserer Website. Möchten Sie eine weitere Bestellung umtauschen?
no
	Vielen Dank für Ihren Anruf.

Namenskonventionen

Für diese vorgefertigte 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 werden verwendet, um bestimmte Verhaltensweisen der Komponente zu konfigurieren. Die Parameter werden von einer oder mehreren Bedingungen im Ablauf verwendet, um das Verhalten der Komponente zu bestimmen. Parameter auf Flow-Ebene müssen auf der Startseite der Komponente festgelegt werden. Parameter mit Sitzungsbereich können entweder durch einen aufrufenden Flow oder auf der Startseite dieser Komponente festgelegt werden.

Diese vorgefertigte Komponente akzeptiert die folgenden Eingabeparameter:

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	(Optional) Die lokale Telefonnummer des Nutzers ohne die Ländervorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
$session.params.all_recent_order_id	(optional) Mit diesem Parameter werden Bestell-IDs aufgeführt, die dem authentifizierten Nutzer zugeordnet sind. Sie sind nach dem Datum der Bestellung in absteigender Reihenfolge sortiert. 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 vorgefertigten Komponente können Sie das Verhalten der Komponente, einschließlich Wiederholungsversuchen, mit den folgenden optionalen Parametern 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 sich die letzten fünf Ziffern mehrerer Bestellungen gleichen. 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 an, wenn der Grund für den Umtausch bestätigt wird. Der Standardwert ist 2.	integer
$flow.order_product_exchange_reason_others	Gibt den Wert der prebuilt_components_exchange_order_reason-Einheit an, der angibt, 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 der Produkte an, die in einem einzelnen Zug präsentiert werden sollen. Der Standardwert ist 2.	integer
$flow.max_product_display	Gibt die maximale Anzahl der Produkte an, die während des gesamten Gesprächs präsentiert werden sollen. Der Standardwert ist 9.	integer
$flow.max_product_exchange_confirm	Gibt die maximal zulässige Anzahl an Wiederholungsversuchen an, wenn das ausgewählte Produkt bestätigt wird. Der Standardwert ist 2.	integer
$flow.max_retry_product_number_counter	Gibt die maximale Anzahl der zulässigen Wiederholungsversuche 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 an Wiederholungsversuchen an, wenn die Menge des zu tauschenden Produkts ausgewählt wird. Der Standardwert ist 2.	integer
$flow.max_retry_size_number_counter	Gibt die maximale Anzahl der Wiederholungsversuche an, die beim Auswählen der Größe für den Umtausch zulässig sind. Der Standardwert ist 2.	integer
$flow.max_retry_another_zip_code	Gibt die maximal zulässige Anzahl an Wiederholungsversuchen bei der Angabe einer Postleitzahl an. Der Standardwert ist 2.	integer
$flow.max_store_display_counter	Gibt die maximale Anzahl von Geschäften an, die in einem einzelnen Zug präsentiert werden sollen. Der Standardwert ist 1.	integer
$flow.max_store_display	Gibt die maximale Anzahl der Geschäfte an, die während des gesamten Gesprächs präsentiert werden sollen. Der Standardwert ist 10.	integer
$flow.max_retry_store_number_counter	Gibt die maximale Anzahl der Wiederholungsversuche an, die beim Auswählen eines Geschäfts zulässig sind. Der Standardwert ist 2.	integer
$flow.max_retry_store_selection	Gibt die Anzahl der Wiederholungsversuche an, die beim Bestätigen der Geschäftsauswahl zulässig sind. Der Standardwert ist 3.	integer
$flow.max_available_address_reselection_counter	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn bestätigt wird, 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 Nachnahme-Zahlungsmethode 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 prebuilt_components_exchange_order_refund_mode-Entität an, der angibt, dass der Nutzer eine Erstattung auf sein Quellkonto ausgewählt hat. Der Standardwert ist source_account.	String
$flow.order_exchange_location_scheduled_for_pickup	Gibt den Wert der prebuilt_components_exchange_order_location-Entität an, der angibt, dass der Nutzer die Abholung für den Umtausch geplant hat. Der Standardwert ist scheduled_for_pickup.	String

Wenn Sie die Eingabeparameter für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung 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 Bereich Seiten auf die Startseite.
7. Klicken Sie auf der Startseite auf die richtige Route.
8. Bearbeiten Sie im Fenster „Route“ die Werte für Parameter-Voreinstellungen nach Bedarf.
9. Klicken Sie auf Speichern.

Ausgabeparameter

Ausgabeparameter sind Sitzungsparameter, die nach dem Beenden 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 Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
all_recent_order_id	Dieser Parameter enthält eine Liste der Bestell-IDs, 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 mit dem Konto registrierte E‑Mail-Adresse.	String
user_first_name	Der Vorname des Nutzers, der zur Begrüßung und zur Bestätigung des Kontoinhabers verwendet wird.	String
transfer_reason	Dieser Parameter gibt den Grund für das Beenden des Ablaufs an, falls er nicht erfolgreich war. Der zurückgegebene Wert ist einer der folgenden: agent: Der Endnutzer hat während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert. denial_of_information: Der Endnutzer hat abgelehnt, von der Komponente angeforderte Informationen weiterzugeben. max_no_input: Die Unterhaltung hat die maximale Anzahl von Wiederholungsversuchen für No-Input-Ereignisse 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 ohne Übereinstimmung. webhook_error: Ein Webhook-Fehler ist aufgetreten. Weitere Informationen finden Sie unter webhook.error (integriertes Ereignis). webhook_not_found: Eine Webhook-URL war nicht erreichbar. Weitere Informationen finden Sie unter webhook.error.not-found (integriertes Ereignis).	String

Generatoren

Diese Komponente verwendet Generatoren, um bestimmte Teile des Gesprächs zu ermöglichen.

FAQ

Der FAQ-Generator wird verwendet, um häufig gestellte Fragen zu Rückgaben und Umtauschartikeln zu beantworten, z. B.:

• Gibt es eine Frist für die Rückgabe?
• Kann ich einen Geschenkartikel umtauschen?
• Der Produktpreis und der Erstattungsbetrag sind unterschiedlich. Warum?

Zusammenfassung

Mit dem Summarization-Generator wird eine Zusammenfassung nach dem Anruf generiert, in der die von der Komponente behandelte Unterhaltung beschrieben wird.

Grundlegende Einrichtung

So richten Sie diese vordefinierte Komponente ein:

1. Vordefinierte Komponente importieren
2. Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unter Webhook-Einrichtung.

Webhook-Einrichtung

Um diese Komponente verwenden zu können, müssen Sie die enthaltenen flexiblen Webhooks konfigurieren, um die erforderlichen Informationen von Ihren externen Diensten abzurufen.

Authentifizierung

Wenn Sie die für die Authentifizierung erforderlichen externen Dienste noch nicht konfiguriert haben, müssen Sie dies tun, um die Authentifizierung von Nutzern für diese Komponente zu aktivieren. Eine ausführliche Anleitung finden Sie unter Webhook für die Einzelhandelsauthentifizierung einrichten.

Ruf Bestellinformationen ab

Der prebuilt_components_exchange_order: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	Das 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 austauschbare Produkte in der Bestellung.	Liste (String)
exchangeable_product_name	Liste der Produktnamen für austauschbare Produkte in der Bestellung.	Liste (String)
exchangeable_product_brand_name	Liste der Markennamen für austauschbare Produkte in der Bestellung.	Liste (String)
exchangeable_product_quantity	Liste der Mengen für austauschbare Produkte in der Bestellung.	Liste (String)
exchangeable_product_price	Liste der Preise für austauschbare Produkte in der Bestellung.	Liste (String)

Wenn Sie den Webhook „Bestelldetails abrufen“ für diese Komponente konfigurieren möchten, maximieren Sie die Anleitung.

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 Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
9. 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 benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
11. Klicken Sie auf Speichern.

Details zu doppelten Bestellungen abrufen

Der prebuilt_components_retail_services:get_duplicate_order_details-Webhook 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 einen oder mehrere Bestellungen des Nutzers 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 dem gleichen Element im all_order_time-Array.	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 dem gleichen Element im all_order_date-Array.	Liste (String)

Wenn Sie den Webhook „Get duplicate order details“ für diese Komponente konfigurieren möchten, maximieren Sie die Anleitung.

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 Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
9. 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 benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
11. Klicken Sie auf Speichern.

Verfügbare Trade-In-Größe abrufen

Der prebuilt_components_exchange_order:get_available_exchange_size-Webhook 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	Die Produkt-ID des Produkts, das der Nutzer eintauschen möchte.	String

API-Antwortparameter

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

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

Wenn Sie den Webhook „Get available exchange size“ für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um die Anleitung aufzurufen.

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 Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
9. 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 benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
11. Klicken Sie auf Speichern.

Verfügbarkeit von Produktumtausch abrufen

Der prebuilt_components_exchange_order:get_product_exchange_availability-Webhook 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 Tausch 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	Die Produkt-ID des Produkts, das der Nutzer eintauschen möchte.	String
$flow.order_product_quantity_exchange_count	Menge des Produkts, das der Nutzer umtauschen möchte.	integer
$flow.product_selected_size	Die Größe des Produkts, das der Nutzer umtauschen möchte.	String

API-Antwortparameter

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

Parametername	Beschreibung	Ausgabeformat
product_exchange_availability	Gibt an, ob das ausgewählte Produkt, die ausgewählte Menge und die ausgewählte 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

Wenn Sie den Webhook „Get product exchange availability“ für diese Komponente konfigurieren möchten, maximieren Sie die Anleitung.

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 Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
9. 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 benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
11. Klicken Sie auf Speichern.

Ticket für unvollständige Bestellung erstellen

Der prebuilt_components_exchange_order:raise_incomplete_order_ticket-Webhook 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 Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
$flow.order_id	Die Auftrags-ID, für die Sie ein Ticket einreichen möchten.	String
$flow.selected_order_product_id	Die Produkt-ID des Produkts, das der Nutzer eintauschen möchte.	String
$flow.order_product_quantity_exchange_count	Menge des Produkts, das der Nutzer umtauschen möchte.	integer
$flow.order_product_exchange_reason	Der Grund, warum der Nutzer das Produkt umtauschen möchte.	String

Wenn Sie den Webhook „Raise incomplete order ticket“ für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung aufzurufen.

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 Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
9. 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 benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
11. Klicken Sie auf Speichern.

Geschäftsdetails abrufen

Der prebuilt_components_exchange_order:get_store_details-Webhook 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 und von der Komponente verwendet.

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)

Wenn Sie den Webhook „Get store details“ für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um die Anleitung aufzurufen.

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 Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
9. 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 benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
11. Klicken Sie auf Speichern.

Details zum Beitrag

Der prebuilt_components_exchange_order:post_exchange_details-Webhook wird von der Komponente verwendet, um einen Umtausch einzureichen.

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 Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
$flow.order_id	Die Auftrags-ID, für die Sie ein Ticket einreichen möchten.	String
$flow.selected_order_product_id	Die Produkt-ID des Produkts, das der Nutzer eintauschen möchte.	String
$flow.order_product_quantity_exchange_count	Menge des Produkts, das der Nutzer umtauschen möchte.	integer
$flow.product_selected_size	Die Größe des Produkts, das der Nutzer 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 den Austausch. Gültige Werte werden durch die prebuilt_components_exchange_order_location-Einheit definiert.	String
$flow.order_exchange_store_id	Die Store-ID für den Store, den der Nutzer für einen Store-Tausch ausgewählt hat.	String
$flow.order_refund_mode	Die Zahlungsart für die Erstattung, falls zutreffend. Gültige Werte werden durch die prebuilt_components_exchange_order_refund_mode-Einheit definiert. Wenn keine Erstattung erforderlich ist, lautet der 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, lautet der Wert null.	integer

API-Antwortparameter

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

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

Wenn Sie den Webhook für die Details zum Beitragstausch für diese Komponente konfigurieren möchten, maximieren Sie die Anleitung.

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 Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
9. 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 benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
11. Klicken Sie auf Speichern.

Informationen zur Nachnahmeerstattung senden

Der prebuilt_components_exchange_order:send_COD_refund_information-Webhook wird von der Komponente verwendet, um tauschbezogene Zahlungsinformationen an einen Nutzer 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 Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
$flow.order_id	Die Auftrags-ID, für die Sie ein Ticket einreichen möchten.	String
$flow.channel	Der spezifische Kanal, an den Informationen gesendet werden sollen. Gültige Werte werden durch die prebuilt_components_channel_email_phone-Einheit definiert. Standardmäßig werden phone und email unterstützt.	String

Wenn Sie den Webhook „COD-Erstattungsdaten senden“ für diese Komponente konfigurieren möchten, maximieren Sie die Anleitung.

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 Feld Webhook-URL von Dialogflow CX durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die richtige Methode aus.
8. Prüfen und aktualisieren Sie den Anfragetext, damit er dem richtigen Anfrageformat für Ihren Webhook entspricht.
9. 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 benötigt werden, um auf die zurückgegebenen Feldwerte zuzugreifen.
10. Prüfen Sie die Authentifizierungseinstellungen und aktualisieren Sie sie bei Bedarf.
11. Klicken Sie auf Speichern.

Abgeschlossen

Ihr KI‑Agent und seine Webhooks sollten jetzt eingerichtet sein und können getestet werden.