Vordefinierte Komponente für Eintauschbestellungen

Die vorgefertigte Komponente für den Austauschauftrag prüft die Authentifizierungsebene eines Nutzers. Nach der Authentifizierung des Nutzers liefert die Komponente Informationen zu seinen letzten oder früheren Bestellungen. Der Nutzer kann dann mehrere Artikel in einer Bestellung umtauschen und Optionen wie Erstattungs- und Versandmethoden auswählen. Diese Komponente verwendet die vorgefertigte Komponente Einzelhandel – 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

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.

Austausch im Geschäft für einen defekten Artikel

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 wählt aus, die Artikel in einem Geschäft umzutauschen, und der Kundenservicemitarbeiter stellt eine Liste der nächstgelegenen Geschäfte zur Verfügung. Der Nutzer wählt einen Shop aus und der Kundenservicemitarbeiter generiert ein Versandlabel, das an die registrierten Kanäle des Nutzers gesendet wird.

Nutzereingabe	Antwort des Kundenservicemitarbeiters
	Geht es um Ihre letzte Bestellung mit der Bestellnummer, die auf 12375 endet, und die am 10. 11. 2023 aufgegeben wurde und zwei Lampen, zwei Google Pixel und zehn weitere Produkte enthält?
Ja
	Wir haben in Ihrer Bestellung einige infrage kommende Produkte gefunden. Bitte teilen Sie uns mit, welches Produkt Sie umtauschen möchten. Produkt 1: Google-Lampe, Produkt 2: Google Pixel, Produkt 3: Google-LED-Lampe. Sagen oder geben Sie die Produktnummer des Artikels ein, den Sie auswählen möchten, oder sagen Sie „Nächster“, um weitere Produkte zu sehen.
1
	Sie möchten die Google-Lampe umtauschen. Ist das richtig? Ist das richtig?
Ja
	Die verfügbare Menge des von Ihnen ausgewählten Produkts beträgt 2. Geben Sie die Anzahl der Produkte an, die Sie umtauschen möchten.
Zwei
	Geben Sie bitte den Grund für den Umtausch an. Du könntest z. B. sagen: „Der Artikel ist defekt oder funktioniert nicht“, „Problem mit Größe oder Passform“, „Problem mit unvollständiger Bestellung“, „Problem mit Stil“, „Falsche Farbe“ oder etwas anderes.
Artikel defekt
	Vielen Dank für die Information. Wie möchten Sie das Produkt umtauschen? Du kannst z. B. sagen: „Im Geschäft umtauschen“ oder „Abholung planen“.
Ich möchte den Artikel im Geschäft umtauschen
	Suchen wir ein Geschäft in Ihrer Nähe.
	Kundenservicemitarbeiter erfasst die Postleitzahl mit der vorgefertigten Komponente Postleitzahlerfassung
	Hier ist eine 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 Adressennummer an, die Sie auswählen möchten, oder sagen Sie „Nächster“, um weitere Geschäftsadressen zu sehen.
Der erste Store
	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 es innerhalb von 30 Tagen ab. Sobald der Artikel in unserem Lager eingegangen ist, dauert es drei bis fünf Arbeitstage, bis der Umtausch (falls zutreffend) in Ihrem Konto angezeigt wird. Hinweis: Die Versand- und Bearbeitungsgebühren sind nicht im Erstattungsbetrag enthalten. Ihr Umtauschprodukt hat einen höheren Wert. Die Preisdifferenz beträgt 20$. Sie erhalten den Zahlungslink bald an Ihre registrierte Mobiltelefonnummer. Bitte führen Sie die Zahlung innerhalb von 24 Stunden durch, um den Umtausch vorzunehmen. Möchten Sie eine andere Bestellung umtauschen?
Nein, das war's.
	Vielen Dank für Ihren Anruf.

Erstattung der Preisdifferenz

Der Endnutzer wurde bereits authentifiziert. Der Kundenservicemitarbeiter erfragt die Bestellnummer, das zu tauschende Produkt und den Grund für den Umtausch. Der Nutzer entscheidet sich, die Artikel gegen eine andere Größe umzutauschen, und vereinbart einen Abholtermin. Der Kundenservicemitarbeiter stellt fest, dass der Preis des umgetauschten Artikels niedriger ist als der des neuen Artikels, und bestätigt mit dem Nutzer die Zahlungsmethode für eine Erstattung.

Nutzereingabe	Antwort des Kundenservicemitarbeiters
	Geht es um Ihre letzte Bestellung mit der Nummer 12345, die am 10.11.2023 aufgegeben wurde und zwei Lampen enthält?
Nein
	Möchten Sie eine andere Bestellung umtauschen?
Ja
	Nennen Sie mir bitte die letzten fünf Ziffern Ihrer Bestell-ID, die Sie umtauschen möchten.
12346
	Die letzten fünf Ziffern der Bestell-ID, die wir erhalten haben, lauten 12346. Ist das richtig?
Ja
	Super, wir haben die Bestell-ID erfasst. Wir haben einige infrage kommende Produkte in Ihrer Bestellung gefunden. Bitte teilen Sie uns mit, welches Produkt Sie umtauschen möchten. Produkt 1: Google-Wasserflasche, Produkt 2: Google-T-Shirt. Sagen oder geben Sie die Produktnummer des Artikels ein, den Sie auswählen möchten, oder sagen Sie „Nächster“, um weitere Produkte zu sehen.
Zwei
	Sie möchten das Google-T-Shirt umtauschen. Ist das richtig?
Ja
	Geben Sie bitte den Grund für den Umtausch an. Du kannst z. B. sagen: „Der Artikel ist defekt oder funktioniert nicht“, „Problem mit Größe oder Passform“, „Problem mit unvollständiger Bestellung“, „Problem mit Stil“, „Falsche Farbe“ oder etwas anderes.
Problem mit Größe oder Passform
	Vielen Dank, dass Sie uns den Grund für den Umtausch mitgeteilt haben. Nennen Sie uns bitte die Größe, die Sie im Austausch erhalten möchten. Wir haben die folgenden Größen auf Lager: Sagen Sie „1“ für klein. Sagen Sie „2“ für mittel. Sagen Sie „3“ für groß. Sagen Sie „4“ für XL. Sagen Sie „5“ für doppelt XL.
1
	Wie möchten Sie das Produkt umtauschen? Du kannst z. B. 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 ihn aus und kleben Sie ihn auf das Paket. Unser Team wird sich innerhalb der nächsten 24 bis 48 Stunden mit Ihnen in Verbindung setzen, um einen Termin für die 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 niedrigeren Wert und Sie erhalten eine Erstattung in Höhe von 5 €. Bitte teilen Sie uns mit, wo Sie die Erstattung erhalten möchten. Sie können beispielsweise „Guthaben“ oder „Quellkonto“ sagen.
Store-Guthaben
	Vielen Dank, dass Sie bestätigt haben, dass die Erstattung auf Ihr Wallet zurückgebucht werden soll. Möchten Sie eine andere Bestellung umtauschen?
no
	Vielen Dank für Ihren Anruf.

Unzulässige Bestellung

Der Endnutzer wurde bereits authentifiziert. Der Kundenservicemitarbeiter sieht sich die letzte Bestellung an und stellt fest, dass keine Produkte für den Umtausch infrage kommen. Der Kundenservicemitarbeiter erfragt die Bestellnummer des Nutzers und stellt fest, dass die angegebene Bestellung keine infrage kommenden Produkte enthält.

Nutzereingabe	Antwort des Kundenservicemitarbeiters
	Wir haben in Ihrer letzten Bestellung keine Produkte gefunden, die umgetauscht werden können. Möchten Sie eine andere Bestellung umtauschen?
Ja
	Nennen Sie mir bitte die letzten fünf Ziffern Ihrer Bestell-ID, die Sie umtauschen möchten.
23487
	Die letzten fünf Ziffern der Bestell-ID, die wir erhalten haben, lauten 23487. Ist das richtig?
Ja
	Sehr gut. Wir haben die Bestell-ID erfasst.
	Es befinden sich keine Produkte in Ihrer Bestellung, die gemäß unseren Richtlinien umgetauscht werden können. Weitere Informationen zu unseren Umtauschrichtlinien finden Sie auf unserer Website. Möchten Sie eine andere 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]	Bestellstatus
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

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

Mit dieser vordefinierten Komponente können Sie das Verhalten der Komponente, einschließlich der Wiederholungen, mit den folgenden optionalen Parametern konfigurieren.

Parametername	Beschreibung	Format
$flow.max_retry_another_account	Gibt die Anzahl der zulässigen Wiederholungen an, wenn Sie auswählen, ob Sie mit einem alternativen Konto fortfahren möchten. Der Standardwert ist 3.	integer
$flow.max_retry_order_number	Gibt die zulässige Anzahl von Wiederholungsversuchen an, wenn die letzten fünf Ziffern einer Bestellnummer angegeben werden. Der Standardwert ist 3.	integer
$flow.max_retry_another_order	Gibt an, wie oft die Auswahl einer anderen Bestellung für die Rückgabe wiederholt werden darf, wenn 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 zulässige Anzahl von Wiederholungsversuchen an, wenn die vollständige Bestellnummer angegeben wird, in Fällen, in denen mehrere Bestellungen dieselben letzten fünf Ziffern haben. Der Standardwert ist 2.	integer
$flow.max_retry_exchange_reason	Gibt die zulässige Anzahl von Wiederholungsversuchen an, wenn Sie den Grund für den Umtausch angeben. Der Standardwert ist 3.	integer
$flow.max_retry_exchange_reason_counter	Gibt die zulässige Anzahl von Wiederholungsversuchen 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 des prebuilt_components_exchange_order_reason-Eintrags an, der angibt, dass der Nutzer „Sonstiges“ als Grund für den Austausch ausgewählt hat. Der Standardwert ist "others".	String
$flow.max_product_display_counter	Gibt die maximale Anzahl von Produkten an, die in einer einzelnen Drehung 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 maximale Anzahl der zulässigen Wiederholungen bei der Bestätigung des ausgewählten Produkts an. Der Standardwert ist 2.	integer
$flow.max_retry_product_number_counter	Gibt die maximale Anzahl der zulässigen Wiederholungen an, wenn ein Produkt für den Umtausch ausgewählt wird. Der Standardwert ist 3.	integer
$flow.max_retry_select_quantity	Gibt die maximale Anzahl der zulässigen Wiederholungen an, wenn die Menge des zu ersetzenden Produkts ausgewählt wird. Der Standardwert ist 2.	integer
$flow.max_retry_size_number_counter	Gibt die maximale Anzahl der zulässigen Wiederholungen an, wenn die Größe für den Austausch ausgewählt wird. Der Standardwert ist 2.	integer
$flow.max_retry_another_zip_code	Gibt die maximale Anzahl der zulässigen Wiederholungsversuche 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 bei einer einzelnen Abbiegung angezeigt 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 maximale Anzahl von Wiederholungsversuchen an, die bei der Auswahl eines Geschäfts zulässig sind. Der Standardwert ist 2.	integer
$flow.max_retry_store_selection	Gibt die zulässige Anzahl von Wiederholungsversuchen bei der Bestätigung der Auswahl des Geschäfts an. Der Standardwert ist 3.	integer
$flow.max_available_address_reselection_counter	Gibt die Anzahl der zulässigen Wiederholungen an, wenn der Nutzer gefragt wird, ob er 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 Zahlung 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 für 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 die Erstattung auf sein Quellkonto 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 ausgewählt hat, einen Abholtermin für den Umtausch zu vereinbaren. Der Standardwert ist scheduled_for_pickup.	String

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.

1. Öffnen Sie die Dialogflow CX Console.
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 Route true.
8. Bearbeiten Sie im Fenster „Route“ die Werte für die Parametervorgaben 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 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)
E-Mail	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

Generatoren

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

FAQ

Der FAQ-Generator wird für häufig gestellte Fragen zu Retouren und Umtausch verwendet, darunter:

• Gibt es eine Frist für die Rückgabe?
• Kann ich ein Geschenk zurückgeben?
• Der Produktpreis und der Erstattungsbetrag stimmen nicht überein. Warum ist das so?

Zusammenfassung

Mit dem Summarization-Generator wird eine Zusammenfassung nach dem Anruf generiert, die die von der Komponente verarbeitete Unterhaltung beschreibt.

Grundlegende Einstellungen

So richten Sie diese vorkonfigurierte 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 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_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	Datum der Bestellung 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 tauschbare 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 Stückzahlen für austauschbare Produkte in der Bestellung.	Liste (String)
exchangeable_product_price	Liste der Preise für tauschbare Produkte in der Bestellung.	Liste (String)

Maximieren Sie die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Get order details“ (Bestelldetails abrufen) für diese Komponente aufzurufen.

1. Öffnen Sie die Dialogflow CX Console.
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 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.
8. Prüfen und aktualisieren Sie den Request body, 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 sie von der Komponente zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
10. Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
11. Klicken Sie auf Speichern.

Details zur doppelten Bestellung abrufen

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

Maximieren Sie die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Details zu doppelten Bestellungen abrufen“ für diese Komponente aufzurufen.

1. Öffnen Sie die Dialogflow CX Console.
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 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.
8. Prüfen und aktualisieren Sie den Request body, 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 sie von der Komponente zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
10. Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
11. Klicken Sie auf Speichern.

Verfügbare Anzeigenfläche 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 umtauschen 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)

Maximieren Sie die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Get available exchange size“ (Verfügbare Anzeigenplattformgröße abrufen) für diese Komponente aufzurufen.

1. Öffnen Sie die Dialogflow CX Console.
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 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.
8. Prüfen und aktualisieren Sie den Request body, 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 sie von der Komponente zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
10. Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
11. Klicken Sie auf Speichern.

Verfügbarkeit des Produkttauschs abrufen

Mit dem prebuilt_components_exchange_order:get_product_exchange_availability-Webhook wird von der Komponente geprüft, ob das ausgewählte Produkt, die ausgewählte Stückzahl und die optionale Größe des Nutzers 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	Die Produkt-ID des Produkts, das der Nutzer umtauschen möchte.	String
$flow.order_product_quantity_exchange_count	Die Menge des Produkts, das der Nutzer umtauschen möchte.	integer
$flow.product_selected_size	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 Stückzahl und die ausgewählte Größe für den Umtausch verfügbar sind.	boolean
product_exchange_price	Der Umtauschpreis für einen einzelnen Artikel des ausgewählten Produkts und der ausgewählten Größe.	Zahl

Maximieren Sie die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Get product exchange availability“ für diese Komponente aufzurufen.

1. Öffnen Sie die Dialogflow CX Console.
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 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.
8. Prüfen und aktualisieren Sie den Request body, 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 sie von der Komponente zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
10. Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
11. Klicken Sie auf Speichern.

Ticket zu unvollständiger 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 in 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 Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
$flow.order_id	Auftrags-ID, für die ein Ticket eingereicht werden soll.	String
$flow.selected_order_product_id	Die Produkt-ID des Produkts, das der Nutzer umtauschen möchte.	String
$flow.order_product_quantity_exchange_count	Die 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 du den Webhook „Raise incomplete order ticket“ für diese Komponente konfigurieren möchtest, maximiere den Abschnitt, um die Anleitung aufzurufen.

1. Öffnen Sie die Dialogflow CX Console.
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ähle den Webhook „prebuilt_components_exchange_order:raise_incomplete_order_ticket“ aus.
7. 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.
8. Prüfen und aktualisieren Sie den Request body, 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 sie von der Komponente zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
10. Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
11. Klicken Sie auf Speichern.

Geschäftsdetails abrufen

Über den prebuilt_components_exchange_order:get_store_details-Webhook ruft die Komponente die Liste der Geschäfte in der Nähe der angegebenen Postleitzahl des Nutzers ab.

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)

Maximieren Sie die Seite, um eine Anleitung zum Konfigurieren des Webhooks „Geschäftsdetails abrufen“ für diese Komponente aufzurufen.

1. Öffnen Sie die Dialogflow CX Console.
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 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.
8. Prüfen und aktualisieren Sie den Request body, 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 sie von der Komponente zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
10. Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
11. Klicken Sie auf Speichern.

Details zur Geräteleihe

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 Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
$flow.order_id	Auftrags-ID, für die ein Ticket eingereicht werden soll.	String
$flow.selected_order_product_id	Die Produkt-ID des Produkts, das der Nutzer umtauschen möchte.	String
$flow.order_product_quantity_exchange_count	Die Menge des Produkts, das der Nutzer umtauschen möchte.	integer
$flow.product_selected_size	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 die Anzeigenplattform. Gültige Werte werden durch das prebuilt_components_exchange_order_location-Element definiert.	String
$flow.order_exchange_store_id	Die Geschäfts-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 das prebuilt_components_exchange_order_refund_mode-Element definiert. Wenn keine Erstattung erforderlich ist, ist dieser Wert null.	String
$flow.total_refund_amount	Der zu erstattende Betrag, wenn der Preis des tauschbaren 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 und von der Komponente verwendet.

Parametername	Beschreibung	Ausgabeformat
order_exchange_ticket_id	Ticket-ID für die eingereichte Anzeigenplattform.	String

Maximieren Sie die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks zum Posten von Details zur Anzeigenplattform für diese Komponente aufzurufen.

1. Öffnen Sie die Dialogflow CX Console.
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ähle den Webhook „prebuilt_components_exchange_order:post_exchange_details“ aus.
7. 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.
8. Prüfen und aktualisieren Sie den Request body, 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 sie von der Komponente zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
10. Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
11. Klicken Sie auf Speichern.

Informationen zur Erstattung bei Zahlung per Nachnahme senden

Über den prebuilt_components_exchange_order:send_COD_refund_information-Webhook sendet die Komponente tauschbezogene Zahlungsinformationen an einen Nutzer.

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	Auftrags-ID, für die ein Ticket eingereicht werden soll.	String
$flow.channel	Der Kanal, an den Informationen gesendet werden sollen. Gültige Werte werden durch das prebuilt_components_channel_email_phone-Element definiert. Standardmäßig werden phone und email unterstützt.	String

Wenn Sie den Webhook „Send COD refund information“ für diese Komponente konfigurieren möchten, maximieren Sie die Ansicht und folgen Sie der Anleitung.

1. Öffnen Sie die Dialogflow CX Console.
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 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.
8. Prüfen und aktualisieren Sie den Request body, 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 sie von der Komponente zum Zugriff auf die zurückgegebenen Feldwerte benötigt werden.
10. Prüfen und aktualisieren Sie die Einstellungen für die Authentifizierung nach Bedarf.
11. Klicken Sie auf Speichern.

Abgeschlossen

Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.