Vordefinierte Komponente „Angebote“

Die vordefinierte Komponente für Angebote und Deals prüft, ob der Anrufer ein registrierter Nutzer ist. Wenn der Nutzer ein registriertes Konto hat, kann die Komponente Informationen zu nutzerspezifischen Angeboten bereitstellen. Der Nutzer kann auch Details zu allgemeinen Angeboten und Deals abrufen oder Probleme mit einem bestimmten Gutscheincode melden. Diese Komponente verwendet die vordefinierte Komponente Alphanumerische Sammlung, um Gutscheincodes zu erfassen. Die Komponente verwendet auch Generatoren für die Zusammenfassung nach dem Anruf, FAQs und Angebotsdetails.

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.

Nutzerspezifische und allgemeine Angebote und Deals

Der Endnutzer wurde bereits authentifiziert. Der Nutzer fragt nach den neuesten Angeboten und der KI-Agent präsentiert eine Liste mit Angeboten, die auf den Nutzer zugeschnitten sind. Der Nutzer stellt einige Fragen zu den Angeboten und bittet dann um Angebote in einer bestimmten Kategorie. Der Agent präsentiert die Liste der Angebote in der Kategorie. Der Kundenservicemitarbeiter bietet an, die Angebotsdetails an den Nutzer zu senden, und der Nutzer lehnt ab.

Nutzereingabe	Antwort des KI-Agenten
	Herzlich willkommen! Möchten Sie sich unsere neuesten Angebote ansehen oder haben Sie Probleme mit einem bestimmten Gutscheincode?
Ich möchte die neuesten Angebote sehen
	Sie suchen also nach Angeboten. Ist das richtig?
Ja
	Wir haben die folgenden Angebote für Sie gefunden: Angebot 1: 5% Rabatt auf Bekleidung, Code APPARELS5, gültig bis 28.03.2024. Angebot 2: 15% Rabatt auf Lebensmittel, Code GROCERY500, gültig bis 28.03.2024. Wir hoffen, dass diese Angebote für Sie interessant sind. Haben Sie Fragen zu Angeboten, die wir für Sie beantworten können?
Gibt es einen Mindestbestellwert für das Angebot für Lebensmittel?
	Ja, es gibt einen Mindestbestellwert von 10, um den Rabatt von 15% auf Lebensmittel zu erhalten. Verwenden Sie den Code GROCERY500, um dieses Angebot einzulösen. Es ist bis zum 28.03.2024 gültig. Wir hoffen, dass wir Ihnen die gewünschten Informationen zur Verfügung stellen können. Haben Sie Fragen zu Angeboten, die wir für Sie beantworten können?
Gibt es Angebote für Elektronik?
	Sehr gern. Hier sind die Angebotsdetails: Angebot 1: 5% Rabatt auf Elektronikartikel mit dem Code ELECTRIC5, gültig bis zum 28.03.2024. Angebot 2: 15% Rabatt auf Elektronikartikel mit dem Code ELECTRIC15, gültig bis zum 28.03.2024. Wir hoffen, dass wir Ihnen die gewünschten Informationen zur Verfügung stellen konnten. Haben Sie Fragen zu Angeboten, die wir für Sie beantworten können?
Nein, ich bin fertig
	Möchten Sie, dass die Angebotsdetails an Ihre registrierte Mobiltelefonnummer oder E-Mail-Adresse gesendet werden?
Nein danke
	Vielen Dank für deinen Anruf.

Problem mit einem Gutscheincode

Der Endnutzer wurde bereits authentifiziert. Der Nutzer erwähnt, dass er ein Problem mit einem Gutscheincode hat. Der Agent erfasst den Gutscheincode und stellt dem Nutzer Details zur Einlösung des Gutscheincodes zur Verfügung. Der Nutzer bestätigt, dass er ein Problem mit dem Gutscheincode hat, und der Kundenservicemitarbeiter reicht ein Ticket ein, um das Problem zu melden.

Nutzereingabe	Antwort des KI-Agenten
	Herzlich willkommen! Möchten Sie sich unsere neuesten Angebote ansehen oder haben Sie Probleme mit einem bestimmten Gutscheincode?
Ich habe Probleme mit einem Gutscheincode.
	Sie suchen also nach Gutscheincodes. Ist das richtig?
Ja
	Wir bedauern, dass Ihre Erwartungen nicht erfüllt wurden. Könnten Sie uns bitte den Gutscheincode mitteilen, den Sie verwenden?
	Der Agent erfasst den Gutscheincode mithilfe der vordefinierten Komponente Alphanumerische Erfassung.
	Der Angebotscode APPARELS5 für Bekleidung erfordert einen Mindestbestellwert von 100 $ und ist bis zum 28.03.2024 gültig. Achten Sie darauf, dass die Bedingungen wie der Mindestbestellwert erfüllt sind. Sind diese Informationen hilfreich für Sie?
no
	Beschreibe das Problem, das aufgetreten ist. Sie können beispielsweise sagen, dass Ihr Gutscheincode nicht funktioniert oder dass der Code in Ihrer Region nicht funktioniert.
Gutscheincode funktioniert nicht
	Das Problem mit dem Gutscheincode ist, dass er nicht funktioniert. Ist das richtig?
Ja
	Wir haben ein Ticket erstellt, um Ihr Problem zu melden. Vielen Dank für deinen Anruf.

Namenskonventionen

Für diese vordefinierte Komponente gelten die folgenden Namenskonventionen:

Funktion	Format	Beispiel
Flow	[Component Name]	Angebote
Entitätstyp	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_offers_and_deals_category
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_offers_and_deals:get_offers_details

Eingabeparameter

Eingabeparameter sind Parameter, mit denen bestimmte Verhaltensweisen der Komponente konfiguriert werden. Die Parameter werden von einer oder mehreren Bedingungen im Ablauf verwendet, um 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

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_concern_type	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn der Nutzer auswählt, ob er Angebote hören oder ein Problem mit einem Gutscheincode melden möchte. Der Standardwert ist 2.	integer
$flow.max_retry_offers_category	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn eine Kategorie angegeben wird, für die Angebote angehört werden sollen. Der Standardwert ist 2.	integer
$flow.max_retry_another_coupon_code	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn der Nutzer den spezifischen Gutscheincode angibt, mit dem er ein Problem hat. Der Standardwert ist 2.	integer
$flow.max_retry_coupon_code_issue_counter	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn der Nutzer das Problem mit einem Gutscheincode angibt. Der Standardwert ist 2.	integer
$flow.max_retry_message_confirm_channel	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn ein Kanal zum Empfangen von Angebotsdetails angegeben wird. Der Standardwert ist 2.	integer
$flow.valid_coupon_code_status	Gibt den Wert des Felds coupon_code_status an, das vom get_coupon_code_details-Webhook zurückgegeben wird und angibt, dass der Gutscheincode gültig ist. Der Standardwert ist "valid".	String
$flow.invalid_coupon_code_status	Gibt den Wert des Felds coupon_code_status an, der vom get_coupon_code_details-Webhook zurückgegeben wird und angibt, dass der Gutscheincode ungültig ist. Der Standardwert ist "invalid".	String
$flow.expired_coupon_code_status	Gibt den Wert des Felds coupon_code_status an, der vom Webhook get_coupon_code_details zurückgegeben wird und angibt, dass der Gutscheincode abgelaufen ist. Der Standardwert ist "expired".	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
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.

Zusammenfassung

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

Allgemeine FAQs

Der Generator General FAQ wird verwendet, um häufig gestellte Fragen zu Rabatten, Verkäufen, Käufen und Treuepunkteprogrammen zu beantworten.

• Kann ich reduzierte Produkte zurückgeben, wenn ich meine Meinung ändere?
• Kann ich beim Kauf bestimmter Produkte kostenlose Proben oder Geschenke erhalten?
• Bieten Sie Preisanpassungen an, wenn der von mir gekaufte Artikel später im Angebot ist?
• Gibt es eine Frist für das Einlösen von Prämien aus Treuepunkteprogrammen?

Nutzerspezifische Angebotsdetails

Der User-specific offer details-Generator wird verwendet, um Details zu nutzerspezifischen Angeboten basierend auf den Informationen des get_offers_details-Webhooks bereitzustellen.

Details zu Angeboten und Deals

Der Offers and deals details-Generator wird verwendet, um Details zu allgemeinen Angeboten und Deals basierend auf den Informationen des get_offers_details-Webhooks bereitzustellen. Der Nutzer kann nach Angeboten in einer bestimmten Kategorie oder nach weiteren Details zu bestimmten Angeboten fragen.

Häufig gestellte Fragen zu Angeboten und Deals

Der Generator Offers and deals FAQ wird verwendet, um häufig gestellte Fragen zu Angeboten und Deals zu beantworten.

• Gibt es spezielle Angebote für Neukunden?
• Wie kann ich mich über anstehende Angebote informieren lassen?
• Gibt es Angebote, die nur im Geschäft oder nur online verfügbar sind?
• Wie oft werden neue Angebote auf Ihrer Plattform hinzugefügt?

Häufig gestellte Fragen zu Rabatt- und Gutscheincodes

Der Discount and promo code FAQ wird verwendet, um häufig gestellte Fragen zu Rabatten und Gutscheincodes zu beantworten.

• Kann ich einen Rabattcode mehrfach verwenden?
• Kann ich mehrere Rabatte auf eine einzelne Bestellung anwenden?
• Wie kann ich einen Rabattcode beim Bezahlen einlösen?
• Was passiert, wenn ich vergessen habe, beim Bezahlen einen Rabattcode einzugeben?

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.

Angebotsdetails abrufen

Der Webhook prebuilt_components_offers_and_deals:get_offers_details wird von der Komponente verwendet, um Details zu nutzerspezifischen und allgemeinen Angeboten abzurufen.

API-Anfrageparameter

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

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Telefonnummer, für die Angebotsdetails 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
active_category	Liste der Angebotskategorien, die für den Nutzer verfügbar sind. Gültige Werte werden durch die Entität prebuilt_components_offers_and_deals_category definiert.	Liste (String)
user_email	E‑Mail-Adresse, die für das angegebene Konto registriert ist und zum Senden von Angebotsdetails verwendet wird.	String
user_offer	Liste der nutzerspezifischen Angebotsdetails. Jedes Element der Liste stellt ein einzelnes Angebot dar, wobei Schlüssel/Wert-Paare verschiedene Attribute des Angebots beschreiben, z. B. {"valid_from": "2024-01-29", "sale_type": "none", "valid_until": "2024-03-28", "offer_id": "G5E0M2D7A6Y4W9S", "discount_value": "5%", "coupon_code": "ELECTRIC5", "is_redeem_allowed": "true", "minimum_order_value": "1000", "maximum_discount_amount": "200", "offer_category_name": "electronics"}.	Liste (Objekt)
all_offers	Liste der allgemeinen Angebotsdetails. Jedes Element der Liste stellt ein einzelnes Angebot dar und hat dasselbe Format wie das Feld user_offer.	Liste (Objekt)

Maximieren Sie die Anleitung, um den Webhook „Angebotsdetails 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_offers_and_deals:get_offers_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. Überprü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 Gutscheincode abrufen

Der Webhook prebuilt_components_offers_and_deals:get_coupon_code_details wird von der Komponente verwendet, um Details zu einem bestimmten Gutscheincode abzurufen, bei dem ein Nutzer Probleme gemeldet hat.

API-Anfrageparameter

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

Parametername	Beschreibung	Eingabeformat
$flow.coupon_code	Gutscheincode, für den Details abgerufen werden sollen.	String
$session.params.phone_number	Telefonnummer, die mit dem Konto des Nutzers verknüpft ist.	String

API-Antwortparameter

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

Parametername	Beschreibung	Ausgabeformat
offer_id	Angebots-ID für den Gutscheincode.	String
offer_category_name	Kategorie für den Gutscheincode. Gültige Werte werden durch die Entität prebuilt_components_offers_and_deals_category definiert.	String
coupon_code_status	Status des Gutscheincodes. Gültige Werte werden durch die Eingabeparameter $flow.valid_coupon_code_status, $flow.invalid_coupon_code_status und $flow.valid_coupon_code_status definiert.	String
valid_until	Datum, bis zu dem der Gutscheincode gültig ist, im Format YYYY-MM-DD.	String
minimum_order_value	Mindestbestellwert für den Gutscheincode.	String

Maximieren Sie den Bereich, um eine Anleitung zum Konfigurieren des Webhooks „Gutscheincodedetails abrufen“ für diese Komponente zu erhalten.

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_offers_and_deals:get_coupon_code_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. Überprü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.

Nachricht senden

Der Webhook prebuilt_components_offers_and_deals:send_message wird von der Komponente verwendet, um eine Nachricht mit Angebotsdetails an den vom Nutzer ausgewählten Kanal 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.confirmation_channel	Kanal, den der Nutzer ausgewählt hat, um Angebotsdetails zu erhalten. Gültige Werte werden durch die Entität prebuilt_components_channel_email_phone definiert.	String

Maximieren Sie diesen Abschnitt, um die Anleitung zum Konfigurieren des Webhooks „Nachricht senden“ 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_offers_and_deals:send_message“ 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. Überprü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 erstellen

Der Webhook prebuilt_components_offers_and_deals:raise_ticket wird von der Komponente verwendet, um ein Ticket einzureichen, in dem ein Nutzerproblem mit einem Gutscheincode gemeldet wird.

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.coupon_code	Gutscheincode, für den der Nutzer ein Problem gemeldet hat.	String
$flow.offer_id	Angebots-ID für den angegebenen Gutscheincode.	String
$flow.coupon_code_issue	Vom Nutzer angegebenes Problem mit dem Gutscheincode.	String

Maximieren Sie den Abschnitt, um die Anleitung zum Konfigurieren des Webhooks „Ticket erstellen“ 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 „rebuilt_components_offers_and_deals:raise_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. Überprü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.