Vordefinierte Komponente für Angebote und Deals

Die vordefinierte Komponente für Angebote und Deals prüft, ob der Aufrufer ein registrierter Nutzer ist. Wenn der Nutzer ein registriertes Konto hat, kann die Komponente Informationen zu nutzerspezifischen Angeboten und Deals liefern. Der Nutzer kann auch Details zu allgemeinen Angeboten und Angeboten erhalten oder Probleme mit einem bestimmten Gutscheincode melden. Diese Komponente verwendet die vordefinierte Komponente für die alphanumerische Sammlung zum Erfassen von Gutscheincodes. Die Komponente verwendet außerdem Generatoren für eine Zusammenfassung nach dem Anruf, für häufig gestellte Fragen und für Angebotsdetails.

Beschränkungen

Neben den allgemeinen Einschränkungen für vordefinierte Komponenten gelten für diese vordefinierte Komponente die folgenden Einschränkungen:

• Diese Komponente verschlüsselt keine Daten.

Beispieldialoge

Die folgenden Beispieldialogfelder zeigen gängige Szenarien, in denen diese vordefinierte Komponente verwendet wird. Die Beispieldialogfelder veranschaulichen das Verhalten, wenn die Komponente über Telefonie aufgerufen wird. Dadurch werden der Standard-Begrüßungs-Intent und die erste Agent-Antwort zu Beginn der Unterhaltung ausgelöst.

Nutzerspezifische und allgemeine Angebote und Deals

Der Endnutzer wurde bereits authentifiziert. Der Nutzer fragt nach seinen neuesten Angeboten und der Agent zeigt eine Liste mit Angeboten für den Nutzer an. Der Nutzer stellt einige Fragen zu den Angeboten und fragt dann nach Angeboten in einer bestimmten Kategorie. Der Agent präsentiert die Liste der Angebote in der Kategorie. Der Agent bietet an, die Angebotsdetails an den Nutzer zu senden, und der Nutzer lehnt ab.

Nutzereingabe	Agent-Antwort
	Herzlich willkommen! Möchten Sie sich über unsere aktuellen Angebote informieren oder haben Sie Probleme mit einem bestimmten Gutscheincode?
Ich möchte die neuesten Angebote sehen
	Zur Bestätigung: Sie suchen nach Angeboten. Ist das richtig?
yes
	Wir haben die folgenden Angebote für Sie gefunden, hier die Details: Angebot 1: 5% Rabatt auf Bekleidung. Verwenden Sie den Code APPARELS5, gültig bis 28.03.2024. Angebot 2: 15% Rabatt auf Lebensmittel mit dem Code GROCERY500, gültig bis 28.03.2024. Haben Sie Fragen zu Angeboten?
Gibt es einen Mindestbestellwert für das Lebensmittelangebot?
	Ja, für Lebensmittel gilt ein Mindestbestellwert von 10, um den Rabatt von 15% in Anspruch nehmen zu können. Mit dem Code GROCERY500 können Sie dieses Angebot bis zum 28.03.2024 einlösen. Wir hoffen, Ihnen alle erforderlichen Informationen zur Verfügung stellen zu können. Haben Sie Fragen zu Angeboten?
Haben Sie Angebote für Elektronik?
	Natürlich! Hier die Angebotsdetails: Angebot 1: 5% Rabatt auf Elektronikprodukte mit dem Code ELECTRIC5, gültig bis 28.03.2024. Angebot 2: 15% Rabatt auf Elektronikartikel mit dem Code ELECTRIC15, gültig bis 28.03.2024. Wir hoffen, dir die erforderlichen Details mitteilen zu können. Haben Sie Fragen zu Angeboten?
Nein, ich bin fertig
	Möchten Sie, dass die Angebotsdetails über Ihr registriertes Mobiltelefon oder Ihre registrierte E-Mail-Adresse mitgeteilt werden?
Nein danke
	Vielen Dank für Ihren 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	Agent-Antwort
	Herzlich willkommen! Möchten Sie sich über unsere aktuellen Angebote informieren oder haben Sie Probleme mit einem bestimmten Gutscheincode?
Ich habe Probleme mit einem Gutscheincode
	Zur Bestätigung: Sie suchen nach Gutscheincodes. Ist das richtig?
yes
	Wir bedauern, dass Ihre Erwartungen nicht erfüllt wurden. Könnten Sie uns bitte den Gutscheincode nennen, den Sie verwenden?
	Der Kundenservicemitarbeiter erfasst den Gutscheincode mithilfe der vordefinierten Komponente für die alphanumerische Erfassung
	Der Angebotscode APPARELS5 für Bekleidung erforderte einen Mindestbestellwert von 100$ und ist bis zum 28.03.2024 gültig. Achten Sie darauf, dass die Bedingungen wie die Mindestabnahmemenge erfüllt sind. Sind diese Informationen hilfreich?
no
	Beschreiben Sie das aufgetretene Problem. Sie könnten z. B. sagen, dass der Gutscheincode in meiner Region nicht funktioniert.
Gutscheincode funktioniert nicht
	Zur Bestätigung: Der Gutscheincode funktioniert nicht. Ist das richtig?
yes
	Wir haben ein Ticket erstellt, um das Problem zu melden. Vielen Dank für Ihren Anruf.

Namenskonventionen

Diese vordefinierte Komponente verwendet die folgenden Namenskonventionen:

Funktion	Format	Beispiel
Fluss	[Komponentenname]	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 das Verhalten der Komponente zu bestimmen. Ablaufbezogene Parameter müssen auf der Startseite der Komponente festgelegt werden. Parameter auf Sitzungsebene können entweder durch einen aufrufenden Ablauf oder auf der Startseite dieser Komponente festgelegt werden.

Diese vordefinierte Komponente akzeptiert die folgenden Eingabeparameter:

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Optional: Die lokale Telefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String

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

Parametername	Beschreibung	Format
$flow.max_retry_concern_type	Gibt die Anzahl der erlaubten Wiederholungen an, wenn der Nutzer auswählt, ob er sich Angebote anhören möchte 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 Wiederholungen bei Angabe einer Kategorie an, für die Sie sich Angebote anhören möchten. Der Standardwert ist 2.	integer
$flow.max_retry_another_coupon_code	Gibt die Anzahl der zulässigen Wiederholungen bei Eingabe des spezifischen Gutscheincodes an, mit dem der Nutzer ein Problem hat. Der Standardwert ist 2.	integer
$flow.max_retry_coupon_code_issue_counter	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn das Problem des Nutzers mit einem Gutscheincode angegeben wird. Der Standardwert ist 2.	integer
$flow.max_retry_message_confirm_channel	Gibt die Anzahl der zulässigen Wiederholungen an, wenn ein Kanal angegeben wird, zu dem Angebotsdetails empfangen werden sollen. Der Standardwert ist 2.	integer
$flow.valid_coupon_code_status	Gibt den Wert des Feldes coupon_code_status an, das vom Webhook get_coupon_code_details zurückgegeben wird. Dieser Wert gibt an, dass der Gutscheincode gültig ist. Der Standardwert ist "valid".	String
$flow.invalid_coupon_code_status	Gibt den Wert des Feldes coupon_code_status an, der vom Webhook get_coupon_code_details zurückgegeben wird. Dieser Wert gibt an, dass der Gutscheincode ungültig ist. Der Standardwert ist "invalid".	String
$flow.expired_coupon_code_status	Gibt den Wert des vom get_coupon_code_details-Webhook zurückgegebenen Felds coupon_code_status an. Dieser gibt an, dass der Gutscheincode abgelaufen ist. Der Standardwert ist "expired".	String

Ausgabeparameter

Ausgabeparameter sind Sitzungsparameter, die nach dem Verlassen der Komponente aktiv bleiben. Diese Parameter enthalten wichtige Informationen, die von der Komponente erfasst werden. Diese vordefinierte Komponente stellt Werte für die folgenden Ausgabeparameter bereit:

Parametername	Beschreibung	Ausgabeformat
phone_number	Die lokale Telefonnummer des Nutzers ohne Ländervorwahl, mit der er identifiziert werden kann.	String
transfer_reason	Dieser Parameter gibt den Grund an, warum der Ablauf beendet wurde, falls er nicht erfolgreich war. Folgender Wert wird zurückgegeben: agent: Der Endnutzer hat während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert. denial_of_information: Der Endnutzer hat die Weitergabe der von der Komponente angeforderten Informationen abgelehnt. max_no_input: Für die Unterhaltung wurde die maximale Anzahl von Wiederholungen für Ereignisse ohne Eingabe erreicht. Integrierte Ereignisse ohne Eingabe ansehen. max_no_match: Für die Unterhaltung wurde die maximale Anzahl von Wiederholungen für Ereignisse ohne Übereinstimmung erreicht. Weitere Informationen finden Sie unter Integrierte No-Match-Ereignisse. webhook_error: Ein Webhook-Fehler ist aufgetreten. Siehe integriertes Ereignis „webhook.error“. webhook_not_found: Eine Webhook-URL war nicht erreichbar. Weitere Informationen finden Sie unter Integriertes Ereignis „webhook.error.not-found“.	String

Generatoren

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

Zusammenfassung

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

Allgemeine FAQ

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

• Kann ich 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 gekaufte Artikel später in den Verkauf kommt?
• Gibt es ein Zeitlimit für das Einlösen von Prämien aus dem Treuepunkteprogramm?

Nutzerspezifische Angebotsdetails

Mit dem Generator User-specific offer details werden Details zu nutzerspezifischen Angeboten basierend auf den Informationen aus dem Webhook get_offers_details bereitgestellt.

Angebotsdetails

Mit dem Generator Offers and deals details werden Details zu allgemeinen Angeboten und Deals basierend auf den Informationen aus dem Webhook get_offers_details angegeben. Der Nutzer kann nach Angeboten in einer bestimmten Kategorie oder nach weiteren Details zu bestimmten Angeboten fragen.

FAQs zu Angeboten und Angeboten

Der Offers and deals FAQ-Generator wird verwendet, um häufig gestellte Fragen zu Angeboten zu verarbeiten.

• Gibt es spezielle Angebote für Neukunden?
• Wie werde ich über anstehende Deals informiert?
• Gibt es Angebote, die ausschließlich im Geschäft oder online erhältlich sind?
• Wie oft werden deiner Plattform neue Deals hinzugefügt?

FAQs zu Rabatten und Gutscheincodes

Die Discount and promo code FAQ wird für häufig gestellte Fragen zu Rabatten und Gutscheincodes verwendet.

• Kann ich einen Rabattcode mehrmals verwenden?
• Kann ich mehrere Rabatte für eine einzelne Bestellung verwenden?
• Wie kann ich an der Kasse einen Rabattcode einlösen?
• Was passiert, wenn ich beim Bezahlen vergessen habe, einen Rabattcode einzulösen?

Grundlegende Einstellungen

So richten Sie diese vordefinierte Komponente ein:

1. Importieren Sie die vordefinierte Komponente.
2. Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dialogflow-Dienste beschreibt. Weitere Informationen finden Sie unter „Webhook-Einrichtung“.

Webhook-Einrichtung

Damit Sie diese Komponente verwenden können, müssen Sie die enthaltenen flexiblen Webhooks so konfigurieren, dass die erforderlichen Informationen von Ihren externen Diensten abgerufen werden.

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 die Angebotsdetails abgerufen werden sollen.	String

API-Antwortparameter

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

Parametername	Beschreibung	Ausgabeformat
active_category	Liste der für den Nutzer verfügbaren Angebotskategorien. Gültige Werte werden durch die Entität prebuilt_components_offers_and_deals_category definiert.	Liste (String)
user_email	Die für das angegebene Konto registrierte E-Mail-Adresse, über die die Angebotsdetails gesendet werden.	String
user_offer	Liste mit 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)

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, mit 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 dem Konto des Nutzers zugeordnet ist	String

API-Antwortparameter

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

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

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ändervorwahl, mit der er identifiziert werden kann.	String
$flow.confirmation_channel	Kanal, über den der Nutzer Angebotsdetails erhalten möchte. Gültige Werte werden durch die Entität prebuilt_components_channel_email_phone definiert.	String

Ticket erhöhen

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ändervorwahl, mit der er identifiziert werden kann.	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	Das vom Nutzer angegebene Problem in Bezug auf den Gutscheincode.	String

Fertig

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