Ich will mich halt nit verrückt mache, s bringt ja nix, ausser dass ich dann verrückt bin.

Einige Produkte und Funktionen werden derzeit umbenannt. Auch die Funktionen für generative Playbooks und Abläufe werden zu einer einzigen konsolidierten Console migriert. Weitere Informationen
Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Agent mithilfe von Workflows erstellen
bookmark_border
In dieser Anleitung erfahren Sie, wie Sie mit der Dialogflow CX-Konsole einen einfachen Agent für Hemdbestellungen mithilfe von Flows erstellen und testen. Bei der Interaktion mit diesem Agent können Sie nach dem Filialstandort und den Öffnungszeiten fragen und eine Hemdbestellung aufgeben.
Der fertige Agent für diese Anleitung wird von der Konsole so dargestellt:

Hinweis
Bevor Sie diese Anleitung lesen, sollten Sie mit Folgendem vertraut sein:
Grundlagen von Abläufen
Einrichtungsschritte ausführen
Agent erstellen
Erstellen Sie einen neuen Agent für diese Anleitung:
Öffnen Sie die Dialogflow CX Console.
Erstellen Sie ein Projekt oder wählen Sie ein Projekt aus.
Klicken Sie auf Agent erstellen.
Wählen Sie Eigene erstellen aus.
Füllen Sie das Formular für die grundlegenden Agent-Einstellungen aus.
Sie können einen beliebigen Anzeigenamen wählen.
Wählen Sie den bevorzugten Standort aus. Klicken Sie auf die Schaltfläche Bearbeiten, wenn Sie die erweiterten Standorteinstellungen ändern möchten.
Wählen Sie Ihre bevorzugte Zeitzone aus.
Wählen Sie die Standardsprache für Ihren Agent aus.
Aktivieren Sie optional Stackdriver Logging.
Klicken Sie auf Speichern.
Optionaler Agent-Import
In dieser Anleitung wird gezeigt, wie Sie einen einfachen Agent für die Bestellung von T-Shirts erstellen. Wenn Sie die Schritte mit der Console überspringen möchten, können Sie den Agent herunterladen und importieren.
Standardablauf und -Intents
Der folgende Ablauf und folgende Intents werden automatisch für neue Agents erstellt. Um die Intents zu lokalisieren, klicken Sie auf Verwalten und dann auf Intents. Sie können den Ablauf durch einen Klick auf Erstellen lokalisieren.
Standard-Begrüßungs-Intent
Der Standard-Begrüßungs-Intent enthält einfache Trainingsformulierungen wie „Hi“ oder „Hallo“, die den anfänglichen Endnutzereingaben entsprechen sollen. Sie können diesen Intent nach Bedarf bearbeiten.
Standardmäßig auszuschließender Intent
Der standardmäßig auszuschließende Intent kann als Trainingsformulierung für diesen Intent als negatives Beispiel hinzugefügt werden.
Standardstartablauf
Der Standardstartablauf kann als einziger Ablauf verwendet werden. Nur dieser Ablauf wird in der Anleitung genutzt. Für komplexere Agents können Sie weitere Abläufe hinzufügen. Dieser Ablauf hat eine Standard-Intent-Route mit dem Standard-Begrüßungs-Intent als Intent-Anforderung.

Standardmäßige Begrüßungsnachricht testen
Der Standardablauf und die Intents können eine einfache Unterhaltung nur mit einer Begrüßungsnachricht verarbeiten. So testen Sie den neuen Agent:
Klicken Sie auf die Schaltfläche Agent testen, um den Simulator zu öffnen.
Geben Sie hello in das Texteingabefeld ein und drücken Sie die Eingabetaste.
Der Agent antwortet mit einer standardmäßigen Begrüßung.
Schließen Sie den Simulator.

Der Agent hat für diese Endnutzereingabe folgende Schritte ausgeführt:
Bei der Bereitstellung einer Eingabe war der Standardstartablauf der aktive Ablauf und die Ablaufstartseite die aktive Seite. Alle Zustands-Handler, die auf den aktiven Ablauf angewendet wurden, waren im Bereich, sodass der Agent sie ausgewertet hat.
Eine der ausgewerteten Routen hat den Standard-Begrüßungs-Intent als Intent-Anforderung. Da Ihre Eingabe mit diesem Intent übereinstimmt, wurde die Route aufgerufen.
Die aufgerufene Route hat mehrere Antwortnachrichten der Auftragsausführung. Der Agent hat eine zufällig ausgewählt und der Antwortwarteschlange hinzugefügt.
Die aufgerufene Route hat kein Umstellungsziel, sodass sich der aktive Ablauf und die Seite nicht geändert haben.
Der Agent hat mit dem Inhalt der Antwortwarteschlange geantwortet.
Begrüßungsnachricht bearbeiten
Diese Begrüßungsnachricht können Sie ändern. So bearbeiten Sie die Begrüßungsantwort:
Klicken Sie auf den Tab Erstellen.
Wählen Sie im Abschnitt Abläufe den Standardstartablauf aus.
Klicken Sie in der Grafik auf den Knoten Startseite. Dies ist die Startseite für den Standardstartablauf.
Suchen Sie die Route mit dem Standard-Begrüßungs-Intent als Intent-Anforderung und klicken Sie darauf. Daraufhin wird ein Fenster geöffnet, in dem Sie die Informationen zur Intent-Route bearbeiten können.
Suchen Sie den Abschnitt „Auftragsausführung“ und löschen Sie unter „Kundenservicemitarbeiterantworten“ alle Antwortnachrichten. Fügen Sie dann Hello, this is a shirt ordering virtual agent. How can I help you? als einzige Antwort hinzu.
Klicken Sie auf Speichern.
Schließen Sie das Bearbeitungsfeld für die Route.

Aktualisierte Begrüßungsnachricht testen
So testen Sie die aktualisierte Antwort:
Klicken Sie auf die Schaltfläche Agent testen, um den Simulator zu öffnen.
Geben Sie hello in das Texteingabefeld ein und drücken Sie die Eingabetaste.
Der Agent antwortet mit der neuen Nachricht.
Schließen Sie den Simulator.
Seite „Filialstandort“
Eine Unterhaltung (Sitzung) in Conversational Agents (Dialogflow CX) kann als Zustandsmaschine beschrieben und dargestellt werden. Die Zustände einer CX-Sitzung werden durch Seiten dargestellt. Bisher haben Sie nur eine Seite, der Agent ist also noch nicht sehr nützlich. In diesem Abschnitt erstellen Sie eine weitere Seite zur Verarbeitung von Fragen zum Filialstandort.
Standort-Intent erstellen
Ein Intent kategorisiert die Absicht eines Endnutzers für eine Unterhaltungsrunde. So erstellen Sie einen Intent, der zugeordnet wird, wenn die Endnutzereingabe den Filialstandort anfordert:
Wählen Sie den Tab Verwalten.
Klicken Sie auf Intents.
Klicken Sie auf Erstellen.
Geben Sie store.location für den Intent-Anzeigenamen ein.
Geben Sie die folgenden Trainingsformulierungen ein:
Where is the store?
Directions
Tell me the address
Where do I pick up my order?
How do I get there?
Where is the store located?
What street are you on?
What is your address?
How do I get to your store?
Where are you located?
Klicken Sie auf Speichern.

Standortseite erstellen
Erstellen Sie nun die neue Seite. Sie können dieser Seite eine Eingabeauftragsausführung hinzufügen, die immer dann aufgerufen wird, wenn die Seite aktiv wird. Diese Eingabeauftragsausführung sollte eine Antwortnachricht mit dem Standort des Geschäfts enthalten. So erstellen Sie die Seite mit dem Standort des Geschäfts:
Klicken Sie auf den Tab Erstellen.
Wählen Sie im Abschnitt Abläufe den Standardstartablauf aus.
Klicken Sie im Abschnitt Seiten auf die Schaltfläche „add hinzufügen“. Ein Texteintrag für den Seitennamen wird angezeigt.
Geben Sie Store Location für den Namen der Seite ein und drücken Sie die Eingabetaste.
Klicken Sie auf Schaltfläche „Optionen“ more_vert neben dem Seitennamen.
Wählen Sie Bearbeiten aus, um den Bearbeitungsbereich für die Seite zu öffnen.
Suchen Sie Ausführung für Eingabe und klicken Sie auf Ausführung bearbeiten.
Klicken Sie auf + Dialogantwort hinzufügen, um Our store is located at 1007 Mountain Drive, Gotham City, NJ. im Feld Agent-Dialog im Bereich Agent-Antworten einzugeben.
Klicken Sie auf Speichern.
Schließen Sie den Bearbeitungsbereich.

Standort-Intent-Route zum Ablauf hinzufügen
Erstellen Sie jetzt eine Route mit der Filialstandortseite als Umstellungsziel. Wenn diese Route aufgerufen wird, wechselt die Sitzung zur Seite mit dem Filialstandort. Diese Route wird auf den Standardstartablauf angewendet und ist somit innerhalb des Bereichs, solange der Ablauf aktiv ist. Für einen Agent mit nur einem Ablauf bedeutet dies, dass die Route immer im Bereich liegt. Der Endnutzer kann während der Unterhaltung jederzeit den Filialstandort abfragen und diese Route wird aufgerufen.
So erstellen Sie diese Route:
Klicken Sie auf den Tab Erstellen.
Wählen Sie im Abschnitt Abläufe den Standardstartablauf aus.
Klicken Sie in der Grafik auf den Knoten Startseite. Dies ist die Startseite für den Standardstartablauf.
Fügen Sie die folgende Intent-Route hinzu:
Intent: store.location
Seitenübergang: Store Location
Klicken Sie auf Speichern.
Schließen Sie das Bearbeitungsfeld für Intent-Routen.

Wenn Sie den Bearbeitungsbereich schließen, sehen Sie, dass die neue Seite der Grafik als Knoten hinzugefügt wurde. Der Pfeil vom Knoten Start zum Knoten Filialstandort gibt an, wie die Sitzung von Knoten zu Knoten wechselt.
Seite „Filialstandort“ testen
So testen Sie Ihre Seite:
Klicken Sie auf die Schaltfläche Agent testen, um den Simulator zu öffnen.
Geben Sie What is the store location? ein und drücken Sie die Eingabetaste.
Der Agent stellt die Adresse bereit.
Schließen Sie den Simulator.
Der Agent hat für diese Endnutzereingabe folgende Schritte ausgeführt:
Bei der Bereitstellung einer Eingabe war der Standardstartablauf der aktive Ablauf und die Ablaufstartseite die aktive Seite. Alle Zustands-Handler, die auf den aktiven Ablauf angewendet wurden, waren im Bereich, sodass der Agent sie ausgewertet hat.
Eine der ausgewerteten Routen hat store.location als Intent-Anforderung. Da Ihre Eingabe mit diesem Intent übereinstimmt, wurde die Route aufgerufen.
Die aufgerufene Route enthält keine Antwortnachrichten der Auftragsausführung. Aus diesem Grund wurden keine Antworten zur Antwortwarteschlange hinzugefügt.
Die aufgerufene Route hat ein Umstellungsziel. Daher wurde die Seite Filialstandort zur aktiven Seite.
Die Seite Filialstandort enthält eine Eingabeauftragsausführung und die Antwortnachricht für die Auftragsausführung (die Adresse) wurde der Antwortwarteschlange hinzugefügt.
Der Agent hat mit dem Inhalt der Antwortwarteschlange geantwortet.
Seite“ Öffnungszeiten“ mit Inline-Erstellung
In diesem Abschnitt erstellen Sie eine Seite mit Öfnungszeiten, die Endnutzerfragen zu Öffnungszeiten beantworten. In den vorherigen Abschnitten haben Sie Seiten und Intents auf den Tabs Erstellen und Verwalten generiert. In diesem Abschnitt erfahren Sie, wie Sie solche Typen schneller mit der Inline-Erstellung generieren.
So erstellen Sie eine Intent-Route, einen Intent und eine Seite:
Klicken Sie in der Grafik auf den Knoten Startseite.
Klicken Sie neben Routen auf add Hinzufügen. Das Bearbeitungsfeld für die Intent-Route wird geöffnet.
Wählen Sie im Abschnitt Intent die Option Neuer Intent aus. Das Bearbeitungsfeld für den Intent wird geöffnet.
Erstellen Sie einen store.hours-Intent mit folgenden Trainingssätzen:
What are your store hours?
What time do you close?
Hinweis: Außerhalb dieses Beispiels müssen Produktionsagents mindestens 10 Trainingssätze pro Intent haben.
Klicken Sie auf Speichern, um den Intent zu speichern. Das Bearbeitungsfeld für Intents wird geschlossen.
Scrollen Sie im Bearbeitungsfeld für die Route zum Abschnitt Übergang.
Wählen Sie für den Seitenübergang die Option Neue Seite aus.
Geben Sie Store Hours in das nun angezeigte Texteingabefeld ein.
Klicken Sie auf Speichern. Die neue Seite wird in der Grafik angezeigt, da nun eine Umstellung zu ihr vorhanden ist.
Schließen Sie das Bearbeitungsfeld für die Route.
Fügen Sie eine Auftragsaufführung hinzu, die die Öffnungszeiten enthält. Der Vorgang ähnelt dem zur Definition eines Standorts.
Schließen Sie alle geöffneten Bearbeitungsfelder.
Seite „Bestellartikel“
Als Nächstes erstellen Sie eine Seite mit Formularparametern. Wenn der Endnutzer eine neue T-Shirt-Bestellung eingibt, wird in der Sitzung zu dieser Seite gewechselt. Wenn diese Seite aktiv ist, werden darin Größe und Farbe der T-Shirt-Bestellung erfasst.
Benutzerdefinierten Entitätstyp für Hemdgröße erstellen
Entitätstypen steuern, wie Daten aus Endnutzereingaben extrahiert werden. Conversational Agents (Dialogflow CX) stellt vordefinierte Systementitäten bereit, die mit vielen gängigen Datentypen übereinstimmen. So gibt es beispielsweise Systementitäten für den Abgleich von Datumsangaben, Uhrzeiten, Farben und E-Mail-Adressen. Sie können auch eigene benutzerdefinierte Entitäten erstellen, um benutzerdefinierte Daten zuzuordnen.
Für diesen Agent können Sie eine Systementität für die Hemdfarbe verwenden. Allerdings müssen Sie eine benutzerdefinierte Entität für die Hemdgröße erstellen. Der Entitätstyp für die Größe sollte die folgenden Entitätseinträge enthalten:
Entity
Synonyme
klein
klein, winzig, schmal
Mittel
mittel, normal, Durchschnitt
groß
groß, breit, extragroß

So erstellen Sie diese Entität:
Wählen Sie den Tab Verwalten.
Klicken Sie auf Entitätstypen.
Klicken Sie auf +Erstellen.
Legen Sie für den Anzeigenamen size fest.
Fügen Sie die Entitätseinträge aus der Tabelle oben hinzu.
Klicken Sie auf Speichern.
Bestell-Intent mit Intent-Parametern erstellen
Sie benötigen einen Intent, der zugeordnet wird, wenn der Endnutzer eine neue Hemdbestellung anfordert. Der Intent sollte außerdem optional die gewünschte Hemdfarbe und/oder -größe erfassen, falls der Endnutzer diese Informationen im Voraus bereitstellt.
Parameter werden zum Erfassen und Referenzieren von Werten verwendet, die der Endnutzer während einer Sitzung bereitgestellt hat. Jeder Parameter hat einen Namen und einen Entitätstyp. Im Unterschied zu unstrukturierten Endnutzereingaben sind Parameter strukturierte Daten, mit denen auf einfache Weise ein bestimmter Ablauf ausgeführt werden kann oder Antworten erzeugt werden können.
Sie steuern, wie Endnutzerdaten mit Intent-Zuordnungen extrahiert werden. Dazu werden Teile Ihrer Trainingsformulierungen annotiert und die zugehörigen Intent-Parameter konfiguriert. Stellen Sie sich beispielsweise eine Trainingsformulierung wie „Wie ist die Wettervorhersage für morgen in Tokio?“ vor. Sie sollten „morgen“ mit einem Parameter date und „Tokio“ mit einem Parameter location annotieren. Wenn Sie Teile einer Trainingsformulierung annotieren, erkennt Dialogflow CX, dass diese Teile nur Beispiele für tatsächliche Werte sind, die von Endnutzern zur Laufzeit bereitgestellt werden. Für eine Endnutzereingabe wie „Wie ist die Wettervorhersage für Sydney am Freitag?“ Conversational Agents (Dialogflow CX) würden den Parameter date aus „Freitag“ und den Parameter location aus „Sydney“ extrahieren.
So können Sie eine Trainingsformulierung mit der Konsole annotieren:
Wählen Sie den Teil der Trainingsformulierung aus, den Sie annotieren möchten.
Wählen Sie den gewünschten Entitätstyp aus der Liste aus.
In der Parametertabelle unten wird ein Parameter erstellt.
Erstellen Sie einen Intent mit den zuvor beschriebenen Schritten. Geben Sie diesem Intent den Namen order.new. Für jede Formulierung mit einer Farbe versehen Sie die Farbe mit einem color-Parameter und mit dem @sys.color-Systementitätstyp. Für jede Formulierung mit einer T-Shirt-Größe versehen Sie die Größe mit einem size-Parameter und mit dem benutzerdefinierten Entitätstyp @size, den Sie in den vorherigen Schritten erstellt haben. Die Trainingsformulierungen und -parameter sollten in etwa so aussehen:

Bestellseite erstellen
Erstellen Sie eine Seite für neue Bestellungen ähnlich den vorherigen Schritten:
Anzeigename: New Order
Eingabeauftragsausführung: Ok, let’s start a new order.
Ein Formular zur Bestellseite hinzufügen
Für jede Seite können Sie ein Formular definieren. Dies ist eine Liste von Parametern, die vom Endnutzer für die Seite erfasst werden sollen. Der Agent interagiert mit dem Endnutzer mehrere Unterhaltungsrunden lang, bis er alle erforderlichen Formularparameter, auch Seitenparameter genannt, erfasst hat. Für jeden Formularparameter geben Sie auch Aufforderungen an, mit denen der Agent diese Informationen vom Endnutzer anfordert. Dieser Vorgang wird als Ausfüllen von Formularen bezeichnet.
Wenn ein Endnutzer Intent-Parameter für eine Intent-Zuordnung bereitstellt, werden die Intent-Parameter zu Sitzungsparameter. Wenn eine Seite erstmalig aktiv wird, werden alle Formularparameter mit gleichnamigen Sitzungsparametern vorausgefüllt. Wenn also der Endnutzer bei der Zuordnung des Intents order.new die Größe oder Farbe angibt, werden diese Werte automatisch in das Formular übernommen.
Für die Seite für neue Bestellungen müssen zwei erforderliche Formularparameter definiert werden:
Erforderlich
Anzeigename
Entitätstyp
Is list
Eingabeaufforderung
check_box
Farbe
@sys.color
check_box_outline_blank
Welche Farbe wünschen Sie?
check_box
Größe
@size
check_box_outline_blank
Welche Größe wünschen Sie?

So fügen Sie dieses Formular hinzu:
Klicken Sie in der Grafik auf die Seite Neue Bestellung.
Klicken Sie auf die Schaltfläche zum Hinzufügen add von Parametern. Das Bearbeitungsfeld für Parameter wird geöffnet.
Fügen Sie die Parameter wie in der Tabelle oben beschrieben hinzu.
Klicken Sie auf Speichern.
Schließen Sie das Bearbeitungsfeld für Parameter.
Bestell-Intent-Route zum Ablauf hinzufügen
Fügen Sie dem Standardstartablauf ähnlich wie bei den oben beschriebenen Schritten eine Route hinzu. Diese Route sollte aufgerufen werden, wenn der Endnutzer eine neue Bestellung aufgeben möchte:
Intent: order.new
Umstellungszielseite: Neue Bestellung
Seite „Bestätigung“
Mit der letzten Seite wird die Bestellung bestätigt und die Sitzung beendet.
Bestätigungsseite erstellen
Erstellen Sie eine Bestätigungsseite mit einer Antwort, die die Sitzungsparameter verwendet, um die Bestellung zu bestätigen:
Anzeigename: Order Confirmation
Eingabeauftragsausführung: You can pick up your order for a $session.params.size $session.params.color shirt in 7 to 10 business days. Goodbye.
Bedingungsrouten zur Bestellseite hinzufügen
Sie können auch Bedingungen verwenden, um zu bestimmen, ob eine Route aufgerufen wird. Bedingungen werden üblicherweise verwendet, um zu prüfen, ob ein Formular vollständig ist. Sie können auch so konfiguriert werden, dass sie immer bei der Auswertung aufgerufen werden.
Informationen zum Festlegen von Bedingungen in der Konsole finden Sie in der Dokumentation zum Festlegen von Bedingungen.
Fügen Sie der Bestellseite die folgende Route hinzu, die nach dem Ausfüllen des Formulars für die Bestellseite aufgerufen wird. Beachten Sie, wie in dieser Bedingungsroute Parameterverweise in der Antwort an den Endnutzer verwendet werden und wie die Sitzung zur Seite Bestellbestätigung wechselt.
Condition (Bedingung): $page.params.status = „FINAL“
Agent sagt: You have selected a $session.params.size, $session.params.color shirt.
Seitenübergang: Order Confirmation
Fügen Sie folgende Route der Auftragsseite hinzu, die für jede Unterhaltung geöffnet wird, in der die Seite aktiv ist und die Bedingungsroute ausgewertet wird. Wenn obige Bedingung ausgewertet und aufgerufen wird, wird die Seite inaktiv. Die true-Bedingungsroute wird also nicht ausgewertet:
Condition (Bedingung): true
Agent sagt: I’d like to collect a bit more information from you.
Bedingungsroute zum Beenden der Sitzung erstellen
Fügen Sie die folgende Bedingungsroute auf der Seite Bestellung bestätigen hinzu, um die Sitzung zu beenden, sobald sie aktiv ist und die zugehörige Auftragsausführung verarbeitet wurde:
Condition (Bedingung): true
Umstellungsziel: Seite: End Session
Fertiggestellten Agent testen
Testen Sie den Agent mit dem folgenden Dialog:
Dialog
Erklärung
Endnutzer: Hallo
Agent: Hallo, dies ist ein virtueller Kundenservicemitarbeiter für eine Hemdbestellung. Wie können wir Ihnen helfen?
Die Route Standard-Begrüßungs-Intent im Standardstartablauf wird aufgerufen.
Die Auftragsausführung für diesen Status-Handler („Hello, this…“) wird der Antwortwarteschlange hinzugefügt.
Der Agent sendet die Antwortwarteschlange an den Endnutzer.
Endnutzer:Ich möchte ein blaues Hemd kaufen
Agent: Ok, starten wir eine neue Bestellung.
Agent: Ich brauche noch ein paar Informationen.
Agent: Welche Größe möchten Sie?
Die Intent-Route order.new im Standardstartablauf wird ausgewertet.
Der Intent order.new wird zugeordnet und der Intent-Parameter color auf „blau“ gesetzt.
Die Sitzung wechselt zur Seite Neue Bestellung und der Intent-Parameter color wird zu einem Sitzungsparameter.
Die Seite Neue Bestellung enthält eine Eingabeauftragsausführung („Ok, starten wir…“), die der Antwortwarteschlange hinzugefügt wird.
Mit dem color-Sitzungsparameter wird der gleichnamige Formularparameter ausgefüllt.
Die zutreffende Bedingungsroute auf der Seite Neue Bestellung wird ausgewertet und aufgerufen. Sie enthält eine Antwortnachricht („Ich benötige…“), die der Antwortwarteschlange hinzugefügt wird.
Das Formular der Seite ist nicht ausgefüllt. Der Agent verwendet also die Größeneingabeaufforderung („Welche Größe…“) und fügt sie der Antwortwarteschlange hinzu.
Der Agent sendet die Antwortwarteschlange an den Endnutzer.
Endnutzer: groß
Agent: Sie haben ein großes blaues T-Shirt ausgewählt.
Agent: Sie können Ihre Bestellung für ein großes blaues T-Shirt in 7 bis 10 Werktagen abholen. Auf Wiedersehen.
Der Parameter size wird mit der Endnutzereingabe ausgefüllt, die der Agent in der vorherigen Unterhaltungsrunde angefordert hat.
Die Formularausführungsroute auf der Seite Neue Bestellung wird ausgewertet und aufgerufen. Sie enthält eine Auftragsausführung („Sie haben … ausgewählt“), die der Antwortwarteschlange hinzugefügt wird, wobei Parameterverweise in tatsächliche vom Endnutzer bereitgestellte Werte aufgelöst werden.
Die Sitzung wechselt zur Seite Bestellbestätigung.
Die Seite Bestellbestätigung enthält eine Eingabeauftragsausführung („Sie können … abholen“), die der Antwortwarteschlange hinzugefügt wird.
Der Agent sendet die Antwortwarteschlange an den Endnutzer.
Die Sitzung wechselt zu Sitzung beenden.

Agent mithilfe von Playbooks erstellen
bookmark_border
In dieser Anleitung erfahren Sie, wie Sie mithilfe von Playbooks einen einfachen Agenten für die Bestellung von T-Shirts erstellen und testen. Bei der Interaktion mit diesem Agent können Sie nach dem Filialstandort und den Öffnungszeiten fragen und eine Hemdbestellung aufgeben.
Hinweise
Bevor Sie diese Anleitung lesen, sollten Sie mit Folgendem vertraut sein:
Folgen Sie der Einrichtungsanleitung, falls Sie das noch nicht getan haben.
Playbooks
Ein Agent besteht aus einem oder mehreren Playbooks. Jedes Playbook hat einen klar definierten und begrenzten Umfang. Ein Playbook enthält die folgenden Daten:
Name
Ein Name, mit dem das Playbook identifiziert wird.
Ziel
Ziele sind allgemeine Beschreibungen dessen, was das Playbook erreichen soll.
Anleitung
Anleitungen sind allgemeine Schritte, die ausgeführt werden sollten, um das Ziel des Playbooks zu erreichen.
Beispiele
Beispiele sind Beispielunterhaltungen zwischen einem Endnutzer und dem Kundenservicemitarbeiter. Diese Beispiele sind im Grunde Few-Shot-Prompts für das LLM.

Agent erstellen
So erstellen Sie den Agenten:
Rufen Sie die Konsole für Konversationsagenten auf:
Konversations-Agenten-Konsole
Wählen Sie ein Projekt aus oder erstellen Sie ein neues.
Klicken Sie auf Agent erstellen.
Klicken Sie auf Eigene erstellen.
Gib als Namen des Kundenservicemitarbeiters „Shirt Ordering – Playbooks“ ein.
Geben Sie einen Standort an.
Geben Sie eine Zeitzone an.
Geben Sie eine Standardsprache an.
Wählen Sie für die Option Gesprächsstart die Option Playbook aus.
Klicken Sie auf Erstellen.
Auf der Benutzeroberfläche wird das Standard-Playbook namens Default Generative Playbook angezeigt.
Klicken Sie auf die Schaltfläche „Zurück“, um die Liste der Playbooks aufzurufen.
Playbook für die Bestellung erstellen
Das Playbook Bestellung verarbeitet Bestellungen für T-Shirts. So erstellen Sie dieses Playbook:
Klicken Sie auf Erstellen.
Wählen Sie die Option Task Playbook aus.
Geben Sie den Namen des Playbooks ein: Order.
Geben Sie das folgende Zielvorhaben ein:
You are a shirt store ordering assistant. Help customers purchase shirts.
Help the customer choose a size and color.
The shirts come in small, medium, and large.
The shirts can be red, green, or blue.

Führen Sie die folgenden Schritte aus:

• If the customer has not provided a size, ask them to choose a size.
• If the customer has not provided a color, ask them to choose a color.
• Once the customer has selected a size and color for the shirt,
  repeat the selection to the customer, and ask them to confirm the selection.
• Once the customer has confirmed their selection,
  let them know that the shirt is now ordered.
• Do not provide prices or collect payment.
• Do not collect the customer’s name or address.

Klicken Sie auf Speichern.
Klicken Sie auf die Schaltfläche „Zurück“, um zur Playbook-Liste zurückzukehren.
Informations-Playbook erstellen
Im Playbook Informationen werden Fragen zum Store beantwortet. So erstellen Sie dieses Playbook:
Klicken Sie auf Erstellen.
Wählen Sie die Option Task Playbook aus.
Geben Sie den Namen des Playbooks ein: Information.
Geben Sie das folgende Zielvorhaben ein:
You provide information about a shirt store.
The store is open between 8 AM and 6 PM every day.
The store is located at 1007 Mountain Drive, Gotham City, NJ.

Führen Sie die folgenden Schritte aus:

• If the customer asks for the store location, provide them with the address.
• If the customer asks for the store hours, provide them with the hours.

Klicken Sie auf Speichern.
Klicken Sie auf die Schaltfläche „Zurück“, um zur Playbook-Liste zurückzukehren.
Standard-Playbook aktualisieren
Beim Erstellen der Anwendung wurde ein Standard-Playbook für Sie erstellt. Dieses Playbook sollte die Unterhaltung auf die entsprechenden Playbooks mit bestimmten Zielen lenken. In der Anleitung unten sehen Sie, wie das Standard-Playbook auf die anderen Playbooks verweist. So aktualisieren Sie dieses Playbook:
Klicken Sie auf das Standard-Playbook. Dieses Playbook ist mit einem hervorgehobenen Stern gekennzeichnet.
Geben Sie das folgende Zielvorhaben ein:
You are an assistant for a shirt store.
Your name is „Samantha“.
Your job is to direct customers to other playbooks based on the customer’s questions.

Führen Sie die folgenden Schritte aus:

• If the customer hasn’t been greeted yet, greet the customer,
  introduce yourself, and ask the user how you can help.
• If the customer wants information about the store,
  route them to ${PLAYBOOK: Information}
• If the customer wants to purchase a shirt,
  route them to ${PLAYBOOK: Order}

Klicken Sie auf Speichern.
Die Playbook-Referenzen sind hervorgehoben, da es noch keine Beispiele gibt. Diese werden im nächsten Abschnitt hinzugefügt.
Klicken Sie auf die Schaltfläche „Zurück“, um zur Playbook-Liste zurückzukehren.
Beispiele nennen
Ihr Playbook ist jetzt einsatzbereit. Sie müssen jedoch Beispiele angeben, um qualitativ hochwertige Antworten zu erhalten.
Wenn Sie ein Playbook geöffnet haben, können Sie auf dem Tab Beispiele manuell Beispiele angeben. Es ist jedoch oft einfacher, ein Gespräch mit dem funktionierenden Playbook zu führen und das Gespräch als Beispiel zu speichern.
Ein Beispiel für eine Unterhaltung mit einem Standard-Playbook ist kurz. Dieses Playbook muss Sie nur zu einem anderen Playbook weiterleiten. So führen Sie eine Unterhaltung mit dem Standard-Playbook:
Schließen oder schließen Sie alle Bereiche, die sich rechts auf dem Bildschirm befinden.
Klicken Sie in der oberen Navigationsleiste auf die Schaltfläche „Simulator“ question_answer.
Wählen Sie als Ressource das Standard-Playbook aus.
Verwenden Sie das Standardmodell oder wählen Sie eine Alternative aus.
Geben Sie im Textfeld Nutzerinput eingeben den Wert Hello ein und drücken Sie die Eingabetaste.
Das Playbook antwortet mit einer Begrüßung.
So speichern Sie diese Unterhaltung als Beispiel:
Wählen Sie im Drop-down-Menü Aufrufe das Standard-Playbook aus.
Klicken Sie rechts oben auf der Benutzeroberfläche auf die Schaltfläche Als Beispiel speichern.
Der Beispieleditor wird geöffnet. In diesem Editor können Sie Aktionen hinzufügen, bearbeiten, löschen oder neu anordnen.
Geben Sie den Beispielnamen an: Greeting.
Aktualisieren Sie die Playbook-Antworten nach Bedarf.
Scrollen Sie nach unten zu Beispiel zum Ende mit Ausgabeinformationen und geben Sie im Abschnitt Zusammenfassung die Zahl The user is greeted. ein.
Klicken Sie auf das Speichersymbol.
Fügen Sie dem Informations-Playbook ein Beispiel für einen Standort hinzu:
Schließen oder schließen Sie alle Bereiche, die sich rechts auf dem Bildschirm befinden.
Setzen Sie die Unterhaltung bei Bedarf mit der Schaltfläche „Neu starten“ restart_alt zurück.
Wählen Sie im Drop-down-Menü Start Resource (Startressource) des Simulators das Informations-Playbook aus.
Geben Sie die Nachricht ein: Where are you located?.
Das Playbook antwortet mit einem Standort.
Wählen Sie im Drop-down-Menü Aufrufe das Informations-Playbook aus.
Klicken Sie auf die Schaltfläche Als Beispiel speichern.
Geben Sie den Beispielnamen an: Location.
Bevor Sie diese Unterhaltung als Beispiel speichern, müssen Sie die Aktion löschen, die „Wo befinden Sie sich?“ enthält. Nur die Standardbeispiele für Playbooks können mit einer Nutzeraktion beginnen.
Wenn Sie dem Beispiel den Kontext geben möchten, der die Unterhaltung begonnen hat, maximieren Sie den Bereich Zusammenfassung der vorherigen Unterhaltung… und geben Sie Folgendes in das Feld Beispiel mit Eingabeinformationen beginnen ein: The customer asked „Where are you located?“.
Um dem Beispiel den Kontext zu geben, der die Unterhaltung abrundet, maximieren Sie den Abschnitt Zusammenfassung der Playbook-Ausführung… und geben Sie Folgendes in das Feld Beispiel mit Ausgabeinformationen beenden ein: The store is located at 1007 Mountain Drive, Gotham City, NJ..
Klicken Sie auf das Speichersymbol.
Fügen Sie dem Informations-Playbook ein Beispiel für Öffnungszeiten hinzu:
Gehen Sie wie oben beschrieben vor, geben Sie aber die Nachricht What are your hours? ein und nennen Sie das Beispiel Hours.
Fügen Sie ein Auswahlbeispiel für das Bestell-Playbook hinzu:
Gehen Sie wie oben beschrieben vor, nennen Sie das Beispiel jedoch Selection, wählen Sie das Bestell-Playbook aus und senden Sie die folgenden Nachrichten:
I want to buy a shirt
Large
Green
Yes
Agent testen
Ihr Agent kann jetzt getestet werden. Öffnen Sie den Simulatorbereich und führen Sie ein Gespräch mit dem Kundenservicemitarbeiter. Sie müssen nicht dieselben Unterhaltungen wie oben führen. Sie können diesen Agenten beispielsweise fragen, welche Farben für Hemden verfügbar sind. Wenn Sie das gewünschte Verhalten nicht erzielen, können Sie die Antworten verbessern, indem Sie Ihre Beispiele optimieren und neue erstellen.
Über die API mit dem Kundenservicemitarbeiter interagieren
Weitere Informationen finden Sie unter Interaktionen mit der API.
Dokumentation zu Conversational Agents (Dialogflow CX)
bookmark_border
Zur Dialogflow CX Console
Conversational Agents (Dialogflow CX) ist eine neue Natural Language Understanding-Plattform, die auf generativen Modellen basiert, mit denen Unterhaltungen gesteuert werden können, und auf Abläufen, die für eine explizitere Unterhaltungssteuerung verwendet werden können.
Mit Konversations-Agenten (Dialogflow CX) können Sie ganz einfach eine dialogorientierte Benutzeroberfläche entwerfen und in Ihre mobile App, Webanwendung, Ihr Gerät, Ihren Bot oder Ihr Sprachdialogsystem einbinden. Mit Conversational Agents (Dialogflow CX) können Sie Nutzern neue und ansprechende Möglichkeiten für die Interaktion mit Ihrem Produkt bieten.
Conversational Agents (Dialogflow CX) können mehrere Eingabearten der Kunden analysieren, einschließlich Text- oder Audioeingaben (z. B. von einem Telefon oder einer Sprachaufzeichnung). Es kann auch auf verschiedene Arten auf Ihre Kunden reagieren, entweder durch Text oder mit synthetischer Sprache.
Jeder neue Kunde erhält ein Guthaben im Wert von 600 $, um Conversational Agents (Dialogflow CX) kostenlos zu testen.
Beliebte Dokumentationslinks
Jetzt starten
Generativ vs. deterministisch
Einrichtung und Bereinigung
Agent mithilfe von Playbooks erstellen
Agent mithilfe von Abläufen erstellen
Konzepte kennenlernen
Konsole für Conversational Agents – Übersicht
Dialogflow CX Console – Übersicht
Kundenservicemitarbeiter
Playbooks
Datenspeicher
Grundlagen flussbasierter Kundenservicemitarbeiter
Abläufe
Referenz
REST API-Referenz
RPC API-Referenz
Sprachreferenz
Ressourcen
Preise
Kontingente und Limits
Support
Support

Plan zur Umbenennung und Konsolidierung der Console
Ab Ende 2024 bis Anfang 2025 werden einige Produkt-, Funktions- und Konsolennamen geändert:
Dialogflow CX wird in „Conversational Agents“ umbenannt.
Dialogflow CX Messenger wird in Conversational Messenger umbenannt.
Das Dialogflow CX-Telefonie-Gateway wird in „Conversational Phone Gateway“ umbenannt.
Die Vertex AI Agents-Konsole und die Dialogflow CX-Konsole werden in einer einzigen Conversational Agents-Konsole zusammengeführt. Die Dialogflow CX-Konsole wird bis zur allgemeinen Verfügbarkeit der neuen konsolidierten Konsole unterstützt. Agents, die entweder über die Dialogflow CX-Konsole oder die Vertex AI Agents-Konsole erstellt wurden, werden automatisch in die neue konsolidierte Konsole migriert. Die Nutzer müssen nichts weiter tun.
So sorgen Sie für einheitliche Funktionsnamen in der neuen Konsole für Konversations-Agents und in der Dialogflow CX-Konsole:
Die Funktion „Kundenservicemitarbeiter“ in Vertex AI Agents wird in „Playbooks“ umbenannt.
Die Funktion „Kundenservicemitarbeiter-Apps“ in Vertex AI Agents wird in „Kundenservicemitarbeiter“ umbenannt.
Hinweis: Bisher wurden Dialogflow CX-Playbooks und Vertex AI-Kundenservicemitarbeiter-Apps ausgewählten Kunden zu GA-Bedingungen angeboten. Diese Kunden können weiterhin gemäß den GA-Nutzungsbedingungen von Google Cloudauf dieses Produkt in der Dialogflow CX Console zugreifen und es verwenden. Prüfen Sie, ob die URL …dialogflow/cx/… enthält, um sicherzugehen, dass Sie die Konsole verwenden, die gemäß diesen Nutzungsbedingungen angeboten wird. Alternativ können Sie sich an einen Google Cloud Kundenservicemitarbeiter wenden, um weitere Informationen zu erhalten.

Grundlagen für flussbasierte Kundenservicemitarbeiter
bookmark_border
In diesem Dokument werden die Grundlagen der Verwendung von Konversationsabläufen (Dialogflow CX) zum Erstellen eines virtuellen Kundenservicemitarbeiters beschrieben. Es bietet eine Übersicht über die wichtigsten Konzepte.
Agents
Ein Conversational Agents (Dialogflow CX)-Agent ist ein virtueller Agent, der nebenläufige Unterhaltungen mit Ihren Endnutzern abwickelt. Mithilfe von Natural Language Understanding (NLU) versteht der Agent die Nuancen der menschlichen Sprache. Konversations-Agents (Dialogflow CX) übersetzen Nutzereingaben in Text- oder Audioform während einer Unterhaltung in strukturierte Daten, die Ihre Anwendungen und Dienste verstehen können. Sie entwerfen und erstellen einen Konversations-Agenten (Dialogflow CX), der die für Ihr System erforderlichen verschiedenen Typen von Unterhaltungen verarbeitet.
Ein Conversational Agents-Agent (Dialogflow CX) ähnelt einem menschlichen Callcenter-Agent. Beide werden für die Bearbeitung erwarteter Szenarien trainiert. Dabei sind keine übermäßig genauen Vorgaben nötig.
Abläufe
Komplexe Dialoge enthalten oft mehrere Unterhaltungsthemen. Beispielsweise kann es sein, dass ein Agent für die Pizzaauslieferung Essensbestellung, Kundeninformationen und Bestätigung als unterschiedliche Themen verarbeiten muss. Zu jedem Thema sind dann mehrere Unterhaltungsrunden erforderlich, damit der Agent die relevanten Informationen vom Endnutzer erhält.
Abläufe werden zum Definieren dieser Themen und der zugeordneten Unterhaltungspfade verwendet. Jeder Agent hat einen Ablauf, der als Standardstartablauf bezeichnet wird. Dieser eine Ablauf kann alles sein, was Sie für einen einfachen Agent benötigen. Komplexere Agents können zusätzliche Abläufe erfordern und verschiedene Mitglieder des Entwicklungsteams können für das Erstellen und Verwalten dieser Abläufe verantwortlich sein. Die Abläufe eines Pizza-Lieferdienst-Agents könnten zum Beispiel so aussehen:

Seiten
Eine Unterhaltung (Sitzung) in Conversational Agents (Dialogflow CX) kann als Zustandsmaschine beschrieben und dargestellt werden. Die Zustände einer Sitzung werden durch Seiten dargestellt.
Für jeden Ablauf definieren Sie mehrere Seiten, wobei die Gesamtheit der Seiten eine vollständige Unterhaltung zu den Themen ermöglicht, für die der Ablauf bestimmt ist. Es ist immer genaue eine Seite die aktuelle Seite. Diese aktuelle Seite wird als aktiv bezeichnet. Weiter wird der mit dieser Seite verknüpfte Ablauf als aktiv angesehen. Jeder Ablauf hat eine besondere Startseite. Wird ein Ablauf zum ersten Mal aktiviert, wird die Startseite zur aktuellen Seite. Pro Unterhaltungsrunde bleibt die aktuelle Seite entweder gleich oder wechselt zu einer anderen Seite.
Sie konfigurieren jede Seite so, dass vom Endnutzer Informationen erfasst werden, die für den von der Seite dargestellten Unterhaltungsstatus relevant sind. Sie können beispielsweise die Seiten (in Blau) im folgenden Diagramm erstellen, um einen Essensbestellungsablauf eines Pizza-Lieferdienst-Agents zu sehen. Der Startknoten des Diagramms stellt die Startseite des Essensbestellungsablaufs dar. Wenn der Ablauf abgeschlossen ist, wird zur Bestätigung gewechselt.

Entitätstypen
Entitätstypen steuern, wie Daten aus Endnutzereingaben extrahiert werden.
Conversational Agents (Dialogflow CX) stellen vordefinierte Systementitäten bereit, die mit vielen gängigen Datentypen übereinstimmen. So gibt es beispielsweise Systementitäten für den Abgleich von Datumsangaben, Uhrzeiten, Farben und E-Mail-Adressen. Sie können auch eigene benutzerdefinierte Entitäten erstellen, um benutzerdefinierte Daten zuzuordnen. Es ist zum Beispiel möglich, mit der Entität „Gemüse“ alle Gemüsearten zu erfassen, die bei einem Lebensmittelhändler erhältlich sind.
Parameter
Parameter werden zum Erfassen und Referenzieren von Werten verwendet, die der Endnutzer während einer Sitzung bereitgestellt hat. Jeder Parameter hat einen Namen und einen Entitätstyp. Im Unterschied zu unstrukturierten Endnutzereingaben sind Parameter strukturierte Daten, mit denen auf einfache Weise ein bestimmter Ablauf ausgeführt werden kann oder Antworten erzeugt werden können.
Formulare
Für jede Seite können Sie ein Formular definieren. Dies ist eine Liste von Parametern, die vom Endnutzer für die Seite erfasst werden sollen. Der Agent interagiert mit dem Endnutzer mehrere Unterhaltungsrunden lang, bis er alle erforderlichen Formularparameter, auch Seitenparameter genannt, erfasst hat. Der Agent erfasst diese Parameter in der auf der Seite definierten Reihenfolge. Für jeden Formularparameter geben Sie auch Aufforderungen an, mit denen der Agent diese Informationen vom Endnutzer anfordert. Dieser Vorgang wird als Ausfüllen von Formularen bezeichnet.
Sie können beispielsweise ein Formular erstellen, in dem der Name und die Telefonnummer des Endnutzers für eine Collect Customer Info-Seite erfasst werden.
Intents
Ein Intent kategorisiert die Absicht eines Endnutzers für eine Unterhaltungsrunde.
Ein Intent enthält folgende Daten:
Anzeigename
Name, der in der Console für den Intent angezeigt wird.
Labels
Labels, die bei der Kategorisierung von Intents helfen. Beispiel: head intent.
Trainingsformulierungen
Trainingsformulierungen sind Beispielformulierungen für das, was Endnutzer eingeben oder sagen könnten, sogenannte Endnutzereingaben. Wenn die Endnutzereingabe einer dieser Formulierungen ähnelt, ordnet Conversational Agents (Dialogflow CX) den Intent zu. Sie müssen dabei nicht jede denkbare Formulierung angeben. Das integrierte maschinelle Lernen von Conversational Agents (Dialogflow CX) erweitert Ihre Liste automatisch um ähnliche Äußerungen.
Parameter
Sie definieren Ihre Trainingsformulierungen, um mithilfe von Parametern Werte aus bestimmten Teilen der Endnutzereingabe zu extrahieren.
DTMF-Muster
Weitere Informationen finden Sie unter DTMF für Telefonieintegrationen.

Webhook
Webhooks sind Dienste, die Ihre Geschäftslogik hosten oder andere Dienste aufrufen. Während einer Sitzung können Sie mit Webhooks die Daten verwenden, die Konversations-Agents (Dialogflow CX) per Natural Language Processing extrahiert haben, um dynamische Antworten zu generieren, erfasste Daten zu validieren oder Aktionen im Back-End auszulösen.
Ein Webhook kann entweder ein Standard-Webhook oder ein flexibler Webhook sein. Bei einem Standard-Webhook werden die Anfrage- und Antwortfelder von Conversational Agents (Dialogflow CX) definiert. Bei einem flexiblen Webhook definieren Sie die Anfrage- und Antwortfelder.
Auftragsausführung
Damit der Agent an der Unterhaltung teilnehmen kann, muss der Agent auf den Endnutzer mit einer Antwort auf eine Frage, einer Anfrage nach Informationen oder dem Beenden der Sitzung antworten. Ihr Agent muss sich möglicherweise auch mit Ihrem Dienst in Verbindung setzen, um dynamische Antworten zu generieren oder Aktionen für eine weitere Unterhaltungsrunde auszuführen. Auftragsausführung wird für all dies verwendet.
Eine Auftragsausführung kann folgende Elemente enthalten:
Statische Antwortnachrichten
Webhook-Aufrufe nach dynamischen Antworten und/oder Aktionen
Parametervoreinstellungen zum Festlegen oder Überschreiben von Parameterwerten
Während der Unterhaltungsrunde eines Agents ist es möglich (und manchmal gewünscht), mehrere Auftragsausführungen aufzurufen, von denen jede eine Antwort erzeugen kann. Conversational Agents (Dialogflow CX) speichern diese Antworten in einer Antwortwarteschlange. Nach Abschluss der Unterhaltungsrunde des Agents sendet Conversational Agents (Dialogflow CX) die sortierten Antworten an den Endnutzer.
Zustands-Handler
Zustands-Handler, auch einfach Handler genannt, werden zur Steuerung der Unterhaltung verwendet. Handler erstellen Antworten für Endnutzer und/oder wechseln die aktuelle Seite. Für jede Unterhaltungsrunde werden Handler ausgewertet. Dies kann sich auf die Sitzung auswirken. Handler haben drei allgemeine Datentypen:
Handler-Anforderungen
Dies sind die Anforderungen, die erfüllt sein müssen, damit sich der Handler auf die Sitzung auswirkt. Ein Handler gilt als aufgerufen, wenn er seine Anforderungen erfüllt und die Sitzung in irgendeiner Weise beeinflusst.
Handler-Auftragsausführung
Wenn ein Handler aufgerufen wird, werden mit einer optionalen Auftragsausführung Antworten für Endnutzer erstellt. Diese Antworten sind entweder in statischen Agent-Daten definiert oder werden dynamisch aus Ihrem Webhook-Dienst abgerufen.
Handler-Umstellungsziel
Nach dem Aufruf eines Handlers wird ein optionales Umstellungsziel verwendet, um die aktuelle Seite zu ändern. Die nächste Seite kann nur eine Ablauf-Startseite oder eine Seite im aktuell aktiven Ablauf sein.

Es gibt zwei Arten von Zustands-Handlern mit unterschiedlichen Handler-Anforderungen:
Routen
Routen werden aufgerufen, wenn eine Endnutzereingabe mit einem Intent übereinstimmt und/oder eine Bedingung für den Sitzungsstatus erfüllt ist. Eine Route mit einer Intent-Anforderung wird auch als Intent-Route bezeichnet. Eine Route mit lediglich einer Bedingungsanforderung wird auch als Bedingungsroute bezeichnet.
Event-Handler
Ereignis-Handler werden aufgerufen, wenn ein Ereignis eintritt. Einige integrierte Ereignisse werden ausgelöst, wenn unerwartete Endnutzereingaben empfangen werden oder wenn ein Webhook-Fehler auftritt. Sie können auch benutzerdefinierte Ereignisse definieren, die aufgerufen werden, wenn etwas außerhalb der Unterhaltung stattfindet.

Die Verarbeitung eines Zustands-Handlers umfasst drei Schritte:

1. Umfang
   Ein Handler muss sich im Bereich befinden, um Auswirkungen auf die Sitzung zu haben. Der Bereich wird dadurch bestimmt, ob ein Handler auf einen Ablauf, eine Seite oder einen Formularparameter angewendet wird und ob der verknüpfte Ablauf aktiv ist, die zugehörige Seite aktiv ist oder der Agent versucht, den zugehörigen Formularparameter auszufüllen.
2. Bewertung
   Jeder Handler im Bereich wird der Reihe nach ausgewertet. Wenn die Anforderungen eines Handlers erfüllt sind, gilt die Bewertung als bestanden.
3. Aufruf
   Wenn ein Handler im Bereich liegt und die Bewertung besteht, wird er aufgerufen. Zugehörige Auftragsausführungen werden aufgerufen und zugehörige Umstellungsziele werden auf die Sitzung angewendet.

Regionalisierung und Standorteinstellungen
Wenn Sie einen Agent erstellen, müssen Sie eine Region als Speicherort des Agents angeben. Anfragen, die an Ihren Kundenservicemitarbeiter gesendet werden, werden von Google-Diensten in dieser Region verarbeitet und Conversational Agents (Dialogflow CX) speichert ruhende Daten physisch in der geografischen Region oder an dem entsprechenden Standort. Für eine optimale Leistung sollten Sie eine Region in der Nähe Ihrer Dienste und Endnutzer auswählen.
Nachdem ein Agent erstellt wurde, kann dessen Speicherort nicht mehr geändert werden. Wenn Sie den Standort eines Agents ändern möchten, müssen Sie einen neuen Agent mit einem anderen Standort erstellen und den Agent dorthin exportieren und wiederherstellen.
Jedem Standort sind Einstellungen zugeordnet, die für Ihr Projekt gelten. In den meisten Fällen müssen Sie diese Standorteinstellungen nicht bearbeiten und die Standardeinstellungen funktionieren gut. Wenn Ihr System vom Kunden verwaltete Verschlüsselungsschlüssel benötigt und diese häufig von Behörden oder regulierten Branchen benötigt werden, finden Sie weitere Informationen zu Standorteinstellungen.
Console
Conversational Agents (Dialogflow CX) bietet eine Webbenutzeroberfläche namens Dialogflow CX Console (Dokumentation aufrufen, Konsole öffnen). Mit dieser Konsole können Sie Agents erstellen und testen. Sie stellt jeden Ablauf als Maschinendiagramm des Unterhaltungsstatus dar, wodurch komplexe Bots leichter zu entwerfen und zu verstehen sind.
Die Dialogflow CX Console unterscheidet sich von der Google Cloud Console (Dokumentation ansehen, Konsole öffnen). Die Dialogflow CX Console dient zum Verwalten von Conversational Agents (Dialogflow CX), während mit der Google Cloud Console Google Cloud-spezifische Conversational Agents (Dialogflow CX)-Einstellungen (z. B. für die Abrechnung) und andere Google Cloud -Ressourcen verwaltet werden.
In den meisten Fällen sollten Sie zum Erstellen von Agents die Dialogflow CX Console verwenden. Agents für komplexere Szenarien können Sie aber auch mit der Dialogflow API erstellen.
Integrationen
Konversations-Agents (Dialogflow CX) bieten mehrere integrierte Integrationen mit anderen Unterhaltungsplattformen. Diese Integrationen stellen dem Endnutzer eine Benutzeroberfläche zur Verfügung und rufen die API für Sie auf. Sie müssen lediglich einen Agent erstellen und optional einen Webhook-Dienst implementieren. Jede Integration behandelt die Interaktionen plattformspezifisch. Weitere Informationen finden Sie in der jeweiligen Integrationsdokumentation.
Interactions
Für jede Unterhaltungsrunde findet eine Interaktion statt. Während einer Interaktion sendet ein Endnutzer eine Eingabe an Conversational Agents (Dialogflow CX) und Conversational Agents (Dialogflow CX) sendet eine Antwort. Sie haben zwei Möglichkeiten, Ihr System für die Verarbeitung von Interaktionen zu implementieren: mithilfe der API oder mithilfe einer Integration.
Wenn Sie die API verwenden, muss Ihr System Folgendes verarbeiten:
Agent erstellen
Benutzeroberfläche für Endnutzer bereitstellen
Rufen Sie die Dialogflow API für jeden Sprecherwechsel auf, um Endnutzereingaben an die API zu senden.
Wenn die Agent-Antworten nicht nur statisch sind (seltener), müssen Sie einen Webhook-Dienst für die Verarbeitung der Webhook-aktivierten Auftragsausführung hosten.
Wenn Sie eine Integration verwenden, muss Ihr System nur Folgendes verarbeiten:
Agent erstellen
Implementieren Sie optional einen Webhook-Dienst.
Das folgende Diagramm zeigt die Schritte, die für einen Sprecherwechsel einer Sitzung ausgeführt werden.
Hinweis: Die Kommunikation zwischen Ihren Systemen und Integrationen und Dialogflow wird bei der Übertragung verschlüsselt. Außerdem wird die Kommunikation zwischen internen Google-Komponenten mit Application Layer Transport Security (ALTS) verschlüsselt.

Der Endnutzer gibt etwas ein oder sagt etwas. Dies wird als Endnutzereingabe bezeichnet.
Ihr Benutzeroberflächen- oder Integrationssystem empfängt die Eingabe und leitet sie in einer Anfrage zur Intent-Erkennung an die Dialogflow API weiter.
Die Dialogflow API empfängt die Anfrage zur Intent-Erkennung. Sie ordnet die Eingabe einem Intent- oder Formularparameter zu, legt bei Bedarf Parameter fest und aktualisiert den Sitzungsstatus. Falls eine Webhook-fähige Auftragsausführung aufgerufen werden muss, wird eine Webhook-Anfrage an Ihren Webhook-Dienst gesendet. Fahren Sie andernfalls mit Schritt 6 fort.
Ihr Webhook-Dienst empfängt die Webhook-Anfrage. Der Dienst führt alle erforderlichen Aktionen aus, z. B. das Aufrufen externer APIs, das Abfragen oder Aktualisieren einer Datenbank usw.
Ihr Webhook-Dienst erstellt eine Antwort und sendet eine Webhook-Antwort an den Konversations-Agenten (Dialogflow CX).
Conversational Agents (Dialogflow CX) erstellen eine Antwort für die Intent-Erkennung. Wenn ein Webhook aufgerufen wurde, verwendet es die Webhook-Antwort. Wenn kein Webhook aufgerufen wurde, verwendet es die im Agent definierte statische Antwort. Konversations-Agenten (Dialogflow CX) senden eine Antwort für die Intent-Erkennung an Ihre Benutzeroberfläche oder Ihr Integrationssystem.
Ihr Benutzeroberflächen- oder Integrationssystem empfängt die Antwort für die Intent-Erkennung und leitet die Text- oder Audioantwort an den Endnutzer weiter.
Der Endnutzer sieht oder hört die Antwort.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Andere Beispiele und Lernmaterial
bookmark_border
In den Einstiegsleitfäden und Anleitungen auf der linken Seite des Dokuments finden Sie grundlegende und detaillierte Informationen und Beispiele. Diese Seite listet weitere qualitativ hochwertige Beispiele und Kurse auf anderen Websites auf.
Von der Community erstellte Komponenten
Hinweis: Google bietet keinen Support für diese Komponenten.
Die Dialogflow-Community hat die folgenden Komponenten erstellt:
Komponente
Links
Actions on Google Guess Game von Kuldeep Kumar Sharma
https://github.com/Kuldeep-Kumar-Sharma/AOC-Guess-The-Capital
Conversational Glue (Conversational driven Website Navigation) von Owen Smith
https://github.com/CaffeineFusion/conversational-glue
Dialogflow CX-Befehlszeilentool von Xavier Portilla Edo
https://github.com/xavidop/dialogflow-cx-cli
Diskrete Komponente von Denis Valášek
https://github.com/DenisVCode/dialogflow-cx-discord
Discord-Komponente von John Dikeman
https://github.com/johndikeman/DFCXDiscord
Golang-Webhook von Xavier Portilla Edo
https://github.com/xavidop/dialogflow-cx-webhook-go
JavaScript-Webhook-Boilerplate von Pratik Kotian
https://github.com/pratikkotian04/webhook-boilerplate
Multivocal Uniform TypeScript Library zum Erstellen von Webhooks von Alan Fristenberg
https://github.com/afirstenberg/multivocal
Neo4J-Museum-Integration von Dou Liu
https://github.com/LDLucien/dfcx_virtual_museum_guide
Python-Webhook für ML-Nutzer von Yan Pheng Choo
https://github.com/yptheangel/dialogflowcx-custom-webhook
Raspberry Pi-Integration von Nidhin Kumar
https://github.com/nidhinkumar06/RaspberryPi-DialogflowCX
React Native-Komponente von Daniel Cabello
https://github.com/DKbyo/react-native-dialogflow-cx
Slack-Integration von Sampriti Mitra
https://github.com/Sampriti-Mitra/dialogflow-slack-sdk
Telefonie-Java IVR-Integration von Shivaprasad Mohanrao
https://github.com/shivaprasadmohanrao/dfcx_telephony_integration.git
TypeScript-UI-Komponente von Emmanuel Asamoah Botwe
https://github.com/botchway44/covid-vaccine-appointment
TypeScript-Klassen und ‑Typen für Dialogflow Messenger von Xavier Portilla Edo
https://github.com/xavidop/dialogflow-cx-messenger-ts
TypeScript-Webhook für Google Analytics von Tom Hartogs
https://github.com/TomHartogs/dialogflowcx-generic-webhooks
TypeScript-Webhook von Xavier Portilla Edo
https://github.com/xavidop/dialogflow-cx-webhook-typescript
UI-Integration von Yüksel Tolun
https://github.com/YTolun/dtl-bot
Vonage-Integration (Escaperoom) von Mark Berkeland
https://github.com/mberkeland/DiabolicFlow
WhatsApp-, Twilio-Integration von Ayush Nigam
https://github.com/ayushnig/dialogflowcx-whatsapp
WhatsApp, Twilio, Springboot-Integration von Priti Sharma
https://github.com/pritisharma127/dfcx-whatsapp-integration.git

Von der Community erstellte Agents
Hinweis: Google bietet keinen Support für diese Kundenservicemitarbeiter.
Die Dialogflow-Community hat die folgenden Agenten erstellt:
Ersteller
Links
Alok Gupta
https://github.com/sadasystems/covid19-healthcare-chatbot
Abhirup Bhattacharya
https://github.com/DaZZler12/Conversational-Flow-Dialogflow-CX-Competition-
Adriana Capua
https://gitlab.com/senti-techlabs-inc-public/cx-competition
Biju Madhavan
https://github.com/BMaddy35/SafeTravel.git
Cesar Romero
https://github.com/CLRC365/CX-Appoinment
Deepak Mewada
https://github.com/deepakanncode/dialogflowcx
EnJun Choong
https://github.com/EnJunChoong/dialogflowcx_agent_complaints
Harshit Kaithwas
https://github.com/kaithwash2/Dailogflow-CX-Donation_Bot.git
Irakli Beselidze
https://github.com/iBeselidze/CovidBotDFcontest
Itai Neter
https://github.com/pklreak/rckwrch/
Ivona Gudelj
https://github.com/meditiva/Nova
Jie Diroy
https://gitlab.com/senti-techlabs-inc-public/cx-competition-vida
Lars Lipinski
https://github.com/LarsLipinski/night-porter-bot
Manasa Malligere Krishna
https://github.com/MANASAMKRISHNA/Dialogflow-CX-Hackathon
Mitadru Datta
https://github.com/MitadruDatta/DialogFlowCX_UX
Mounika Pedapati
https://github.com/MounikaPedapati/Dilaogflow-CX
Mugdha Vairagade
https://github.com/mugdhav/InfoFinderChatbotProject
Neha Kumari
https://github.com/Nehank1709/Dialogflow-CX
Noel Jaymon
https://github.com/noeljaymon/CX-Competition
Partha Sen
https://github.com/parthasen/DialogflowCX
Pavan Reddy Maddi
https://github.com/lasyapriyanka/amigo-cx-bot
Paweł Eliasz
https://github.com/Yosh-AI/dialogflow-cx-competition
Pinyapat Amornrattanaroj
https://github.com/praewuzz/dialogflow-competition-covid-19
Raja Vikrant Sharma
https://github.com/connectrv/V-bot
Raluca Raluca
https://github.com/ralukancuta/covid19-chatbot
Rajiv Coomar
https://github.com/rajivcoomar/DialogflowCX
Shreya Banerjee
https://github.com/Shreya1805-web/Assistant-for-the-elderly
Spencer Lockerman
https://github.com/lockerst/google_dialogflowcx_competition
Sreenivas Gorantla
https://github.com/Sreenivas25/CX-Competition.git
Svetlana Meissner
https://github.com/Unisvet/chatbot
Takashi Kawamoto
https://github.com/mochan-tk/jogging-assistant
Vladimir Leoh
https://github.com/vladimirleoh/dialogflowcx

Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Sentimentanalyse
bookmark_border
Bei der Sentimentanalyse werden Endnutzereingaben geprüft, um die vorherrschende subjektive Meinung zu ermitteln. Dadurch soll insbesondere festgestellt werden, ob Endnutzer eine positive, negative oder neutrale Einstellung haben. Sie können bei einer Anfrage zur Intent-Erkennung festlegen, dass eine Sentimentanalyse durchgeführt wird. Dann enthält die Antwort Sentimentanalysewerte.
Unterstützte Sprachen
Eine Liste der unterstützten Sprachen finden Sie in der Spalte Sentiment in der Sprachreferenz. Wenn Sie eine Sentimentanalyse für eine nicht unterstützte Sprache anfordern, schlägt Ihre Anfrage zur Intent-Erkennung nicht fehl, das Feld QueryResult.diagnostic_info enthält jedoch Fehlerinformationen.
Intent erkennen
Mit der API können Sie für jeden detectIntent- oder streamingDetectIntent-Aufruf eine Sentimentanalyse anfordern. Dazu legen Sie für das Feld analyzeQueryTextSentiment den Wert „true“ fest. Die Antwort enthält das Feld sentimentAnalysisResult mit den Werten score und magnitude.
Stimmung in Bedingungen verwenden
Sie können die Ergebnisse der Stimmungsanalyse über die Parameter auf Anfrageebene verwenden, wenn Sie eine Bedingung definieren.
Weitere Informationen finden Sie in den Beschreibungen der Parameter für die Stimmungsanalyse und in der Referenz zu Bedingungen. Dort erfahren Sie auch, wie die Parameter in Bedingungen verwendet werden können.
Stimmung im Simulator verwenden
Sie können die Sentimentanalyse aktivieren, wenn Sie den Simulator verwenden.
Von Dialogflow ES zu Conversational Agents (Dialogflow CX) migrieren
bookmark_border
Conversational Agents (Dialogflow CX) bieten effektivere Steuerelemente und Tools für Unterhaltungen als Dialogflow ES-Agents. Wenn Ihr Dialogflow ES-Agent komplexe Unterhaltungen verarbeitet, sollten Sie eine Migration zu Conversational Agents (Dialogflow CX) in Betracht ziehen.
In diesem Leitfaden wird beschrieben, wie Sie einen Kundenservicemitarbeiter von Dialogflow ES zu Conversational Agents (Dialogflow CX) migrieren. Diese beiden Kundenservicemitarbeitertypen unterscheiden sich grundlegend voneinander, sodass es keine einfache Möglichkeit gibt, diese Migration durchzuführen.
Wenn Sie diesen Leitfaden für eine Migration verwenden, geben Sie bitte positives oder negatives Feedback, indem Sie oben auf die Schaltfläche Feedback geben klicken. Wir nutzen dieses Feedback, um diesen Leitfaden im Laufe der Zeit zu verbessern.
Im Großen und Ganzen wird ein hybrider Prozess empfohlen, der automatisierte und manuelle Schritte umfasst. Sie verwenden ein Tool, das einige Ihrer Dialogflow ES-Kundenservicemitarbeiterdaten liest, diese Daten in Ihren Conversational Agents (Dialogflow CX)-Kundenservicemitarbeiter schreibt und eine To-do-Liste erfasst. Erstellen Sie dann Ihren vollständigen Konversations-Agenten (Dialogflow CX) anhand der Best Practices, der TODO-Liste und der Daten, die mit dem Tool migriert wurden.
Konversations-Agenten (Dialogflow CX)
Bevor Sie mit der Migration beginnen, sollten Sie sich mit den Abläufen von Conversational Agents (Dialogflow CX) vertraut machen. So gehts:
Grundlagen von Flows
Sie sollten sich auch zusätzliche Konzeptdokumente ansehen, die Funktionen enthalten, die Sie in Ihrem neuen Bot wahrscheinlich benötigen. Konzentrieren Sie sich auf Folgendes:
Console – Übersicht
Agents
Abläufe
Seiten
Zustands-Handler
Intents
Parameter
Ausführungen
Webhooks
Unterschiede zwischen Dialogflow ES und Conversational Agents (Dialogflow CX)
In diesem Abschnitt sind die wichtigsten Unterschiede zwischen Dialogflow ES und Conversational Agents (Dialogflow CX) aufgeführt. Wenn Sie später manuelle Migrationsschritte ausführen, sollten Sie sich an diesen Abschnitt halten.
Struktur und Unterhaltungsverlauf steuern
Dialogflow ES bietet Folgendes für die Struktur- und Unterhaltungspfadsteuerung:
Intents sind die Bausteine des Agents. An jedem Punkt der Unterhaltung wird ein Intent abgeglichen. In gewisser Weise ist jeder Intent ein Knoten für die Unterhaltung.
Der Kontext wird verwendet, um den Ablauf der Unterhaltung zu steuern. Mithilfe des Kontexts wird festgelegt, welche Intents zu einem bestimmten Zeitpunkt abgeglichen werden können. Der Kontext läuft nach einer bestimmten Anzahl von Unterhaltungsrunden ab. Daher kann diese Art der Steuerung bei langen Unterhaltungen ungenau sein.
Conversational Agents (Dialogflow CX) bieten eine Hierarchie von Strukturressourcen und genauere Steuerelemente für den Konversationspfad:
Seiten sind Graphknoten für die Unterhaltung. Unterhaltungen mit Conversational Agents (Dialogflow CX) ähneln Zustandsmaschinen. Zu jedem Zeitpunkt der Unterhaltung ist eine Seite aktiv. Je nach Eingaben oder Ereignissen des Endnutzers kann die Unterhaltung zu einer anderen Seite wechseln. Es ist üblich, dass eine Seite für mehrere Gesprächsrunden aktiv bleibt.
Abläufe sind Gruppen ähnlicher Seiten. Jeder Ablauf sollte ein allgemeines Gesprächsthema abdecken.
Zustands-Handler werden verwendet, um Übergänge und Antworten zu steuern. Es gibt drei Arten von Status-Handlern:
Intent-Route: Enthält einen Intent, der abgeglichen werden muss, optionale Antworten und einen optionalen Seitenübergang.
Bedingungsroute: Enthält eine Bedingung, die erfüllt sein muss, optionale Antworten und einen optionalen Seitenübergang.
Ereignis-Handler: Enthält einen Ereignisnamen, der aufgerufen werden muss, optionale Antworten und optionale Seitenübergänge.
Mit dem Umfang wird gesteuert, ob ein Zustands-Handler aufgerufen werden kann. Die meisten Handler sind mit einer Seite oder einem gesamten Ablauf verknüpft. Wenn die zugehörige Seite oder der zugehörige Ablauf aktiv ist, liegt der Handler im Gültigkeitsbereich und kann aufgerufen werden. Eine gültige Intent-Route für Conversational Agents (Dialogflow CX) ähnelt einem Dialogflow ES-Intent mit einem aktiven Eingabekontext.
Beachten Sie beim Entwerfen der Aufrufabfolgen und Seiten Ihres Agents die Tipps im Abschnitt zum Aufrufablauf im Leitfaden zum Design von Kundenservicemitarbeitern.
Formular ausfüllen
In Dialogflow ES werden erforderliche Parameter vom Endnutzer mithilfe der Slot-Füllung erfasst:
Diese Parameter sind als erforderlich gekennzeichnete Intent-Parameter.
Die Zuordnung des Intents wird fortgesetzt, bis alle erforderlichen Parameter erfasst wurden.
Sie können einen Prompt definieren, in dem der Endnutzer aufgefordert wird, einen Wert anzugeben.
Conversational Agents (Dialogflow CX) verwenden das Ausfüllen von Formularen, um die erforderlichen Parameter vom Endnutzer zu erfassen:
Diese Parameter sind mit einer Seite verknüpft und werden erfasst, während die Seite aktiv ist.
Mithilfe von Bedingungsrouten für Seiten können Sie feststellen, ob das Ausfüllen des Formulars abgeschlossen ist. Diese Bedingungsrouten führen in der Regel zu einer anderen Seite.
Sie können einen Prompt sowie Handler für wiederholte Prompts definieren, um mehrere Versuche zum Erfassen eines Werts reibungslos zu verarbeiten.
Übergänge
Dialogflow ES wechselt automatisch von einem Intent zum nächsten, wenn die Eingabe des Endnutzers einem Intent zugeordnet wird. Diese Zuordnung kann nur für Intents ohne Eingabekontext oder für Intents mit einem aktiven Eingabekontext erfolgen.
Conversational Agents (Dialogflow CX) wechseln von einer Seite zur nächsten, wenn ein in der Reichweite befindlicher Status-Handler seine Anforderungen erfüllt und ein Übergangsziel angibt. Mithilfe dieser Übergänge können Sie Endnutzer zuverlässig durch Unterhaltungen führen. Es gibt mehrere Möglichkeiten, diese Übergänge zu steuern:
Die Intent-Zuordnung kann eine Intent-Route auslösen.
Wenn eine Bedingung erfüllt ist, kann eine Bedingungsroute ausgelöst werden.
Das Aufrufen eines Ereignisses kann einen Event-Handler auslösen.
Handler für die erneute Eingabeaufforderung können einen Übergang auslösen, wenn der Endnutzer nach mehreren Versuchen keinen Wert angibt.
Sie können symbolische Umstellungsziele für Umstellungsziele verwenden.
Antworten von Kundenservicemitarbeitern
Dialogflow ES-Agentantworten werden an den Endnutzer gesendet, wenn ein Intent zugeordnet wird:
Der Kundenservicemitarbeiter kann aus einer Liste möglicher Antworten eine Nachricht für die Antwort auswählen.
Antworten können plattformspezifisch sein und reichhaltige Antwortformate verwenden.
Antworten können über Webhooks ausgelöst werden.
Antworten von Conversational Agents (Dialogflow CX) werden an den Endnutzer gesendet, wenn fulfillment aufgerufen wird. Im Gegensatz zur Dialogflow ES-Auftragsausführung, die immer einen Webhook erfordert, kann die Auftragsausführung für Conversational Agents (Dialogflow CX) einen Webhook aufrufen oder nicht, je nachdem, ob für die Auftragsausführungsressource ein Webhook konfiguriert ist. Sowohl statische als auch dynamische Antworten, die auf Webhook-Antworten basieren, werden über die Auftragsausführung gesteuert. Es gibt mehrere Möglichkeiten, Antworten von Kundenservicemitarbeitern zu erstellen:
Die Auftragsausführung kann für jeden Status-Handler bereitgestellt werden.
Mehrere Antworten können während einer Unterhaltungsrunde über die Antwortwarteschlange verkettet werden. Diese Funktion kann in einigen Fällen das Design Ihres Kundenservicemitarbeiters vereinfachen.
Conversational Agents (Dialogflow CX) unterstützen keine integrierten plattformspezifischen Antworten. Es bietet jedoch mehrere Antworttypen, einschließlich einer benutzerdefinierten Nutzlast, die für plattformspezifische Antworten verwendet werden kann.
Parameter
Dialogflow ES-Parameter haben folgende Eigenschaften:
Nur in Intents definiert.
Wird durch Eingaben von Endnutzern, Ereignissen, Webhooks und API-Aufrufen festgelegt.
Wird in Antworten, Parameteraufforderungen, Webhook-Code und Parameterwerten referenziert:
Das grundlegende Referenzformat ist $parameter-name.
Für Verweise wird die Suffixsyntax .original, .partial und .recent unterstützt.
In Referenzen kann der aktive Kontext angegeben werden: #context-name.parameter-name.
In Verweislisten können Ereignisparameter angegeben werden: #event-name.parameter-name.
Parameter für Conversational Agents (Dialogflow CX) haben folgende Merkmale:
In Intents und Seitenformularen definiert.
Intent- und Formularparameter werden an Sitzungsparameter weitergegeben, wo sie während der Sitzung referenziert werden können.
Wird durch die Endnutzereingabe, Webhooks, Parametervoreinstellungen für die Auftragsausführung und API-Aufrufe festgelegt.
Wird in Antworten, Parameteraufforderungen, Handlers für wiederholte Aufforderungen, Parametervoreinstellungen und Webhook-Code referenziert:
Das Referenzformat ist $session.params.parameter-id für Sitzungsparameter und $intent.params.parameter-id für Intent-Parameter.
Intent-Parameterverweise unterstützen die Suffixsyntax .original und .resolved. Diese Syntax wird von Sitzungsparametern nicht unterstützt.
Systementitäten
Dialogflow ES unterstützt viele Systementitäten.
Conversational Agents (Dialogflow CX) unterstützen viele derselben Systementitäten. Es gibt jedoch einige Unterschiede. Prüfen Sie bei der Migration, ob die Systementitäten, die Sie in Dialogflow ES verwenden, auch von Conversational Agents (Dialogflow CX) für dieselbe Sprache unterstützt werden. Andernfalls sollten Sie benutzerdefinierte Entitäten für diese erstellen.
Ereignisse
Dialogflow ES-Ereignisse haben folgende Merkmale:
Kann über API-Aufrufe oder Webhooks aufgerufen werden, um einer Absicht zu entsprechen.
Parameter festlegen.
Von Integrationsplattformen werden nur wenige Ereignisse aufgerufen.
Ereignisse für Conversational Agents (Dialogflow CX) haben folgende Merkmale:
Kann über API-Aufrufe oder Webhooks aufgerufen werden, um einen Ereignis-Handler aufzurufen.
Parameter können nicht festgelegt werden.
Viele integrierte Ereignisse können verwendet werden, um den fehlenden oder nicht erkannten Nutzereintrag, durch einen Webhook ungültig gemachte Parameter und Webhook-Fehler zu verarbeiten.
Aufrufe können mit denselben Umfangsregeln wie andere Status-Handler gesteuert werden.
Integrierte Intents
Dialogflow ES unterstützt die folgenden integrierten Intents:
Willkommensabsicht
Fallback-Intents
Vordefinierte Follow-up-Intents
Im Folgenden wird die Unterstützung von vordefinierten Intents durch Conversational Agents (Dialogflow CX) beschrieben:
Willkommensabsichten werden unterstützt.
Fallback-Intents werden nicht bereitgestellt. Verwenden Sie stattdessen die Ereignisse vom Typ „Kein Übereinstimmen“ in Ereignis-Handlern.
Verwenden Sie für Negativbeispiele den standardmäßig auszuschließenden Intent.
Vordefinierte Follow-up-Intents werden nicht bereitgestellt. Sie müssen diese Intents entsprechend den Anforderungen Ihres Agents erstellen. Beispielsweise müssen Sie wahrscheinlich eine Absicht erstellen, um negative Antworten auf eine Frage eines Kundenservicemitarbeiters zu verarbeiten („Nein“, „Nein, danke“, „Nein, ich habe keine“ usw.). Intents für Conversational Agents (Dialogflow CX) können für Ihren gesamten Agenten wiederverwendet werden. Sie müssen sie also nur einmal definieren. Wenn Sie für diese häufigen Intents unterschiedliche Intent-Routen in verschiedenen Bereichen verwenden, haben Sie viel mehr Kontrolle über die Unterhaltung.
Webhooks
Dialogflow ES-Webhooks haben folgende Eigenschaften:
Sie können einen Webhook-Dienst für den Kundenservicemitarbeiter konfigurieren.
Jede Absicht kann als Verwendung des Webhooks gekennzeichnet werden.
Es gibt keine integrierte Unterstützung für die Verarbeitung von Webhook-Fehlern.
Intent-Aktionen oder Intent-Namen werden von Webhooks verwendet, um zu ermitteln, wo im Bot sie aufgerufen wurden.
Die Console bietet den Inline-Editor.
Webhooks für Conversational Agents (Dialogflow CX) haben die folgenden Eigenschaften:
Sie können mehrere Webhook-Dienste für den Kundenservicemitarbeiter konfigurieren.
Für jede Auftragsausführung kann optional ein Webhook-Aufruf angegeben werden.
Es gibt eine integrierte Unterstützung für die Webhook-Fehlerbehandlung.
Ein Fulfillment-Webhook für Conversational Agents (Dialogflow CX) enthält ein Tag. Dieses Tag ähnelt einer Dialogflow ES-Aktion, wird aber nur zum Aufrufen von Webhooks verwendet. Der Webhook-Dienst kann anhand dieser Tags ermitteln, wo im Agenten er aufgerufen wurde.
Die Console hat keinen integrierten Webhook-Code-Editor. Häufig werden Cloud Functions verwendet, aber es gibt viele Optionen.
Wenn Sie zu Conversational Agents (Dialogflow CX) migrieren, müssen Sie Ihren Webhook-Code ändern, da sich die Anfrage- und Antworteigenschaften unterscheiden.
Integrationen
Dialogflow ES-Integrationen und Integrationen für Konversations-Agenten (Dialogflow CX) unterstützen unterschiedliche Plattformen. Bei Plattformen, die von beiden Kundenservicemitarbeitertypen unterstützt werden, kann es zu Unterschieden bei der Konfiguration kommen.
Wenn die von Ihnen verwendete Dialogflow ES-Integration von Konversations-Agents (Dialogflow CX) nicht unterstützt wird, müssen Sie möglicherweise die Plattform wechseln oder die Integration selbst implementieren.
Weitere Funktionen nur für Conversational Agents (Dialogflow CX)
Es gibt viele weitere Funktionen, die nur von Conversational Agents (Dialogflow CX) unterstützt werden. Sie sollten diese Funktionen während der Migration verwenden. Beispiel:
Erweiterte NLU
Erweiterte Spracheinstellungen (Empfindlichkeit für das Ende der Spracheingabe, kein Sprachzeitlimit usw.)
Änderungsverlauf
Bedingte Logik
DTMF-Eingabe für Telefonieintegrationen
Umgebungsspezifische Webhooks
Tests
Route-Gruppen
Suchagentendaten
Sicherheitseinstellungen (Entfernen von Daten und Datenaufbewahrung)
Systemfunktionen für erweiterte Antworten und Bedingungen
Testfälle
Validierung von Kundenservicemitarbeiterdaten
Best Practices
Bevor Sie migrieren, sollten Sie sich mit den Best Practices für das Design von Konversations-Agents (Dialogflow CX) vertraut machen. Viele dieser Best Practices für Conversational Agents (Dialogflow CX) ähneln den Best Practices für Dialogflow ES, einige sind jedoch nur für Conversational Agents (Dialogflow CX) geeignet.
Informationen zum Migrationstool
Das Migrationstool kopiert den Großteil der Dialogflow ES-Daten in Ihren Konversations-Agent (Dialogflow CX) und schreibt eine TODO-Datei mit einer Liste der Elemente, die manuell migriert werden müssen. Das Tool kopiert nur benutzerdefinierte Entitätstypen und Trainingsphrasen für Absichten. Sie sollten dieses Tool an Ihre spezifischen Anforderungen anpassen.
Code des Migrationstools
Hier ist der Code für das Tool. Sie sollten sich den Code für dieses Tool ansehen, damit Sie wissen, was es tut. Sie können diesen Code ändern, um bestimmte Situationen in Ihrem Bot zu behandeln. In den folgenden Schritten führen Sie dieses Tool aus.
// Package main implements the ES to CX migration tool.
package main

import (
„context“
„encoding/csv“
„flag“
„fmt“
„os“
„strings“
„time“

v2 "cloud.google.com/go/dialogflow/apiv2"
proto2 "cloud.google.com/go/dialogflow/apiv2/dialogflowpb"
v3 "cloud.google.com/go/dialogflow/cx/apiv3"
proto3 "cloud.google.com/go/dialogflow/cx/apiv3/cxpb"
"google.golang.org/api/iterator"
"google.golang.org/api/option"

)

// Commandline flags
var v2Project *string = flag.String(„es-project-id“, „“, „ES project“)
var v3Project *string = flag.String(„cx-project-id“, „“, „CX project“)
var v2Region *string = flag.String(„es-region-id“, „“, „ES region“)
var v3Region *string = flag.String(„cx-region-id“, „“, „CX region“)
var v3Agent *string = flag.String(„cx-agent-id“, „“, „CX region“)
var outFile *string = flag.String(„out-file“, „“, „Output file for CSV TODO items“)
var dryRun *bool = flag.Bool(„dry-run“, false, „Set true to skip CX agent writes“)

// Map from entity type display name to fully qualified name.
var entityTypeShortToLong = map[string]string{}

// Map from ES system entity to CX system entity
var convertSystemEntity = map[string]string{
„sys.address“: „sys.address“,
„sys.any“: „sys.any“,
„sys.cardinal“: „sys.cardinal“,
„sys.color“: „sys.color“,
„sys.currency-name“: „sys.currency-name“,
„sys.date“: „sys.date“,
„sys.date-period“: „sys.date-period“,
„sys.date-time“: „sys.date-time“,
„sys.duration“: „sys.duration“,
„sys.email“: „sys.email“,
„sys.flight-number“: „sys.flight-number“,
„sys.geo-city-gb“: „sys.geo-city“,
„sys.geo-city-us“: „sys.geo-city“,
„sys.geo-city“: „sys.geo-city“,
„sys.geo-country“: „sys.geo-country“,
„sys.geo-state“: „sys.geo-state“,
„sys.geo-state-us“: „sys.geo-state“,
„sys.geo-state-gb“: „sys.geo-state“,
„sys.given-name“: „sys.given-name“,
„sys.language“: „sys.language“,
„sys.last-name“: „sys.last-name“,
„sys.street-address“: „sys.location“,
„sys.location“: „sys.location“,
„sys.number“: „sys.number“,
„sys.number-integer“: „sys.number-integer“,
„sys.number-sequence“: „sys.number-sequence“,
„sys.ordinal“: „sys.ordinal“,
„sys.percentage“: „sys.percentage“,
„sys.person“: „sys.person“,
„sys.phone-number“: „sys.phone-number“,
„sys.temperature“: „sys.temperature“,
„sys.time“: „sys.time“,
„sys.time-period“: „sys.time-period“,
„sys.unit-currency“: „sys.unit-currency“,
„sys.url“: „sys.url“,
„sys.zip-code“: „sys.zip-code“,
}

// Issues found for the CSV output
var issues = [][]string{
{„Field“, „Issue“},
}

// logIssue logs an issue for the CSV output
func logIssue(field string, issue string) {
issues = append(issues, []string{field, issue})
}

// convertEntityType converts an ES entity type to CX
func convertEntityType(et2 *proto2.EntityType) *proto3.EntityType {
var kind3 proto3.EntityType_Kind
switch kind2 := et2.Kind; kind2 {
case proto2.EntityType_KIND_MAP:
kind3 = proto3.EntityType_KIND_MAP
case proto2.EntityType_KIND_LIST:
kind3 = proto3.EntityType_KIND_LIST
case proto2.EntityType_KIND_REGEXP:
kind3 = proto3.EntityType_KIND_REGEXP
default:
kind3 = proto3.EntityType_KIND_UNSPECIFIED
}
var expansion3 proto3.EntityType_AutoExpansionMode
switch expansion2 := et2.AutoExpansionMode; expansion2 {
case proto2.EntityType_AUTO_EXPANSION_MODE_DEFAULT:
expansion3 = proto3.EntityType_AUTO_EXPANSION_MODE_DEFAULT
default:
expansion3 = proto3.EntityType_AUTO_EXPANSION_MODE_UNSPECIFIED
}
et3 := &proto3.EntityType{
DisplayName: et2.DisplayName,
Kind: kind3,
AutoExpansionMode: expansion3,
EnableFuzzyExtraction: et2.EnableFuzzyExtraction,
}
for _, e2 := range et2.Entities {
et3.Entities = append(et3.Entities, &proto3.EntityType_Entity{
Value: e2.Value,
Synonyms: e2.Synonyms,
})
}
return et3
}

// convertParameterEntityType converts a entity type found in parameters
func convertParameterEntityType(intent string, parameter string, t2 string) string {
if len(t2) == 0 {
return „“
}
t2 = t2[1:] // remove @
if strings.HasPrefix(t2, „sys.“) {
if val, ok := convertSystemEntity[t2]; ok {
t2 = val
} else {
t2 = „sys.any“
logIssue(„Intent<„+intent+“>.Parameter<„+parameter+“>“,
„This intent parameter uses a system entity not supported by CX English agents. See the migration guide for advice. System entity: „+t2)
}
return fmt.Sprintf(„projects/-/locations/-/agents/-/entityTypes/%s“, t2)
}
return entityTypeShortToLong[t2]
}

// convertIntent converts an ES intent to CX
func convertIntent(intent2 *proto2.Intent) *proto3.Intent {
if intent2.DisplayName == „Default Fallback Intent“ ||
intent2.DisplayName == „Default Welcome Intent“ {
return nil
}

intent3 := &proto3.Intent{
    DisplayName: intent2.DisplayName,
}

// WebhookState
if intent2.WebhookState != proto2.Intent_WEBHOOK_STATE_UNSPECIFIED {
    logIssue("Intent<"+intent2.DisplayName+">.WebhookState",
        "This intent has webhook enabled. You must configure this in your CX agent.")
}

// IsFallback
if intent2.IsFallback {
    logIssue("Intent<"+intent2.DisplayName+">.IsFallback",
        "This intent is a fallback intent. CX does not support this. Use no-match events instead.")
}

// MlDisabled
if intent2.MlDisabled {
    logIssue("Intent<"+intent2.DisplayName+">.MlDisabled",
        "This intent has ML disabled. CX does not support this.")
}

// LiveAgentHandoff
if intent2.LiveAgentHandoff {
    logIssue("Intent<"+intent2.DisplayName+">.LiveAgentHandoff",
        "This intent uses live agent handoff. You must configure this in a fulfillment.")
}

// EndInteraction
if intent2.EndInteraction {
    logIssue("Intent<"+intent2.DisplayName+">.EndInteraction",
        "This intent uses end interaction. CX does not support this.")
}

// InputContextNames
if len(intent2.InputContextNames) > 0 {
    logIssue("Intent<"+intent2.DisplayName+">.InputContextNames",
        "This intent uses context. See the migration guide for alternatives.")
}

// Events
if len(intent2.Events) > 0 {
    logIssue("Intent<"+intent2.DisplayName+">.Events",
        "This intent uses events. Use event handlers instead.")
}

// TrainingPhrases
var trainingPhrases3 []*proto3.Intent_TrainingPhrase
for _, tp2 := range intent2.TrainingPhrases {
    if tp2.Type == proto2.Intent_TrainingPhrase_TEMPLATE {
        logIssue("Intent<"+intent2.DisplayName+">.TrainingPhrases",
            "This intent has a training phrase that uses a template (@...) training phrase type. CX does not support this.")
    }
    var parts3 []*proto3.Intent_TrainingPhrase_Part
    for _, part2 := range tp2.Parts {
        parts3 = append(parts3, &proto3.Intent_TrainingPhrase_Part{
            Text:        part2.Text,
            ParameterId: part2.Alias,
        })
    }
    trainingPhrases3 = append(trainingPhrases3, &proto3.Intent_TrainingPhrase{
        Parts:       parts3,
        RepeatCount: 1,
    })
}
intent3.TrainingPhrases = trainingPhrases3

// Action
if len(intent2.Action) > 0 {
    logIssue("Intent<"+intent2.DisplayName+">.Action",
        "This intent sets the action field. Use a fulfillment webhook tag instead.")
}

// OutputContexts
if len(intent2.OutputContexts) > 0 {
    logIssue("Intent<"+intent2.DisplayName+">.OutputContexts",
        "This intent uses context. See the migration guide for alternatives.")
}

// ResetContexts
if intent2.ResetContexts {
    logIssue("Intent<"+intent2.DisplayName+">.ResetContexts",
        "This intent uses context. See the migration guide for alternatives.")
}

// Parameters
var parameters3 []*proto3.Intent_Parameter
for _, p2 := range intent2.Parameters {
    if len(p2.Value) > 0 && p2.Value != "$"+p2.DisplayName {
        logIssue("Intent<"+intent2.DisplayName+">.Parameters<"+p2.DisplayName+">.Value",
            "This field is not set to $parameter-name. This feature is not supported by CX. See: https://cloud.google.com/dialogflow/es/docs/intents-actions-parameters#valfield.")
    }
    if len(p2.DefaultValue) > 0 {
        logIssue("Intent<"+intent2.DisplayName+">.Parameters<"+p2.DisplayName+">.DefaultValue",
            "This intent parameter is using a default value. CX intent parameters do not support default values, but CX page form parameters do. This parameter should probably become a form parameter.")
    }
    if p2.Mandatory {
        logIssue("Intent<"+intent2.DisplayName+">.Parameters<"+p2.DisplayName+">.Mandatory",
            "This intent parameter is marked as mandatory. CX intent parameters do not support mandatory parameters, but CX page form parameters do. This parameter should probably become a form parameter.")
    }
    for _, prompt := range p2.Prompts {
        logIssue("Intent<"+intent2.DisplayName+">.Parameters<"+p2.DisplayName+">.Prompts",
            "This intent parameter has a prompt. Use page form parameter prompts instead. Prompt: "+prompt)
    }
    if len(p2.EntityTypeDisplayName) == 0 {
        p2.EntityTypeDisplayName = "@sys.any"
        logIssue("Intent<"+intent2.DisplayName+">.Parameters<"+p2.DisplayName+">.EntityTypeDisplayName",
            "This intent parameter does not have an entity type. CX requires an entity type for all parameters..")
    }
    parameters3 = append(parameters3, &proto3.Intent_Parameter{
        Id:         p2.DisplayName,
        EntityType: convertParameterEntityType(intent2.DisplayName, p2.DisplayName, p2.EntityTypeDisplayName),
        IsList:     p2.IsList,
    })
    //fmt.Printf("Converted parameter: %+v\n", parameters3[len(parameters3)-1])
}
intent3.Parameters = parameters3

// Messages
for _, message := range intent2.Messages {
    m, ok := message.Message.(*proto2.Intent_Message_Text_)
    if ok {
        for _, t := range m.Text.Text {
            warnings := ""
            if strings.Contains(t, "#") {
                warnings += " This message may contain a context parameter reference, but CX does not support this."
            }
            if strings.Contains(t, ".original") {
                warnings += " This message may contain a parameter reference suffix of '.original', But CX only supports this for intent parameters (not session parameters)."
            }
            if strings.Contains(t, ".recent") {
                warnings += " This message may contain a parameter reference suffix of '.recent', but CX does not support this."
            }
            if strings.Contains(t, ".partial") {
                warnings += " This message may contain a parameter reference suffix of '.partial', but CX does not support this."
            }
            logIssue("Intent<"+intent2.DisplayName+">.Messages",
                "This intent has a response message. Use fulfillment instead."+warnings+" Message: "+t)
        }
    } else {
        logIssue("Intent<"+intent2.DisplayName+">.Messages",
            "This intent has a non-text response message. See the rich response message information in the migration guide.")
    }
    if message.Platform != proto2.Intent_Message_PLATFORM_UNSPECIFIED {
        logIssue("Intent<"+intent2.DisplayName+">.Platform",
            "This intent has a message with a non-default platform. See the migration guide for advice.")
    }
}

return intent3

}

// migrateEntities migrates ES entities to your CX agent
func migrateEntities(ctx context.Context) error {
var err error

// Create ES client
var client2 *v2.EntityTypesClient
options2 := []option.ClientOption{}
if len(*v2Region) > 0 {
    options2 = append(options2,
        option.WithEndpoint(*v2Region+"-dialogflow.googleapis.com:443"))
}
client2, err = v2.NewEntityTypesClient(ctx, options2...)
if err != nil {
    return err
}
defer client2.Close()
var parent2 string
if len(*v2Region) == 0 {
    parent2 = fmt.Sprintf("projects/%s/agent", *v2Project)
} else {
    parent2 = fmt.Sprintf("projects/%s/locations/%s/agent", *v2Project, *v2Region)
}

// Create CX client
var client3 *v3.EntityTypesClient
options3 := []option.ClientOption{}
if len(*v3Region) > 0 {
    options3 = append(options3,
        option.WithEndpoint(*v3Region+"-dialogflow.googleapis.com:443"))
}
client3, err = v3.NewEntityTypesClient(ctx, options3...)
if err != nil {
    return err
}
defer client3.Close()
parent3 := fmt.Sprintf("projects/%s/locations/%s/agents/%s", *v3Project, *v3Region, *v3Agent)

// Read each V2 entity type, convert, and write to V3
request2 := &proto2.ListEntityTypesRequest{
    Parent: parent2,
}
it2 := client2.ListEntityTypes(ctx, request2)
for {
    var et2 *proto2.EntityType
    et2, err = it2.Next()
    if err == iterator.Done {
        break
    }
    if err != nil {
        return err
    }
    fmt.Printf("Entity Type: %s\n", et2.DisplayName)

    if *dryRun {
        convertEntityType(et2)
        continue
    }

    request3 := &proto3.CreateEntityTypeRequest{
        Parent:     parent3,
        EntityType: convertEntityType(et2),
    }
    et3, err := client3.CreateEntityType(ctx, request3)
    entityTypeShortToLong[et3.DisplayName] = et3.Name
    if err != nil {
        return err
    }

    // ES and CX each have a quota limit of 60 design-time requests per minute
    time.Sleep(2 * time.Second)
}
return nil

}

// migrateIntents migrates intents to your CX agent
func migrateIntents(ctx context.Context) error {
var err error

// Create ES client
var client2 *v2.IntentsClient
options2 := []option.ClientOption{}
if len(*v2Region) > 0 {
    options2 = append(options2,
        option.WithEndpoint(*v2Region+"-dialogflow.googleapis.com:443"))
}
client2, err = v2.NewIntentsClient(ctx, options2...)
if err != nil {
    return err
}
defer client2.Close()
var parent2 string
if len(*v2Region) == 0 {
    parent2 = fmt.Sprintf("projects/%s/agent", *v2Project)
} else {
    parent2 = fmt.Sprintf("projects/%s/locations/%s/agent", *v2Project, *v2Region)
}

// Create CX client
var client3 *v3.IntentsClient
options3 := []option.ClientOption{}
if len(*v3Region) > 0 {
    options3 = append(options3,
        option.WithEndpoint(*v3Region+"-dialogflow.googleapis.com:443"))
}
client3, err = v3.NewIntentsClient(ctx, options3...)
if err != nil {
    return err
}
defer client3.Close()
parent3 := fmt.Sprintf("projects/%s/locations/%s/agents/%s", *v3Project, *v3Region, *v3Agent)

// Read each V2 entity type, convert, and write to V3
request2 := &proto2.ListIntentsRequest{
    Parent:     parent2,
    IntentView: proto2.IntentView_INTENT_VIEW_FULL,
}
it2 := client2.ListIntents(ctx, request2)
for {
    var intent2 *proto2.Intent
    intent2, err = it2.Next()
    if err == iterator.Done {
        break
    }
    if err != nil {
        return err
    }
    fmt.Printf("Intent: %s\n", intent2.DisplayName)
    intent3 := convertIntent(intent2)
    if intent3 == nil {
        continue
    }

    if *dryRun {
        continue
    }

    request3 := &proto3.CreateIntentRequest{
        Parent: parent3,
        Intent: intent3,
    }
    _, err := client3.CreateIntent(ctx, request3)
    if err != nil {
        return err
    }

    // ES and CX each have a quota limit of 60 design-time requests per minute
    time.Sleep(2 * time.Second)
}
return nil

}

// checkFlags checks commandline flags
func checkFlags() error {
flag.Parse()
if len(v2Project) == 0 { return fmt.Errorf(„Need to supply es-project-id flag“) } if len(v3Project) == 0 {
return fmt.Errorf(„Need to supply cx-project-id flag“)
}
if len(v2Region) == 0 { fmt.Printf(„No region supplied for ES, using default\n“) } if len(v3Region) == 0 {
return fmt.Errorf(„Need to supply cx-region-id flag“)
}
if len(v3Agent) == 0 { return fmt.Errorf(„Need to supply cx-agent-id flag“) } if len(outFile) == 0 {
return fmt.Errorf(„Need to supply out-file flag“)
}
return nil
}

// closeFile is used as a convenience for defer
func closeFile(f *os.File) {
err := f.Close()
if err != nil {
fmt.Fprintf(os.Stderr, „ERROR closing CSV file: %v\n“, err)
os.Exit(1)
}
}

func main() {
if err := checkFlags(); err != nil {
fmt.Fprintf(os.Stderr, „ERROR checking flags: %v\n“, err)
os.Exit(1)
}
ctx := context.Background()
if err := migrateEntities(ctx); err != nil {
fmt.Fprintf(os.Stderr, „ERROR migrating entities: %v\n“, err)
os.Exit(1)
}
if err := migrateIntents(ctx); err != nil {
fmt.Fprintf(os.Stderr, „ERROR migrating intents: %v\n“, err)
os.Exit(1)
}
csvFile, err := os.Create(*outFile)
if err != nil {
fmt.Fprintf(os.Stderr, „ERROR opening output file: %v“, err)
os.Exit(1)
}
defer closeFile(csvFile)
csvWriter := csv.NewWriter(csvFile)
if err := csvWriter.WriteAll(issues); err != nil {
fmt.Fprintf(os.Stderr, „ERROR writing CSV output file: %v“, err)
os.Exit(1)
}
csvWriter.Flush()
}
Tool zur Migration von Entitätstypen
Dialogflow ES-Entitätstypen und Entitätstypen für Konversations-Agenten (Dialogflow CX) sind sehr ähnlich. Daher ist dies der Datentyp, der sich am einfachsten migrieren lässt. Das Tool kopiert Entitätstypen einfach unverändert.
Toolmigration von Intents
Dialogflow ES-Intents und Intents für Conversational Agents (Dialogflow CX) unterscheiden sich stark.
Dialogflow ES-Intents sind die Bausteine des Agents. Sie enthalten Trainingsphrasen, Antworten, Kontext für die Unterhaltungssteuerung, Webhook-Konfigurationen, Ereignisse, Aktionen und Parameter für die Slot-Füllung.
Die meisten dieser Daten wurden in Conversational Agents (Dialogflow CX) in andere Ressourcen verschoben. Intents für Conversational Agents (Dialogflow CX) enthalten nur Trainingsformulierungen und Parameter. Dadurch können sie für den gesamten Agenten wiederverwendet werden. Das Tool kopiert nur diese beiden Arten von Intent-Daten in die Intents Ihrer Conversational Agents (Dialogflow CX).
Einschränkungen des Migrationstools
Das Migrationstool unterstützt Folgendes nicht:
Mega-Agents: Das Tool kann nicht aus mehreren Sub-Agents lesen, aber Sie können das Tool für jeden Sub-Agent mehrmals aufrufen.
Mehrsprachige Bots: Sie sollten das Tool so ändern, dass Sie mehrsprachige Trainingsformulierungen und Entitätseinträge erstellen können.
Überprüfung von Systementitäten für andere Sprachen als Englisch: Das Tool erstellt TODO-Elemente, wenn es Systementitäten findet, die nicht von Conversational Agents (Dialogflow CX) unterstützt werden. Dabei wird davon ausgegangen, dass Englisch die Standardsprache ist und dass die Region USA verwendet wird. Die Unterstützung von Systementitäten variiert je nach Sprache und Region. Für andere Sprachen und Regionen müssen Sie das Tool entsprechend anpassen.
Wichtige Migrationsschritte
In den folgenden Abschnitten werden die Migrationsschritte beschrieben. Sie müssen diese manuellen Schritte nicht in der angegebenen Reihenfolge ausführen. Es kann sogar sein, dass Sie diese Schritte gleichzeitig oder in einer anderen Reihenfolge ausführen müssen. Lesen Sie sich die Schritte durch und beginnen Sie mit der Planung Ihrer Änderungen, bevor Sie sie tatsächlich vornehmen.
Nachdem Sie das Migrationstool ausgeführt haben, können Sie Ihren Conversational Agents-Agent (Dialogflow CX) neu erstellen. Sie haben noch einiges an Migrationsarbeit vor sich, aber der Großteil der manuell eingegebenen Daten befindet sich jetzt im Conversational Agents (Dialogflow CX)-Agenten und in der TODO-Datei.
Conversational Agents (Dialogflow CX)-Agent erstellen
Erstellen Sie Ihren Konversations-Agenten (Dialogflow CX), falls noch nicht geschehen. Verwenden Sie dieselbe Standardsprache wie für Ihren Dialogflow ES-Agenten.
Migrationstool ausführen
So führen Sie das Tool aus:
Installieren Sie Go auf Ihrem Computer, falls Sie es noch nicht getan haben.
Erstellen Sie ein Verzeichnis für den Tool-Code mit dem Namen migrate.
Kopieren Sie den Code des Tools oben in eine Datei in diesem Verzeichnis mit dem Namen main.go.
Passen Sie den Code bei Bedarf an.
Erstellen Sie in diesem Verzeichnis ein Go-Modul. Beispiel:
go mod init migrate

Installieren Sie die Go-Clientbibliotheken für Dialogflow ES V2 und Conversational Agents (Dialogflow CX) V3:
go get cloud.google.com/go/dialogflow/apiv2
go get cloud.google.com/go/dialogflow/cx/apiv3

Sie müssen die Authentifizierung der Clientbibliothek eingerichtet haben.
Führen Sie das Tool aus und speichern Sie die Ausgabe in einer Datei:
go run main.go -es-project-id= -cx-project-id= \
-cx-region-id= -cx-agent-id= -out-file=out.csv
Fehlerbehebung beim Migrationstool
Wenn beim Ausführen des Tools Fehler auftreten, prüfen Sie Folgendes:
Fehler
Lösung
RPC-Fehler: In einem Teil einer Trainingsformulierung wird ein Parameter erwähnt, der nicht für den Intent definiert ist.
Das kann passieren, wenn Sie zuvor mit der Dialogflow ES API Intent-Parameter erstellt haben, die nicht mit den Trainingsformulierungen übereinstimmen. Um das Problem zu beheben, benennen Sie den Dialogflow ES-Parameter in der Konsole um, prüfen Sie, ob der Parameter in Ihren Trainingsphrasen richtig verwendet wird, und klicken Sie dann auf „Speichern“. Das kann auch passieren, wenn Ihre Trainingsphrasen auf nicht vorhandene Parameter verweisen.

Nachdem Sie die Fehler behoben haben, müssen Sie den Conversational Agents-Agenten (Dialogflow CX) von Intents und Entitäten befreien, bevor Sie das Migrationstool noch einmal ausführen.
Dialogflow ES-Intent-Daten in Conversational Agents (Dialogflow CX) verschieben
Das Tool migriert Intent-Trainingsphrasen und -Parameter zu Intents von Conversational Agents (Dialogflow CX). Es gibt jedoch viele andere Intent-Felder in Dialogflow ES, die manuell migriert werden müssen.
Für einen Dialogflow ES-Intent kann eine entsprechende Seite für Conversational Agents (Dialogflow CX), ein entsprechender Intent für Conversational Agents (Dialogflow CX) oder beides erforderlich sein.
Wenn eine Dialogflow ES-Intent-Übereinstimmung verwendet wird, um die Unterhaltung von einem bestimmten Unterhaltungsknoten zu einem anderen zu wechseln, sollten Sie in Ihrem Agent zwei Seiten mit Bezug zu diesem Intent haben:
Die ursprüngliche Seite mit der Intent-Route, über die zur nächsten Seite gewechselt wird: Die Intent-Route auf der ursprünglichen Seite kann Fulfillment-Nachrichten für Conversational Agents (Dialogflow CX) enthalten, die den Intent-Antworten in Dialogflow ES ähneln. Auf dieser Seite können viele Intent-Routen vorhanden sein. Solange die ursprüngliche Seite aktiv ist, können diese Intent-Routen den Dialog auf viele mögliche Pfade umleiten. Viele Dialogflow ES-Intents haben dieselbe ursprüngliche Seite für Conversational Agents (Dialogflow CX).
Die nächste Seite, also das Übergangsziel für die Intent-Route auf der ursprünglichen Seite: Die Antwort für die Conversational Agents (Dialogflow CX)-Eingabe auf der nächsten Seite kann ähnliche Antwortnachrichten wie die Dialogflow ES-Intent-Antworten enthalten.
Wenn ein Dialogflow ES-Intent erforderliche Parameter enthält, sollten Sie eine entsprechende Seite für Konversations-Agents (Dialogflow CX) mit denselben Parametern in einem Formular erstellen.
Es ist üblich, dass ein Konversations-Intent (Dialogflow CX) und eine Konversations-Seite (Dialogflow CX) dieselbe Parameterliste haben. Das bedeutet, dass ein einzelner Dialogflow ES-Intent eine entsprechende Konversations-Seite (Dialogflow CX) und einen entsprechenden Konversations-Intent (Dialogflow CX) hat. Wenn ein Intent von Conversational Agents (Dialogflow CX) mit Parametern in einer Intent-Route abgeglichen wird, wird die Unterhaltung häufig zu einer Seite mit denselben Parametern weitergeleitet. Die aus dem Intent-Abgleich extrahierten Parameter werden an Sitzungsparameter weitergegeben, die zum teilweisen oder vollständigen Ausfüllen von Formularparametern auf der Seite verfügbar sind.
Fallback-Intents und vordefinierte Folge-Intents gibt es in Conversational Agents (Dialogflow CX) nicht. Weitere Informationen finden Sie unter Vordefinierte Intents.
In der folgenden Tabelle wird beschrieben, wie Sie bestimmte Intent-Daten aus Dialogflow ES auf Ressourcen für Conversational Agents (Dialogflow CX) abbilden:
Dialogflow ES-Intent-Daten
Entsprechende Daten zu Conversational Agents (Dialogflow CX)
Maßnahme erforderlich
Trainingssätze
Intent-Trainingsformulierungen
Mit welchem Tool migriert Das Tool prüft, ob Systementitäten unterstützt werden, und erstellt TODO-Elemente für nicht unterstützte Systementitäten.
Antworten von Kundenservicemitarbeitern
Antwortnachrichten zur Auftragsausführung
Weitere Informationen finden Sie unter Agentantworten.
Kontext für die Unterhaltungssteuerung
Keine
Weitere Informationen finden Sie unter Struktur und Unterhaltungspfad steuern.
Webhook-Einstellung
Konfiguration des Webhooks für die Auftragsausführung
Weitere Informationen finden Sie unter Webhooks.
Ereignisse
Event-Handler auf Ablauf- oder Seitenebene
Weitere Informationen finden Sie unter Ereignisse.
Aktionen
Webhook-Tags für die Auftragsausführung
Weitere Informationen finden Sie unter Webhooks.
Parameter
Intent-Parameter und/oder Formularparameter der Seite
Mit dem Tool zu Intent-Parametern migriert. Wenn die Parameter erforderlich sind, erstellt das Tool TODO-Elemente, die möglicherweise auf eine Seite migriert werden. Siehe Parameter.
Parametervorschläge
Prompts für Seitenformularparameter
Weitere Informationen finden Sie unter Ausfüllen von Formularen.

Workflows erstellen
Erstellen Sie einen Ablauf für jedes allgemeine Gesprächsthema. Die Themen in den einzelnen Abläufen sollten klar voneinander abgegrenzt sein, damit die Unterhaltung nicht häufig zwischen den Abläufen hin- und herspringt.
Wenn Sie einen Mega-Agenten verwendet haben, sollte jeder Sub-Agent in einen oder mehrere Flows umgewandelt werden.
Mit einfachen Konversationspfaden beginnen
Am besten testen Sie Ihren Agenten mit dem Simulator, während Sie Änderungen vornehmen. Konzentrieren Sie sich daher zu Beginn der Unterhaltung auf die grundlegenden Konversationspfade und testen Sie, während Sie Änderungen vornehmen. Sobald diese funktionieren, können Sie zu detaillierteren Konversationsabfolgen übergehen.
Zustands-Handler auf Ablaufebene und auf Seitenebene
Überlegen Sie beim Erstellen von Status-Handlern, ob sie auf Fluss- oder Seitenebene angewendet werden sollen. Ein Handler auf Ablaufebene ist immer dann im Geltungsbereich, wenn der Ablauf (und damit jede Seite innerhalb des Ablaufs) aktiv ist. Ein Handler auf Seitenebene ist nur dann gültig, wenn die entsprechende Seite aktiv ist. Handler auf Ablaufebene ähneln Dialogflow ES-Intents ohne Eingabekontext. Handler auf Seitenebene ähneln Dialogflow ES-Intents mit Eingabekontext.
Webhook-Code
Die Webhook-Anfrage- und ‑Antworteigenschaften unterscheiden sich für Conversational Agents (Dialogflow CX). Weitere Informationen finden Sie im Abschnitt Webhooks.
Wissensconnectors
Conversational Agents (Dialogflow CX) unterstützen noch keine Knowledge Connectors. Sie müssen diese als normale Intents implementieren oder warten, bis Conversational Agents (Dialogflow CX) Knowledge Connectors unterstützt.
Agent-Einstellungen
Prüfen Sie die Einstellungen für Dialogflow ES-Kundenservicemitarbeiter und passen Sie die Einstellungen für Konversations-Agenten (Dialogflow CX) nach Bedarf an.
Hinweis :Wenn in Ihren Agent-Einstellungen kein automatisches Training konfiguriert ist, müssen Sie den Agenten manuell trainieren, bevor Sie Änderungen testen können.
TODO-Datei verwenden
Das Migrationstool gibt eine CSV-Datei aus. Die Elemente in dieser Liste beziehen sich auf bestimmte Daten, die möglicherweise Aufmerksamkeit erfordern. Importieren Sie diese Datei in eine Tabelle. Bearbeiten Sie jeden Artikel in der Tabelle und verwenden Sie eine Spalte, um den Abschluss zu kennzeichnen.
Migration der API-Nutzung
Wenn in Ihrem System die Dialogflow ES API für Laufzeit- oder Designzeitaufrufe verwendet wird, müssen Sie diesen Code aktualisieren, um die Conversational Agents (Dialogflow CX) API zu verwenden. Wenn Sie die Intent-Erkennung nur zur Laufzeit verwenden, sollte diese Aktualisierung relativ einfach sein.
Integrationen
Wenn Ihr Kundenservicemitarbeiter Integrationen verwendet, lesen Sie den Abschnitt zu Integrationen und nehmen Sie gegebenenfalls Änderungen vor.
Empfohlene Schritte für die Migration
In den folgenden Abschnitten werden die empfohlenen Migrationsschritte beschrieben.
Validierung
Mit der Agentenüberprüfung können Sie prüfen, ob Ihr Agent den Best Practices entspricht.
Test
Während Sie die oben genannten Schritte zur manuellen Migration ausführen, sollten Sie Ihren Agenten mit dem Simulator testen. Sobald Ihr Agent funktioniert, sollten Sie Unterhaltungen zwischen Ihren Dialogflow ES- und Conversational Agents (Dialogflow CX) vergleichen und prüfen, ob das Verhalten ähnlich oder verbessert ist.
Während Sie diese Unterhaltungen mit dem Simulator testen, sollten Sie Testfälle erstellen, um zukünftige Rückfälle zu vermeiden.
Umgebungen
Prüfen Sie Ihre Dialogflow ES-Umgebungen und aktualisieren Sie bei Bedarf Ihre Conversational Agents-Umgebungen (Dialogflow CX).
Training
bookmark_border
Wenn der Agent trainiert wird, verwendet Conversational Agents (Dialogflow CX) Ihre Trainingsdaten, um speziell für den Agent ein Modell für maschinelles Lernen zu erstellen. Jeder Ablauf Ihres Agents hat ein eigenes Modell. Diese Trainingsdaten bestehen hauptsächlich aus Intents, Intent-Trainingsformulierungen und Entitäten, auf die in einem Ablauf verwiesen wird. Sie werden effektiv als Datenlabels für maschinelles Lernen verwendet. Agent-Modelle werden jedoch mit Antworten auf Parameteraufforderungen, Status-Handlern, Agent-Einstellungen und vielen anderen Daten erstellt, die mit Ihrem Agent verknüpft sind.
Wenn Sie Ihren Agent ändern, sollten Sie dafür sorgen, dass der Agent trainiert wird, bevor Sie versuchen, ihn zu verwenden. Abhängig von Ihren Agent-Einstellungen kann das Training automatisch oder manuell erfolgen.
Wenn das Training über die Konsole gestartet wird, gibt der Aufgabenindikator den Status der Aufgaben an.
Automatisches Training des Ablaufentwurfs
Unter ML-Einstellungen können Sie entweder Standard-NLU oder Erweiterte NLU auswählen. Es gibt eine Einstellung, mit der das automatische Training aktiviert oder deaktiviert werden kann.
Wenn Sie das automatische Training deaktiviert haben, müssen Sie nach Abschluss der Updates ein manuelles Training ausführen.
Manuelles Entwurf des Ablauftrainings
Wenn Sie einen Ablauf manuell über die Konsole trainieren möchten, klicken Sie in den ML-Einstellungen auf die Schaltfläche NLU trainieren.
Rufen Sie die Methode train für den Typ Flow auf, um einen Ablauf manuell mit der API zu trainieren.
Zur Flow API-Referenz
Automatisches Training der Ablaufversion
Wenn eine neue Ablaufversion erstellt wird, wird die neue Ablaufversion automatisch trainiert.
Klicken Sie zum Erstellen einer neuen Ablaufversion über die Konsole im Versionsbereich auf die Schaltfläche Erstellen.
Rufen Sie zum Erstellen einer neuen Ablaufversion mit der API die Methode create für den Typ Version auf.
Version API-Referenz aufrufen
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Agent in Google Cloud bereitstellen
bookmark_border
In dieser Anleitung wird beschrieben, wie Sie einen Dialogflow-Agenten in Google Cloud bereitstellen. Gehen Sie so vor:
Agent erstellen
Erstellen Sie einen Webhook-Dienst.
Erstellen Sie eine Datenbank, die von Ihrem Webhook-Dienst verwendet wird.
Hosten Sie Ihren Dialogflow-Agenten auf einer Webseite.
Hinweise
In dieser Anleitung werden Grundkenntnisse in Dialogflow vorausgesetzt. Bevor Sie diese Anleitung ausprobieren, sollten Sie Folgendes tun:
Dialogflow CX-Grundlagen
Einrichtungsschritte ausführen
Führen Sie die Schritte in der Kurzanleitung Agent erstellen aus, um ein grundlegendes Verständnis der Konzepte zum Erstellen von Agents zu erhalten.
Kosten
In dieser Anleitung werden die folgenden kostenpflichtigen Google Cloud-Produkte verwendet:
Produkt
Preisinformationen
Dialogflow
Für jede Textanfrage, die an Dialogflow gesendet wird, fällt eine geringe Gebühr an. Wenn Ihr Agent nicht verwendet wird, fallen keine Kosten an. Möglicherweise können Sie auch eine kostenlose Testversion nutzen. Weitere Informationen finden Sie unter Dialogflow-Preise.
Cloud Run-Funktionen
Funktionsaufrufe sind bei einer geringen Nutzung kostenlos. Darüber hinaus fallen Gebühren an. Wenn Ihre Funktion nicht verwendet wird, fallen keine Kosten an. Weitere Informationen finden Sie unter Cloud Run-Funktionen – Preise.
Spanner
Für die Wartung einer Instanz, die Speichernutzung und die Netzwerknutzung fallen Gebühren an. Wenn Ihre Datenbankinstanz nicht verwendet wird, werden Ihnen die Kosten für die Instanz und den Speicherplatz in Rechnung gestellt. Weitere Informationen finden Sie unter Spanner-Preise.
App Engine
Für eine geringe Nutzung gibt es eine kostenlose Stufe. Wird das kostenlose Kontingent überschritten, fallen Gebühren an. Wenn Ihre Instanz nicht verwendet wird, fallen keine Kosten an. Weitere Informationen finden Sie unter App Engine-Preise.

Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Webhook erstellen
bookmark_border
In diesem Leitfaden erfahren Sie, wie Sie einen Webhook verwenden, damit Ihr Agent dynamischer sein kann. Cloud Functions werden aufgrund ihrer Einfachheit zum Hosten des Webhooks verwendet. Es gibt jedoch viele andere Möglichkeiten, einen Webhook-Dienst zu hosten. Im Beispiel wird auch die Programmiersprache Go verwendet. Sie können jedoch jede von Cloud Functions unterstützte Sprache verwenden. Sie müssen den Code für diesen Leitfaden nicht bearbeiten.
Der Beispiel-Webhook-Code führt Folgendes aus:
Liest Parameterwerte aus der Webhook-Anfrage.
Schreibt einen Parameterwert in die Webhook-Antwort.
Stellt eine Textantwort in der Webhook-Antwort bereit.
Hinweise
Wenn Sie keine Webhooks verwenden möchten, können Sie diesen Schnellstart überspringen.
Bevor Sie diese Anleitung lesen, sollten Sie mit Folgendem vertraut sein:
Grundlagen von Abläufen
Einrichtungsschritte ausführen
Führen Sie die Schritte in der Kurzanleitung Agent mithilfe von Flows erstellen aus. In den folgenden Schritten wird derselbe Agent weiterverwendet. Wenn Sie diesen Agent nicht mehr haben, können Sie ihn herunterladen und wiederherstellen.
Cloud Functions-Funktion erstellen
Cloud Functions können mit der Google Cloud Console erstellt werden (Dokumentation ansehen, Console öffnen). So erstellen Sie eine Funktion für diesen Leitfaden:
Es ist wichtig, dass sich der Conversational Agents (Dialogflow CX)-Agent und die Funktion im selben Projekt befinden. Das ist die einfachste Möglichkeit, Conversational Agents (Dialogflow CX) sicheren Zugriff auf Ihre Funktion zu gewähren. Rufen Sie die Projektauswahl auf, um Ihr Projekt auszuwählen.
Zur Übersichtsseite zu Cloud Functions
Klicken Sie auf Funktion erstellen und legen Sie die folgenden Felder fest:
Umgebung: 1. Generation
Funktionsname: shirts-agent-webhook
Region: Wenn Sie für Ihren Kundenservicemitarbeiter eine Region angegeben haben, verwenden Sie dieselbe Region.
HTTP-Triggertyp: HTTP
URL: Klicken Sie hier auf die Schaltfläche „Kopieren“ und speichern Sie den Wert. Sie benötigen diese URL, wenn Sie den Webhook konfigurieren.
Authentifizierung: Authentifizierung verlangen
HTTPS erforderlich: angeklickt
Klicken Sie auf Speichern.
Klicken Sie auf Weiter. Sie benötigen keine speziellen Laufzeit-, Build-, Verbindungs- oder Sicherheitseinstellungen.
Legen Sie die Werte für die folgenden Felder fest:
Laufzeit: Wählen Sie die neueste Go-Laufzeit aus.
Quellcode: Inline-Editor
Einstiegspunkt: HandleWebhookRequest
Ersetzen Sie den Code durch Folgendes:
// Package cxwh contains an example Dialogflow CX webhook
package cxwh

import (
„encoding/json“
„fmt“
„log“
„net/http“
)

type fulfillmentInfo struct {
Tag string json:"tag"
}

type sessionInfo struct {
Session string json:"session"
Parameters map[string]interface{} json:"parameters"
}

type text struct {
Text []string json:"text"
}

type responseMessage struct {
Text text json:"text"
}

type fulfillmentResponse struct {
Messages []responseMessage json:"messages"
}

// webhookRequest is used to unmarshal a WebhookRequest JSON object. Note that
// not all members need to be defined–just those that you need to process.
// As an alternative, you could use the types provided by the Dialogflow protocol buffers:
// https://pkg.go.dev/google.golang.org/genproto/googleapis/cloud/dialogflow/cx/v3#WebhookRequest
type webhookRequest struct {
FulfillmentInfo fulfillmentInfo json:"fulfillmentInfo"
SessionInfo sessionInfo json:"sessionInfo"
}

// webhookResponse is used to marshal a WebhookResponse JSON object. Note that
// not all members need to be defined–just those that you need to process.
// As an alternative, you could use the types provided by the Dialogflow protocol buffers:
// https://pkg.go.dev/google.golang.org/genproto/googleapis/cloud/dialogflow/cx/v3#WebhookResponse
type webhookResponse struct {
FulfillmentResponse fulfillmentResponse json:"fulfillmentResponse"
SessionInfo sessionInfo json:"sessionInfo"
}

// confirm handles webhook calls using the „confirm“ tag.
func confirm(request webhookRequest) (webhookResponse, error) {
// Create a text message that utilizes the „size“ and „color“
// parameters provided by the end-user.
// This text message is used in the response below.
t := fmt.Sprintf(„You can pick up your order for a %s %s shirt in 5 days.“,
request.SessionInfo.Parameters[„size“],
request.SessionInfo.Parameters[„color“])

// Create session parameters that are populated in the response.
// The "cancel-period" parameter is referenced by the agent.
// This example hard codes the value 2, but a real system
// might look up this value in a database.
p := map[string]interface{}{"cancel-period": "2"}

// Build and return the response.
response := webhookResponse{
    FulfillmentResponse: fulfillmentResponse{
        Messages: []responseMessage{
            {
                Text: text{
                    Text: []string{t},
                },
            },
        },
    },
    SessionInfo: sessionInfo{
        Parameters: p,
    },
}
return response, nil

}

// handleError handles internal errors.
func handleError(w http.ResponseWriter, err error) {
w.WriteHeader(http.StatusInternalServerError)
fmt.Fprintf(w, „ERROR: %v“, err)
}

// HandleWebhookRequest handles WebhookRequest and sends the WebhookResponse.
func HandleWebhookRequest(w http.ResponseWriter, r *http.Request) {
var request webhookRequest
var response webhookResponse
var err error

// Read input JSON
if err = json.NewDecoder(r.Body).Decode(&request); err != nil {
    handleError(w, err)
    return
}
log.Printf("Request: %+v", request)

// Get the tag from the request, and call the corresponding
// function that handles that tag.
// This example only has one possible tag,
// but most agents would have many.
switch tag := request.FulfillmentInfo.Tag; tag {
case "confirm":
    response, err = confirm(request)
default:
    err = fmt.Errorf("Unknown tag: %s", tag)
}
if err != nil {
    handleError(w, err)
    return
}
log.Printf("Response: %+v", response)

// Send response
if err = json.NewEncoder(w).Encode(&response); err != nil {
    handleError(w, err)
    return
}

}
Klicken Sie auf Bereitstellen.
Warten Sie, bis die Statusanzeige anzeigt, dass die Funktion erfolgreich bereitgestellt wurde. Sehen Sie sich in der Zwischenzeit den Code an, den Sie gerade bereitgestellt haben. Codekommentare beschreiben wichtige Details.
Webhook erstellen
Nachdem der Webhook als Cloud-Funktion vorhanden ist, verknüpfen Sie ihn mit Ihrem Agenten. So erstellen Sie den Webhook für Ihren Agenten:
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Webhooks.
Klicken Sie auf Erstellen.
Füllen Sie die folgenden Felder aus:
Anzeigename: shirts-agent-webhook
Webhook-URL: Geben Sie die Webhook-URL an, die Sie beim Erstellen der Funktion gespeichert haben.
Untertyp: Standard.
Für alle anderen Felder werden die Standardwerte verwendet.
Klicken Sie auf Speichern.
Webhook verwenden
Nachdem der Webhook für den Kundenservicemitarbeiter verfügbar ist, verwenden Sie ihn bei der Auftragsausführung. Die Seite Bestellbestätigung enthält eine Eingabeauftragsausführung, die derzeit eine statische Textantwort hat. So aktualisierst du die Auftragsausführung, damit dein Webhook verwendet wird:
Wählen Sie den Tab Erstellen aus.
Klicken Sie auf die Seite Bestellbestätigung, um sie in der Agent Builder-Grafik zu maximieren.
Klicken Sie auf der Seite auf das Feld Entry Fulfillment (Eintragsausführung), um den Bereich für die Auftragsausführung zu öffnen.
Löschen Sie die vorhandene Textantwort unter der Überschrift Kundenservicemitarbeiter sagt. Wenn Sie den Mauszeiger auf den Text bewegen, wird die Schaltfläche „Löschen“ delete angezeigt.
Klicken Sie auf Webhook aktivieren.
Wählen Sie im Drop-down-Menü Webhook die Option shirts-agent-webhook aus.
Geben Sie im Feld Tag den Wert confirm ein.
Klicken Sie auf Speichern.
Schließen Sie den Bereich für die Auftragsausführung.

Der bereitgestellte Webhook-Code sendet eine Antwort, durch die ein Parameter namens cancel-period erstellt wird. Aktualisieren Sie den Agenten, damit er in der endgültigen Antwort des Kundenservicemitarbeiters für dieselbe Seite Bestellbestätigung auf diesen Parameter verweist:
Klicken Sie auf die Bedingung route, die mit einer true-Bedingung gekennzeichnet ist, um das Steuerfeld „Route“ zu öffnen.
Scrollen Sie im Steuerfeld für die Route nach unten zum Abschnitt Ausführung und fügen Sie unter der Überschrift Kundenservicemitarbeiter sagt die folgende Textantwort hinzu: You can cancel your order within $session.params.cancel-period days. Goodbye.
Klicken Sie auf Speichern.
Schließen Sie den Bereich „Route“.

Agent im Simulator testen
Ihr Agent und Webhook können jetzt mit dem Simulator getestet werden:
Klicken Sie auf Test-Kundenservicemitarbeiter.
Geben Sie I want to buy a large red shirt ein und drücken Sie die Eingabetaste.
Da Sie sowohl Größe als auch Farbe angegeben haben, hat der Kundenservicemitarbeiter alles, was er zum Erstellen einer T-Shirt-Bestellung benötigt. Daher wird direkt zur Seite Bestellbestätigung weitergeleitet.

Im Folgenden werden die Antworten des Kundenservicemitarbeiters beschrieben:
Antwort
Erklärung
Okay, starten wir einen neuen Auftrag.
Als die Seite Neue Bestellung aktiv wurde, wurde die Auftragsausführung aufgerufen. Die Antwort wurde von dieser Auftragsausführung ausgelöst.
Sie haben ein großes rotes Hemd ausgewählt.
Wenn alle Formularparameter für die Seite Neue Bestellung angegeben wurden, wird die Bedingungsroute aufgerufen, die das Ausfüllen des Formulars prüft. Die Antwort wurde von der Auftragsausführung für diese Route ausgelöst. Diese Route führt ebenfalls zur Seite Bestellbestätigung.
Sie können Ihre Bestellung für ein rotes Hemd in Größe L in 5 Tagen abholen.
Die Auftragsausführung für die Seite Bestellbestätigung ruft den Webhook auf. Siehe Funktion confirm im Webhook-Code. Diese Funktion erstellt diese Textantwort und verwendet dabei die in der Webhook-Anfrage angegebenen Parameter.
Sie können Ihre Bestellung innerhalb von zwei Tagen stornieren. Auf Wiedersehen.
Die Seite Bestellbestätigung enthält eine Bedingungsroute mit einer Bedingung, die immer wahr ist. Diese Antwort wird durch die Auftragsausführung für diese Route ausgelöst. Hinweis: In der Antwort wird der Parameter verwendet, der vom Webhook in der Webhook-Antwort festgelegt wurde.

Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Versionen und Umgebungen
bookmark_border
Sie können mehrere Versionen Ihrer Agent-Abläufe, Playbooks und Tools erstellen und in separaten Bereitstellungsumgebungen bereitstellen.
Wenn Sie einen Ablauf, ein Playbook oder ein Tool bearbeiten, bearbeiten Sie den Entwurf. Sie können den Entwurf jederzeit als Version speichern. Eine Version ist ein unveränderlicher Snapshot Ihrer Ablauf-, Playbook- oder Tooldaten und der zugehörigen Kundenservicemitarbeiterdaten. Bei Abläufen sind das Intents, Entitäten, Webhooks, Seiten und Routengruppen. Bei Playbooks sind dies nur Beispiele.
Wenn Sie einen Entwurf speichern, wird er in der Standardumgebung bereitgestellt. Wenn Sie spezifische Versionen erstellen, können Sie diese in benutzerdefinierten Umgebungen bereitstellen. Sie können eine Vielzahl von benutzerdefinierten Umgebungen erstellen, z. B.:
testen
Entwicklung
Produktion
Außerdem können Sie umgebungsspezifische Webhooks erstellen, um Ihre Produktionsumgebung von Entwicklungs- und Testumgebungen zu isolieren.
Best Practices für Produktionstraffic
Verwenden Sie immer Versionen für Produktions-Traffic
Ein Entwurf wird jedes Mal aktualisiert, wenn ein Entwickler in Ihrem Team eine Änderung vornimmt. Es kann leicht passieren, dass ein Ablaufentwurf aus Versehen unterbrochen wird, insbesondere wenn mehrere Personen Schreibzugriff auf den Agent haben. Darüber hinaus kann ein kürzlich bearbeiteter Entwurf möglicherweise nicht mit dem trainierten Modell übereinstimmen, da das Training verzögert sein kann oder eine manuelle Ausführung erfordert.
Sie sollten daher immer Versionen für Ihren Produktions-Traffic verwenden. Ressourcenentwürfe sollten getestet werden, bevor sie zu Produktionsversionen hochgestuft werden. Sie können ein Rollback zu einer vorherigen Version durchführen, falls Probleme auftreten.
Immer umgebungsspezifische Webhooks verwenden
Wenn Sie Änderungen an Ihrem Kundenservicemitarbeiter vornehmen, sind häufig abhängige Änderungen an Ihrem Webhook-Code erforderlich. Bei der Entwicklung und dem Testen dieser Änderungen sollten Sie Folgendes beachten:
So testen Sie die Agent-Updates anhand der Webhook-Code-Updates.
Sie sollten Ihren Webhook-Code erst dann in der Produktionsumgebung bereitstellen, wenn Sie die Tests abgeschlossen haben.
Mit umgebungsspezifischen Webhooks lassen sich beide Ziele erreichen.
Mögliche Fehler beim Ändern der Versionen
Wenn Sie eine Version in Ihrer Produktionsumgebung ändern, während Sitzungen aktiv sind, kann das zu Kundenservicemitarbeiterfehlern bei einigen aktiven Sitzungen führen. Diese Fehler können auftreten, wenn die vorherige und die neue Version nicht miteinander übereinstimmen und dadurch der Sitzungsstatus gestört wird. Daher sollten Sie die Versionen während der Ruhezeit oder außerhalb der Stoßzeiten ändern.
Version in den Entwurf laden
Sie können eine Version jederzeit als Entwurf laden, damit sie bearbeitet und von der Standardumgebung verwendet werden kann.
Durch das Laden einer Ablaufversion als Entwurf können mehrere Ressourcen in einem Agent aktualisiert werden, einschließlich Ressourcen auf Agent-Ebene wie Intents und Entitäten. Wenn Sie eine Version mit der Konsole oder der API als Entwurf laden, können Sie wählen, ob Ressourcen auf Agent-Ebene überschrieben werden sollen.
Wenn Sie eine Playbook-Version im Entwurf wiederherstellen, wird das vorhandene Playbook im Entwurf und seine Beispiele überschrieben. Wenn Sie ein Tool wiederherstellen, wird das vorhandene Tool im Entwurf überschrieben.
Versionen verwalten
So verwalten Sie Ihre Versionen:
Console
API
So listen Sie die aktuellen Versionen für einen Ablauf auf:
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud Projekt aus.
Wählen Sie den Agent aus.
Klicken Sie auf den Tab Gemeinsam genutzte Ressourcen.
Klicken Sie auf Versionen.
Die Agent-Abläufe werden aufgeführt. Wählen Sie eine Antwort aus.
Die Versionen für den ausgewählten Ablauf werden aufgelistet.
So listen Sie die aktuellen Versionen für ein Playbook auf:
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud Projekt aus.
Wählen Sie den Agent aus.
Playbook auswählen
Klicken Sie auf Versionsverlauf.
Klicken Sie auf Versionsverlauf ansehen.
Die Versionen für das ausgewählte Playbook werden aufgelistet.
So listen Sie die aktuellen Versionen für ein Tool auf:
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud Projekt aus.
Wählen Sie den Agent aus.
Tool auswählen
Klicken Sie auf Versionsverlauf.
Klicken Sie auf Versionsverlauf ansehen.
Die Versionen für das ausgewählte Tool werden aufgelistet.
Für jede Ressource werden folgende Informationen angezeigt:
Anzeigename: Der Anzeigename der Version.
Versions-ID: Die ID der Version.
NLU-Typ: Der NLU-Typ der Ablaufversion.
Zeitstempel der Erstellung: Datum und Uhrzeit der Erstellung der Version.
Status: Der Trainingsstatus. Eine Ablaufversion kann erst verwendet werden, wenn dafür der Status Bereit gilt.
Klicken Sie zum Erstellen einer neuen Version auf die Schaltfläche Erstellen und geben Sie den Anzeigenamen und die Beschreibung für die Version an.
So laden Sie eine bestimmte Ablaufversion als Entwurf:
Bewegen Sie den Mauszeiger auf eine Versionszeile.
Klicken Sie auf die Optionsschaltfläche more_vert.
Klicken Sie auf die Option In Entwurf laden.
Dabei ist eine Option zum Überschreiben der Daten auf Agent-Ebene beim Laden verfügbar.
So löschen Sie eine bestimmte Ablaufversion:
Bewegen Sie den Mauszeiger auf eine Versionszeile.
Klicken Sie auf die Optionsschaltfläche more_vert.
Klicken Sie auf die Option Version löschen.
Ablaufversionen vergleichen
Hinweis :Versionen vergleichen ist auf eine Antwortgröße von 2 MB begrenzt. Verwenden Sie die REST API-Methode, um diese Einschränkung zu umgehen.
Nachdem Sie Ablaufversionen erstellt haben, können Sie mit dem Tool Versionen vergleichen einen direkten Vergleich zwischen den Ablaufversionen oder der Entwurfsversion abrufen. Diese Funktion ist für Playbooks nicht verfügbar. So vergleichen Sie Versionen:
Console
API
Bewegen Sie den Mauszeiger auf eine Versionszeile.
Klicken Sie auf die Optionsschaltfläche more_vert.
Klicken Sie auf die Option Versionen vergleichen.
Wählen Sie eine andere Ablaufversion oder einen Ablaufentwurf zum Vergleich aus.
Ein direkter Vergleich wird angezeigt.
Umgebungen verwalten
So verwalten Sie Agent-Umgebungen:
Console
API
So listen Sie die aktuellen Umgebungen für einen Agent auf:
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud Projekt aus.
Wählen Sie den Agent aus.
Klicken Sie auf den Tab Gemeinsam genutzte Ressourcen.
Klicken Sie auf Umgebungen.
Die Agent-Umgebungen werden aufgelistet.
Klicken Sie zum Erstellen einer neuen Umgebung auf die Schaltfläche Erstellen und geben Sie die erforderlichen Informationen an.
Zum Auswählen von Ablauf-, Playbook- und Toolversionen und zum Konfigurieren einer Umgebung klicken Sie auf eine Umgebung und geben dort Informationen ein.
Klicken Sie rechts neben einer Umgebung in der Liste auf die Schaltfläche history „Verlauf“, um den Änderungsverlauf der Umgebung anzuzeigen.
Klicken Sie zum Kopieren des Namens der Umgebungsressource, die die Umgebungs-ID enthält, auf die Schaltfläche content_copy „Kopieren“ rechts neben der relevanten Umgebung in der Liste.
Klicken Sie zum Löschen einer Umgebung in der Liste rechts neben der relevanten Umgebung auf die Schaltfläche delete „Löschen“.
Umgebung für Sitzungsaufrufe angeben
Mit dem Console-Simulator oder der API können Sie beim Aufrufen von Laufzeitsitzungen eine Umgebung angeben. Ist keine Umgebung angegeben, wird die Standardumgebung verwendet.
Console
API
Wenn Sie den Konsolensimulator verwenden, wählen Sie die Option Agent in Umgebung testen und dann eine Umgebung aus.
Ablaufversionen für Sitzungsaufrufe angeben
Mit dem Console-Simulator oder der API können Sie beim Aufrufen von Laufzeitsitzungen eine Reihe von Ablaufversionen angeben. Die ausgewählten Ablaufversionen müssen nicht unbedingt in einer Umgebung referenziert werden.
Console
API
Wenn Sie den Konsolensimulator verwenden, wählen Sie die Option Agent mit bestimmten Ablaufversionen testen und dann die Ablaufversionen aus.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Auftragsausführungen
bookmark_border
Damit der Agent an der Unterhaltung teilnehmen kann, muss der Agent auf den Endnutzer mit einer Antwort auf eine Frage, einer Anfrage nach Informationen oder dem Beenden der Sitzung antworten. Ihr Agent muss sich möglicherweise auch mit Ihrem Dienst in Verbindung setzen, um dynamische Antworten zu generieren oder Aktionen für eine weitere Unterhaltungsrunde auszuführen. Auftragsausführung wird für all dies verwendet.
Eine Auftragsausführung kann folgende Elemente enthalten:
Statische Antwortnachrichten
Webhook-Aufrufe nach dynamischen Antworten und/oder Aktionen
Parametervoreinstellungen zum Festlegen oder Überschreiben von Parameterwerten
Während der Unterhaltungsrunde eines Agents ist es möglich (und manchmal gewünscht), mehrere Auftragsausführungen aufzurufen, von denen jede eine Antwort erzeugen kann. Conversational Agents (Dialogflow CX) speichern diese Antworten in einer Antwortwarteschlange. Nach Abschluss der Unterhaltungsrunde des Agents sendet Conversational Agents (Dialogflow CX) die sortierten Antworten an den Endnutzer.
Anwendungsfälle für Auftragsausführungen
Die Auftragsausführung wird überall dort verwendet, wo Antwortnachrichten benötigt werden:
Auftragsausführung für Seiteneingaben
Routen
Event-Handler
Erstaufforderungen für Formulare
Handler von erneuten Eingabeaufforderungen für Formulare
Für jeden dieser Anwendungsfälle wird in der Konsole das Bearbeitungsfenster für die Auftragsausführung geöffnet.

Statische Antwortnachrichten (Dialogoptionen)
Statische Antwortnachrichten sind Agent-Antworten, die Sie während der Entwicklung definieren. Sie definieren sie beim Erstellen der Auftragsausführung. Während der Laufzeit werden diese Antworten der Antwortwarteschlange hinzugefügt.
Es gibt mehrere Antwortnachrichtentypen, die in Unterabschnitten weiter unten beschrieben werden. Bei Verwendung der Konsole enthalten Auftragsausführungsfelder eine erste Textantwort-Karte. Sie können aber auch auf Dialogfeld hinzufügen klicken, um weitere Karten für andere Antwortnachrichtentypen hinzuzufügen.
Text
SMS-Antwortnachrichten senden Text an den Endnutzer. Wenn Ihre API-Aufrufe zur Intent-Erkennung oder Integration die Sprachsynthese verwenden, wird dieser Text zur Generierung der Audioinhalte genutzt. In diesem Fall kann für den bereitgestellten Text optional die Speech Synthesis Markup Language (SSML) verwendet werden.
Sie können mehrere Textantwortkarten und mehrere Textantworten auf jeder Karte definieren. Wenn Sie mehrere Karten definieren, werden diese zur Laufzeit zu einer einzelnen Antwort verkettet. Wenn Sie mehrere Antworten innerhalb einer Karte definieren, wird eine der Nachrichten auf der Karte nach dem Zufallsprinzip ausgewählt.
Solche Textnachrichten können Parameterreferenzen und Inline-Systemfunktionen enthalten.
Benutzerdefinierte Nutzlast
Einige Integrationen unterstützen benutzerdefinierte Nutzlastantworten, um komplexe Antworten zu verarbeiten. Diese benutzerdefinierten Nutzlasten werden in einem JSON-Format bereitgestellt, das in der Integrationsdokumentation definiert ist. Ein Beispiel dafür ist das benutzerdefinierte Dialogflow CX Messenger-Nutzlastformat.
Sie können Parameterreferenzen in den JSON-Code Ihrer benutzerdefinierten Nutzlast aufnehmen. Sie sollten als JSON-Stringwerte behandelt werden. Umschließen Sie sie daher mit doppelten Anführungszeichen. Beispiel:
{
„someField“: „$session.params.date“
}

Hinweis :Benutzerdefinierte Nutzlast-JSON-Dateien dürfen maximal 24 Ebenen haben.
Sie können auch eine benutzerdefinierte Nutzlast an selbst entwickelte Integrationen senden. Diese wird nicht von Conversational Agents (Dialogflow CX) verarbeitet, sondern muss in Ihrer eigenen Geschäftslogik behandelt werden.
Weitere Informationen finden Sie unten im Abschnitt Benutzerdefinierte Nutzlastvorlagen.
Übergabe an Kundenservicemitarbeiter
Diese Antwort signalisiert dem Aufrufer der API zur Intent-Erkennung, dass die Unterhaltung an einen menschlichen Mitarbeiter übergeben werden soll. Conversational Agents (Dialogflow CX) verwenden dieses Signal nur, um Unterhaltungen zu identifizieren, die zu Messzwecken übergeben werden. Der Sitzungsstatus wird nicht geändert. Ihr System oder Ihre Integration kann dieses Signal verwenden, um die erforderlichen Aktionen zur Übergabe der Unterhaltung auszuführen. Conversational Agents (Dialogflow CX) zwingt diesen Daten keine Struktur auf, sodass Sie jede für Ihr System geeignete Struktur wählen können.
Metadaten für erfolgreiche Unterhaltungen
Diese Antwort signalisiert dem Aufrufer der API zur Intent-Erkennung, dass die Unterhaltung mit dem Conversational Agents (Dialogflow CX)-Agent erfolgreich war. Conversational Agents (Dialogflow CX) verwenden dieses Signal nur, um Unterhaltungen zu identifizieren, die zu Messzwecken erfolgreich waren. Der Sitzungsstatus wird nicht geändert. Ihr System oder Ihre Integration kann dieses Signal verwenden, um die erforderlichen Aktionen auszuführen. Conversational Agents (Dialogflow CX) zwingt diesen Daten keine Struktur auf, sodass Sie jede für Ihr System geeignete Struktur wählen können.
Zuvor aufgenommenes Audio abspielen
Diese Antwort spielt eine Audiodatei für Integrationen ab, die dieses Feature unterstützen.
Die Anforderungen an das Audiodateiformat können sich je nach Integration unterscheiden. Weitere Informationen finden Sie beispielsweise in den Anforderungen für das Dialogflow CX-Telefon-Gateway.
Bei Telefonieintegrationen von Partnern muss der Partner auf die URL der Audiodatei zugreifen können. Auf eine öffentlich verfügbare URL, z. B. eine öffentliche Datei in Cloud Storage, kann der Partner jederzeit zugreifen. Der Partner kann auch eingeschränkten Zugriff auf Audiodateien gewähren. Weitere Informationen finden Sie in der Partnerdokumentation.
Audiotext ausgeben
Diese Antwort ähnelt der Text-Antwort, gilt jedoch nur für die Sprachsynthese. Wenn der Agent sowohl Text- als auch Sprachsitzungen verarbeiten kann, können Sie mithilfe von eindeutigen Text- und Audiotextausgabe-Antworten eine andere Nutzererfahrung für Text bzw. Sprache generieren. Wenn eine Audiotextausgabe für eine Sprachsitzung bereitgestellt wird, werden die Antworten für Nur-Text ignoriert.
Wenn Ihr Agent sowohl Text- als auch Sprachsitzungen verarbeitet und Sie dieselben Antwortnachrichten wünschen, verwenden Sie nur Textantworten für Text- und Sprachsitzungen.
Der Ausgabe-Audiotext wird ähnlich wie Textantworten verkettet. Wenn die Ausgabe-Audiotextantworten eine Mischung aus Text und SSML sind, wird das verkettete Ergebnis als SSML behandelt. Der Agent-Designer sollte idealerweise konsistent Text oder SSML verwenden.
Bedingte Antwort
Dieser Antworttyp wird für bedingte Antworten verwendet. Das allgemeine Format ist:
if [condition]
[response]
elif [condition]
[response]
elif [condition]
[response]
else
[response]
endif

wobei
[condition] das gleiche Format ist, das auch für Routenbedingungen genutzt wird.
[response] ist eine Textantwort
Die Sperren elif und else sind optional.
Beispiel:
if $session.params.user-age >= 21
Ok, you may enter.
else
Sorry, you cannot enter.
endif

Sowohl [condition] als auch [response] können Inline-Systemfunktionen verwenden, um dynamische Werte während Unterhaltungen zu generieren. Weitere Informationen finden Sie in den Referenzen zu Systemfunktionen und Routenbedingungen. Die [condition] wird basierend auf dem Sitzungsstatus zu Beginn der Ausführung aufgelöst. Wenn [response] vom Sitzungsstatus abhängt, wird es am Ende der Ausführung anhand des aktualisierten Sitzungsstatus aufgelöst.
Bei mehrsprachigen Agents ist [condition] für alle Sprachen üblich, während [response] sprachspezifisch ist. Wenn Sie [condition] für eine Sprache in der Konsole ändern, wird dieser Teil in allen Sprachen des Agents aktualisiert. Da es zu einer neuen Bedingung wird, wird [response] für alle Sprachen gelöscht, außer der Sprache, die Sie beim Aktualisieren von [condition] ausgewählt haben.
Telefonieweiterleitungsanruf
Hinweis: Die Anrufweiterleitung ist derzeit nur für das Dialogflow CX-Telefonie-Gateway verfügbar.
Für einige Telefonieintegrationen können Sie eine US-amerikanische Telefonnummer für die Anrufweiterleitung angeben. Zur Laufzeit, wenn der virtuelle Conversational Agents-Agent (Dialogflow CX) eine Auftragsausführung mit Anrufweiterleitung aufruft, wird der Aufruf an die angegebene Anzahl weitergeleitet und die Verarbeitung des virtuellen Kundenservicemitarbeiters gesperrt.
Kanalspezifische Antwortnachrichten
Beim Definieren der Auftragsausführung können Sie kanalspezifische Antwortnachrichten erstellen. So können Sie gezielte Antworten für Textchat, Sprachanrufe, SMS, bestimmte Integrationen, die Kanäle unterstützen, usw. erstellen. Antwortnachrichten, die nicht für einen bestimmten Kanal gelten, werden als Standardantwortnachrichten bezeichnet.
Bei der Laufzeit wählt Conversational Agents (Dialogflow CX) entweder die Standardantwortnachricht oder eine kanalspezifische Antwortnachricht aus, wenn in einer Intent-Erkennungsanfrage ein Kanal angegeben ist. Es empfiehlt sich, Standardantwortnachrichten zu definieren, auch wenn Sie kanalspezifische Antwortnachrichten verwenden. Die Standardantwortnachrichten können als Fallback dienen, wenn Ihr System keinen gültigen Kanal angibt.
Ein Kanalname ist ein benutzerdefiniertes Feld, das Sie auf beliebigen Text festlegen können. Wenn Sie die Conversational Agents API (Dialogflow CX) direkt für Laufzeitaufrufe verwenden, können Sie beliebige Kanalnamen verwenden. Wenn Sie eine vorhandene Integration verwenden, müssen Sie die Kanalnamen verwenden, die von der Integration erkannt werden.
Kanalspezifische Antwortnachrichten während der Entwicklung festlegen
So geben Sie kanalspezifische Antwortnachrichten für die Auftragsausführung an, wenn Sie die Console verwenden:
Klicken Sie auf Kanal hinzufügen, nachdem Sie die Standardantwortnachrichten hinzugefügt haben. Über die Benutzeroberfläche können Sie kanalspezifische Antwortnachrichten hinzufügen. Klicke noch einmal auf Channel hinzufügen, um einen anderen Channel hinzuzufügen.
So gibst du bei der Verwendung der API kanalspezifische Antwortnachrichten für die Auftragsausführung an:
Legen Sie für jede Antwortnachricht das Feld Fulfillment.messages[i].channel auf den gewünschten Channel fest. Wenn dieses Feld nicht festgelegt ist, ist die Antwort eine Standardantwort.
Kanalspezifische Antwortnachrichten zur Laufzeit verwenden
Hinweis: Wenn Sie eine vorhandene Integration verwenden, die Kanäle unterstützt, werden die folgenden Schritte bei der Integrationsimplementierung ausgeführt.
Wenn Sie eine kanalspezifische Antwortnachricht erhalten möchten, muss der Kanal in der Anfrage zum Erkennen von Intents angegeben werden. Weitere Informationen finden Sie im Feld queryParams.channel der Methode detectIntent des Typs Sessions.
Zur API-Referenz-Sitzung
Wenn in einer Anfrage kein Kanal definiert ist oder bei der Auftragsausführung kein übereinstimmender Kanal gefunden wird, wird die Standardantwort von Conversational Agents (Dialogflow CX) zurückgegeben.
Vorlagen für benutzerdefinierte Nutzlasten
Wenn Sie häufig benutzerdefinierte Nutzlasten verwenden, sollten Sie Vorlagen für benutzerdefinierte Nutzlasten verwenden. Benutzerdefinierte Payloads sind manchmal groß und komplex. Mithilfe von Vorlagen lässt sich der Prozess zum Erstellen von Bots vereinfachen.
Sie können diese Vorlagen in den Einstellungen des Agents angeben. Sie stehen dann zur Auswahl, wenn Sie die Auftragsausführung für den Agenten erstellen.
Beispielsweise können die JSON-Nutzlasten für die Schaltflächen „Ja“ und „Nein“ als benutzerdefinierte Nutzlastvorlagen definiert werden. Wenn Sie eine Auftragsausführung erstellen, für die diese Schaltflächen erforderlich sind, müssen Sie beim Erstellen der Auftragsausführung nur die Vorlage auswählen.
Wenn Sie eine Vorlage für eine benutzerdefinierte Fulfillment-Nutzlast auswählen, wird der Inhalt der Vorlage in die Nutzlast eingefügt. Sie können die Nutzlast dann nach Bedarf bearbeiten.
Wenn Sie eine Vorlage ändern, werden die Änderungen nicht automatisch auf alle Fulfillment-Nutzlastdaten übertragen, auf die verwiesen wird.
Informationen zum Erstellen einer benutzerdefinierten Nutzlastvorlage finden Sie unter Allgemeine Einstellungen für den Kundenservicemitarbeiter.
Wenn Sie beim Erstellen einer Auftragsausführung eine benutzerdefinierte Payload-Vorlage auswählen möchten, klicken Sie auf Vorlage auswählen.
Webhook-Aufrufe
Wenn eine Auftragsausführung mit Webhook aufgerufen wird, sendet der Agent eine Anfrage an Ihren Webhook. Ihr Webhook kann alle erforderlichen Aktionen innerhalb Ihres Dienstes ausführen, eine dynamische Antwortnachricht bereitstellen, Parameterwerte überschreiben und die aktuelle Seite ändern.
Im Folgenden werden die Webhook-Einstellungen für die Auftragsausführung beschrieben:
Webhook aktivieren
Dadurch wird der Webhook für die Auftragsausführung aktiviert.
Webhook
Wählen Sie die Webhook-Ressource aus.
Tag
Das hier angegebene Text-Tag wird in das Feld WebhookRequest.fulfillmentInfo.tag der Webhook-Anfrage eingefügt, die an Ihren Webhook-Dienst gesendet wird. So lässt sich das Webhook-Verhalten auftragsspezifisch steuern.
Teilantwort zurückgeben
Ermöglicht das Abbrechen der Wiedergabe einer teilweisen Antwort. Weitere Informationen finden Sie unter Erweiterte Spracheinstellungen.

Parametervoreinstellungen
Mit einer Auftragsausführung können Sie Voreinstellungen bereitstellen, die aktuelle Parameterwerte festlegen oder überschreiben. Diese Voreinstellungen werden angewendet, bevor statische Antwortnachrichten verarbeitet werden oder ein Webhook aufgerufen wird.
Sie können auch Systemfunktionen verwenden, um den Parameter auf einen dynamisch generierten Wert festzulegen.
Beispiele:
Parameter now auf die aktuelle Zeit festlegen:
Parameter
Wert
jetzt
$sys.func.NOW()

Vorhandenen Parameter counter um 1 erhöhen:
Parameter
Wert
Zähler
$sys.func.ADD($session.params.counter, 1)

Parameter new-cost auf den Parameterwert other-cost festlegen und dabei den vollständigen Wert des zusammengesetzten Objekts beibehalten:
Parameter
Wert
new-cost
$sys.func.IDENTITY($session.params.other-cost)

Erweiterte Spracheinstellungen
Diese erweiterten Spracheinstellungen können optional dieselben Spracheinstellungen von Seiten, Ablaufspracheinstellungen und Spracheinstellungen des Agents überschreiben.
Antwortwarteschlange
Während der Unterhaltungsrunde eines Agents ist es möglich (und manchmal gewünscht), mehrere Auftragsausführungen aufzurufen, von denen jede eine Antwort erzeugen kann. Conversational Agents (Dialogflow CX) speichern diese Antworten in einer Antwortwarteschlange.
Unvollständige Beantwortung für Streaming API
Standardmäßig sendet Conversational Agents (Dialogflow CX) die sortierten Antworten nur dann an den Endnutzer, wenn die Unterhaltungsrunde des Agents beendet ist. Sie können bei der Auftragsausführung auch die Option Teilantwort zurückgeben aktivieren, um mithilfe der Streaming-APIs derzeit in der Warteschlange befindliche Antworten als Teilantwort zurückzugeben. Weitere Informationen finden Sie unter Lebenszyklus einer Seite.
Wenn Ihr Webhook beispielsweise lange Zeit ausgeführt wird, können Sie der Auftragsausführung eine statische Antwort hinzufügen und die unvollständige Beantwortung aktivieren. Dadurch wird der Konversations-Agent (Dialogflow CX) die Antwortwarteschlange leeren und alle Nachrichten als unvollständige Antwort senden, bevor der Webhook aufgerufen wird.
Unvollständige Antworten werden derzeit nicht für folgende unterstützt, werden aber später unterstützt:
Audioeingaben im Simulator
Telefonieintegrationen von Partnern unterstützen derzeit möglicherweise keine teilweisen Antworten. Weitere Informationen finden Sie in der Partnerdokumentation.
Wenn Sie diese Funktion im Simulator testen möchten, müssen Sie die unvollständige Beantwortung aktivieren.

Beachten Sie im folgenden Beispiel, dass der Webhook 5 Sekunden dauert. Ein Teilantwort wird nicht aktiviert. Die Unterhaltungsrunde des Conversational Agents (Dialogflow CX) wird erst beendet, wenn der Webhook abgeschlossen ist. Während dieser 5 Sekunden werden die Antworten während des Wartens auf den Webhook in die Warteschlange gestellt und erst nach Abschluss der Runde an den Endnutzer zurückgegeben. Dies führt zu einer schlechten Nutzererfahrung.

Wenn Sie die Teilantwort bei der ersten Auftragsausführung aktivieren, gibt der Konversations-Agent (Dialogflow CX) die erste Auftragsausführungsnachricht schnell zurück und ruft den Webhook auf. Nachdem der Webhook abgeschlossen ist, gibt Conversational Agents (Dialogflow CX) die endgültige Antwort zurück. In diesem Szenario wird die Endnutzererfahrung verbessert, da mitgeteilt wird, dass eine kurze Wartezeit zu erwarten ist. Außerdem wird der Webhook-Aufruf gleichzeitig mit einer Antwort ausgeführt, die an den Endnutzer gesendet wird.

Speech Synthesis Markup Language (SSML)
Sie können die Speech Synthesis Markup Language (SSML) in Text- oder Audio-Text-Ausführungsfeldern verwenden. So können Sie die Audioantwort anpassen, indem Sie Details zu Pausen angeben und Audioformatierungen für Akronyme, Datums- und Uhrzeitangaben, Abkürzungen oder zu zensierenden Text festlegen.
Weitere Informationen zur Syntax finden Sie in der SSML-Dokumentation für die Sprachsynthese.
Hinweis: Ein Erfüllungsfeld darf maximal ein -Tag-Paar enthalten.

Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Sitzungen
bookmark_border
Der Begriff Sitzung steht für eine Unterhaltung zwischen einem Konversations-Agenten (Dialogflow CX) und einem Endnutzer. Zu Beginn einer Unterhaltung erstellen Sie eine Sitzung und verwenden diese für jede Unterhaltungsrunde. Sobald die Unterhaltung zu Ende ist, beenden Sie die Sitzung.
Für gleichzeitige Unterhaltungen mit verschiedenen Endnutzern sollten Sie nicht dieselbe Sitzung verwenden. Eine Sitzung bleibt aktiv und ihre Daten werden 30 Minuten nach dem Senden der letzten Anfrage für die Sitzung gespeichert.
Jeder Sitzung wird von Ihrem System eine eindeutige Sitzungs-ID zugewiesen. Sie erstellen eine neue Sitzung, indem Sie in einer Anfrage zur Intent-Erkennung und anderen Sitzungsmethoden eine neue Sitzungs-ID bereitstellen. Eine Sitzungs-ID besteht aus einem String mit höchstens 36 Byte. Die Verantwortung für das Erzeugen eindeutiger Sitzungs-IDs liegt bei Ihrem System. Dabei kann es sich um Zufallszahlen, um gehashte Endnutzer-IDs oder um alle erdenklichen anderen Werte handeln, die Sie bequem generieren können.
In der Dokumentation zur Regionalisierung finden Sie Informationen zum Standort-ID-Wert des Sitzungsnamens.
Lang andauernde Sitzungen
Standardmäßig werden die Sitzungsdaten von Conversational Agents (Dialogflow CX) 30 Minuten lang aufbewahrt. Es gibt zwei Möglichkeiten, die Lebensdauer der Sitzungen zu verlängern:
(Bevorzugt) Legen Sie die Sitzungs-TTL mit QueryParameters.session_ttl fest. Der maximal zulässige Wert beträgt 24 Stunden.
Sie können den vorherigen Sitzungsstatus jedoch wiederherstellen, indem Sie QueryParameters.current_page und QueryParameters.parameters in DetectIntentRequest festlegen.
Beispiel für einen Workflow:
Der Endnutzer kommuniziert mit dem Agent unter Sitzung A.
Der Code zeichnet den mit Sitzung A verknüpften Status auf, der in der API-Antwort zurückgegeben wurde, nämlich QueryResult.current_page und QueryResult.parameters.
Der Endnutzer beendet die Interaktion mit dem Agent nach 50 Minuten.
Der Endnutzer kommuniziert noch einmal mit dem Agent.
Ihr Code sendet die Endnutzereingabe zusammen mit den zuvor aufgezeichneten QueryParameters.current_page und QueryParameters.parameters in der Anfrage, um einen Intent mit dem vorherigen Sitzungsstatus zu erkennen. Sie müssen nicht dieselbe Sitzungs-ID wie für Sitzung A verwenden.
Hinweis: Handler-Aufrufstack wird nicht mit diesem Ansatz wiederhergestellt.

Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Agents
bookmark_border
Ein Conversational Agents (Dialogflow CX)-Agent ist ein virtueller Agent, der nebenläufige Unterhaltungen mit Ihren Endnutzern abwickelt. Mithilfe von Natural Language Understanding (NLU) versteht der Agent die Nuancen der menschlichen Sprache. Konversations-Agents (Dialogflow CX) übersetzen Nutzereingaben in Text- oder Audioform während einer Unterhaltung in strukturierte Daten, die Ihre Anwendungen und Dienste verstehen können. Sie entwerfen und erstellen einen Konversations-Agenten (Dialogflow CX), der die für Ihr System erforderlichen verschiedenen Typen von Unterhaltungen verarbeitet.
Ein Conversational Agents-Agent (Dialogflow CX) ähnelt einem menschlichen Callcenter-Agent. Beide werden für die Bearbeitung erwarteter Szenarien trainiert. Dabei sind keine übermäßig genauen Vorgaben nötig.
Agent erstellen
Hinweis: Sie können mehrere Konversations-Agents (Dialogflow CX) für ein Google Cloud-Projekt erstellen.
So erstellen Sie einen Agent:
Console
API
Öffnen Sie die Dialogflow CX Console.
Erstellen oder wählen Sie ein Google Cloud-Projekt aus.
Klicken Sie auf Agent erstellen.
Wählen Sie Automatisch generieren aus, um einen Datenspeicher-Agenten zu erstellen, oder Eigenen erstellen, um andere Arten von Agenten zu erstellen.
Füllen Sie das Formular für die grundlegenden Agent-Einstellungen aus.
Sie können einen beliebigen Anzeigenamen wählen.
Wählen Sie den bevorzugten Standort aus. Klicken Sie auf die Schaltfläche Bearbeiten, wenn Sie die erweiterten Standorteinstellungen ändern möchten.
Wählen Sie Ihre bevorzugte Zeitzone aus.
Wählen Sie die Standardsprache für Ihren Agent aus. Sie können die Standardsprache für einen Agent nicht mehr ändern, nachdem er erstellt wurde.
Klicken Sie auf Speichern.
Agent-Daten
Conversational Agents (Dialogflow CX) dienen als übergeordnete Container für Einstellungen und Daten für virtuelle Agents.
So greifen Sie auf die Daten eines Agents zu:
Console
API
Öffnen Sie die Dialogflow CX Console.
Wählen Sie das Google Cloud-Projekt für den Agenten aus.
Suchen Sie den Agent in der Liste.
Klicken Sie auf den Anzeigenamen des Agent.
Aktualisieren Sie Abläufe, Seiten usw. wie in anderen Anleitungen beschrieben.
Agents sind folgenden Daten zugeordnet:
Intents
Entitätstypen
Webhooks
Abläufe
Seiten
Route-Gruppen
Weitere Informationen dazu, wie Daten auf verschiedenen Ebenen angewendet werden, finden Sie unter Ebenen der Datenanwendung.
Agent exportieren und wiederherstellen
Sie können einen Agenten in eine Datei exportieren und mit dieser Datei wiederherstellen.
Ein Agentenexport enthält alle Agentendaten mit folgenden Ausnahmen:
Ablaufversionen: Nur die Ablaufentwürfe werden in eine Datei exportiert.
Umgebungen: Benutzerdefinierte Umgebungen werden nicht in eine Datei exportiert.
Bei der Wiederherstellung eines Agents werden alle Ziel-Agent-Daten (einschließlich aller Ablaufversionen) mit folgenden Ausnahmen überschrieben:
Umgebungen: Alle benutzerdefinierten Umgebungen bleiben im Ziel-Agent unverändert. Ablaufversionen, auf die von benutzerdefinierten Umgebungen im Ziel-Kundenservicemitarbeiter verwiesen wird, bleiben so lange bestehen, wie die zugehörigen Umgebungen vorhanden sind. Diese veralteten Ablaufversionen werden jedoch nicht für den Kundenservicemitarbeiter aufgeführt oder können nicht ausgewählt werden.
Vertex AI Agents-Apps: Die Verknüpfung mit einer Vertex AI Agents-App bleibt im Ziel-Agent unverändert. (Mit anderen Worten: der Wert von engine in GenAppBuilderSettings) Das bedeutet, dass Datenspeicher-Agenten nur in andere vorhandene Datenspeicher-Agenten wiederhergestellt werden können, da der resultierende Agent auch mit einer Vertex AI Agents App verknüpft sein muss.
Datenspeicher von Vertex AI-Agents: Alle Verweise auf Datenspeicher werden im Ziel-Agenten gemäß den folgenden Regeln überschrieben:
Wenn der Ziel-Agent nicht mit einer App verknüpft ist, kann er nicht mit Datenspeicherverweisen wiederhergestellt werden. Bei einem entsprechenden Versuch wird eine Fehlermeldung ausgegeben. Sie können das Problem entweder beheben, indem Sie einen neuen Datenspeicher-Agenten erstellen. Alternativ können Sie Ihren vorhandenen Agenten in einen Datenspeicher-Agenten umwandeln, indem Sie ihm einen Status-Handler für den Datenspeicher hinzufügen. In diesem Fall werden Sie durch das Hinzufügen einer verknüpften App zu Ihrem Kundenservicemitarbeiter geführt.
Wenn der Ziel-Agent mit einer App verknüpft ist, werden alle Datenspeicherreferenzen bei der Wiederherstellung aktualisiert: Die Google Cloud-Projekt-ID und der Speicherort werden so angepasst, dass sie mit der App des Ziel-Agenten übereinstimmen. Die Sammlungs-ID und die Datenspeicher-ID bleiben unverändert. Das bedeutet, dass Sie vor der Wiederherstellung Datenspeicher für alle IDs mit übereinstimmenden Typen in der App des Ziel-Agenten hinzufügen müssen.
Beispiel: Wenn sich der Quell-Agent auf einen Datenspeicher namens projects/123/locations/eu-west2/collections/default_collection/dataStores/myDataStore1 bezieht und die App des Ziel-Agents den Namen projects/321/locations/us-east1/collections/default_collections/engines/app123 hat, lautet die resultierende Datenspeicherreferenz im Ziel-Agenten: projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1
Hinweis: In der API und im Inhalt der exportierten Daten wird eine Vertex AI-Kundenservicemitarbeiter-App als GenAppBuilder-Engine bezeichnet. In einem exportierten JSON-Paket finden Sie den Namen der Engine beispielsweise in der Datei agent.json unter dem Schlüssel genAppBuilderSettings.engine.
Beim Exportieren können Sie das Exportdateiformat auswählen. Wenn Sie für Ihre Kundenservicemitarbeiterdaten eine Versionskontrolle verwenden, sollten Sie sie im JSON-Format exportieren. Wenn Sie einen Agenten wiederherstellen, wird das Dateiformat automatisch von Conversational Agents (Dialogflow CX) ermittelt.
So exportieren Sie einen Agent oder stellen ihn wieder her:
Console
Öffnen Sie die Dialogflow CX Console.
Wählen Sie das Google Cloud-Projekt für den Agenten aus.
Klicken Sie in der Liste auf das Dreipunkt-Menü more_vert für einen Agent in der Liste.
Klicken Sie auf die Schaltfläche Exportieren oder Wiederherstellen.
Folgen Sie der Anleitung, um den Vorgang abzuschließen.
Hinweis :Wenn Sie einen Datenspeicher-Agent wiederherstellen möchten, muss der Ziel-Agent als Datenspeicher-Agent erstellt worden sein.
API
Siehe die Methoden export und restore für den Typ Agent.
Zur Agent API-Referenz
Wenn die Agent-Größe die maximale Grenze überschreitet, verwenden Sie die Cloud Storage-Option für den Agent-Export und die Wiederherstellung.
Wenn Sie GitHub verwenden, lesen Sie auch den GitHub-Export-/Wiederherstellungsleitfaden.
Agent löschen
Achtung: Das Löschen eines Agents kann nicht rückgängig gemacht werden. Exportieren Sie den Agent gegebenenfalls, um ein Back-up zu haben.
Zum Löschen eines Agents benötigen Sie eine Rolle mit uneingeschränktem Zugriff oder Bearbeitungszugriff. Weitere Informationen finden Sie in der Anleitung zur Zugriffssteuerung.
So löschen Sie einen Agent:
Console
API
Öffnen Sie die Dialogflow CX Console.
Wählen Sie das Google Cloud-Projekt für den Agenten aus.
Klicken Sie in der Liste auf das Dreipunkt-Menü more_vert für einen Agent in der Liste.
Klicken Sie auf deleteLöschen.
Bestätigen Sie den Löschvorgang im Dialogfeld.
Wenn Sie Ihr Projekt löschen, werden alle mit dem Projekt verknüpften Konversations-Agents (Dialogflow CX) und Daten sofort gelöscht.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Intents
bookmark_border
Ein Intent kategorisiert die Absicht eines Endnutzers für eine Unterhaltungsrunde.
Ein Intent enthält folgende Daten:
Anzeigename
Name, der in der Console für den Intent angezeigt wird.
Labels
Labels, die bei der Kategorisierung von Intents helfen. Beispiel: head intent.
Trainingsformulierungen
Trainingsformulierungen sind Beispielformulierungen für das, was Endnutzer eingeben oder sagen könnten, sogenannte Endnutzereingaben. Wenn die Endnutzereingabe einer dieser Formulierungen ähnelt, ordnet Conversational Agents (Dialogflow CX) den Intent zu. Sie müssen dabei nicht jede denkbare Formulierung angeben. Das integrierte maschinelle Lernen von Conversational Agents (Dialogflow CX) erweitert Ihre Liste automatisch um ähnliche Äußerungen.
Parameter
Sie definieren Ihre Trainingsformulierungen, um mithilfe von Parametern Werte aus bestimmten Teilen der Endnutzereingabe zu extrahieren.
DTMF-Muster
Weitere Informationen finden Sie unter DTMF für Telefonieintegrationen.

Intent-Zuordnung
Wenn ein Endnutzer eine Eingabe macht (Text, Sprache oder Tastendruck auf dem Telefon), vergleicht Conversational Agents (Dialogflow CX) die Eingabe mit den Intent-Trainingsformulierungen, um die beste Übereinstimmung zu finden. Dieser Vorgang wird als Intent-Zuordnung bezeichnet. Die Intent-Zuordnung kann nur für Intents erfolgen, die mit einer Intent-Route (ein Zustands-Handler mit einer Intent-Anforderung) im Bereich verknüpft sind.
Die Eingabe von Tastendrücken wird anhand von DTMF-Mustern abgeglichen. Bei der Suche nach einem übereinstimmenden Intent für Text bewerten Conversational Agents (Dialogflow CX) potenzielle Übereinstimmungen jedoch mit einer Intent-Erkennungskonfidenz, die auch als Konfidenzwert bezeichnet wird. Diese Werte reichen von 0,0 (vollständig unsicher) bis 1,0 (vollständig sicher). Wurden Intents bewertet, gibt es zwei mögliche Ergebnisse:
Wenn der Intent mit der höchsten Bewertung einen Konfidenzwert größer oder gleich der Einstellung für den Klassifizierungsschwellenwert aufweist, wird er als Übereinstimmung zurückgegeben.
Wenn keine Intents den Schwellenwert erreichen, wird ein No-Match-Ereignis aufgerufen.
Hinweis: Die ML-Modelle für Konversationsagenten (Dialogflow CX) sind in gewissem Maße groß- und kleinschreibungsempfindlich. Das kann zu leicht abweichenden Übereinstimmungswerten für Endnutzereingaben führen, die sich nur in der Groß- und Kleinschreibung unterscheiden. Beim erweiterten NLU-Modell wird die Groß-/Kleinschreibung berücksichtigt, beim Standard-NLU-Modell hingegen nicht. Weitere Informationen finden Sie im Leitfaden zu Best Practices für das Agent-Design.
Trainingssätze
Hinweis: Im Leitfaden zu Best Practices für das Design von Agents finden Sie viele wichtige Best Practices für Trainingsphrasen.
Trainingsformulierungen sind Beispielformulierungen für das, was Endnutzer eingeben oder sagen könnten, sogenannte Endnutzereingaben. Für jeden Intent erstellen Sie viele Trainingsformulierungen. Wenn eine Endnutzereingabe einer dieser Formulierungen ähnelt, ordnet Conversational Agents (Dialogflow CX) den Intent zu.
Die Trainingsformulierung „Ich möchte Pizza“ trainiert Ihren Agent beispielsweise, Endnutzereingaben zu erkennen, die dieser Formulierung ähnlich sind, wie „Pizza bestellen“ oder „Bestell Pizza“.
Sie müssen dabei nicht jede denkbare Formulierung angeben. Das integrierte maschinelle Lernen von Conversational Agents (Dialogflow CX) erweitert Ihre Liste automatisch um ähnliche Formulierungen. Sie sollten (je nach Komplexität des Intents) mindestens 10–20 Trainingsformulierungen erstellen, damit Ihr Agent vielfältige Endnutzereingaben erkennen kann. Beispiel: Wenn Sie möchten, dass Ihr Intent die Eingabe eines Endnutzers zu seiner Lieblingsfarbe erkennt, können Sie folgende Trainingsformulierungen definieren:
„I like red“ (Ich mag Rot)
„My favorite color is yellow“ (Meine Lieblingsfarbe ist Gelb)
„black“ (Schwarz)
„Blue is my favorite“ (Blau ist mein Favorit)
…
(Vorabversion) Trainingsphrasen automatisch generieren und übersetzen
Sie können Trainingsphrasen mithilfe von KI automatisch generieren lassen, anstatt sie manuell einzugeben. So verwenden Sie dieses Feature:
Rufen Sie den Tab Verwalten auf und klicken Sie auf Intents. Wählen Sie entweder einen vorhandenen Intent aus oder klicken Sie auf + Erstellen, um einen neuen zu erstellen.
Geben Sie im Feld Beschreibung einen Zweck für den Intent ein, z. B. „Dieser Intent wird ausgelöst, wenn ein Nutzer nach dem Status seiner Bestellung fragt“. Der KI-Generator verwendet dieses Feld, um genauere Trainingsphrasen zu generieren.
Klicken Sie auf die Auswahlschaltfläche __ neue KI-generierte Sätze. Der Standardwert ist 3. Wenn Sie mehr als 15 Trainingsphrasen gleichzeitig generieren, kann das zu Fehlern führen.
Klicken Sie auf + Hinzufügen. Die KI generiert die angegebene Anzahl von Trainingsphrasen und fügt sie in die Tabelle ein. Prüfen Sie alle generierten Trainingsphrasen auf Richtigkeit.
Informationen zur Verwendung dieser Funktion zum automatischen Generieren und Übersetzen von Daten für andere Sprachen als die Standardsprache finden Sie in der Dokumentation zu mehrsprachigen Kundenservicemitarbeitern.
Trainingsformulierungen annotieren
Hinweis: Im Leitfaden zu Best Practices für das Design von Agents werden viele wichtige Best Practices für Anmerkungen zu Trainingsformulierungen beschrieben.
Sie legen durch Annotieren von Teilen Ihrer Trainingsformulierungen und durch Konfigurieren der zugehörigen Parameter fest, wie Endnutzerdaten extrahiert werden.
Stellen Sie sich beispielsweise eine Trainingsformulierung wie „Wie ist die Wettervorhersage für morgen in Tokio?“ vor. Sie sollten „morgen“ mit einem date-Parameter und „Tokio“ mit einem location-Parameter annotieren. Wenn Sie Teile einer Trainingsformulierung annotieren, erkennt Dialogflow CX, dass diese Teile nur Beispiele für tatsächliche Werte sind, die von Endnutzern zur Laufzeit bereitgestellt werden. Für eine Endnutzereingabe wie „Wie ist die Wettervorhersage für Sydney am Freitag?“ Conversational Agents (Dialogflow CX) würden den Parameter date aus „Freitag“ und den Parameter location aus „Sydney“ extrahieren.
Sie müssen alle Teile der Trainingsformulierung annotieren, die als Parameter extrahiert werden sollen. Andernfalls werden die Werte von Dialogflow nicht extrahiert.
Bei der Erstellung eines Agents mit der Konsole werden die meisten Annotationen automatisch angelegt, wenn Sie Trainingsformulierungen hinzufügen, von denen Teile existierenden Entitätstypen zugeordnet werden können. Diese Teile werden in der Konsole markiert. Sie können diese Annotationen und Parameter nach Bedarf bearbeiten.
So können Sie eine Trainingsformulierung manuell mit der Konsole annotieren:
Wählen Sie den Teil der Trainingsformulierung aus, den Sie annotieren möchten.
Wählen Sie den gewünschten Entitätstyp aus der Liste aus.
In der Parametertabelle unten wird ein Parameter erstellt.
Bei der Erstellung eines Agents mit der API müssen Sie die Bestandteile der Trainingsformulierung manuell annotieren. Siehe den Typ TrainingPhrase, der vom Typ Intent verwendet wird.
Zur Intent API-Referenz
Implizite Entitäten, die durch Trainingsformulierungen erstellt wurden
Hinweis: Sie sollten Entitäten explizit definieren, anstatt sich auf implizit definierte benutzerdefinierte Entitätswerte zu verlassen.
Die meisten benutzerdefinierten Entitäten werden explizit definiert, indem Entitätstypen erstellt und Entitätseinträge hinzugefügt werden. Benutzerdefinierte Entitäten können jedoch auch implizite Werte enthalten. Das passiert, wenn Sie Text einer Trainingsformulierung annotieren und der annotierte Text kein vom ausgewählten Entitätstyp definierter Wert ist. Der kommentierte Text wird zum Entitätsreferenzwert für den implizit hinzugefügten Entitätseintrag. Wenn der Entitätstyp eine Kartenentität ist, wird der Text auch zum Synonym für den Entitätseintrag.
Standard-Begrüßungs-Intent
Wenn Sie einen Agent erstellen, wird automatisch ein Standard-Begrüßungs-Intent erstellt. Für einige Sprachen enthält der Intent einfache Trainingsformulierungen wie „Hi“ oder „Hallo“, die den anfänglichen Endnutzerausdrücken entsprechen sollen. Sie können diesen Intent nach Bedarf bearbeiten.
Bei Verwendung der API können Sie diesen Intent mit der folgenden Intent-ID referenzieren:
00000000-0000-0000-0000-000000000000
Wenn Ihr Kundenservicemitarbeiter die Unterhaltung initiiert, können Sie diesen Intent mithilfe der API auslösen. Verwenden Sie den Wert projects//locations//agents//intents/00000000-0000-0000-0000-000000000000 im Feld QueryInput.intent.intent, wenn Sie die Methode detectIntent oder streamingDetectIntent aufrufen.
Standardmäßig auszuschließender Intent
Wenn Sie einen Agent erstellen, wird automatisch ein negativer Intent angelegt. Sie können diesem Intent Trainingsformulierungen hinzufügen, die als Negativbeispiele dienen. Es kann vorkommen, dass Eingaben von Endnutzern teilweise mit Trainingsformulierungen in normalen Intents übereinstimmen, es aber nicht erwünscht ist, dass diese Eingaben als Intent gewertet werden.
Beispielsweise kann ein Zimmerbuchungsservice eine Trainingsformulierung wie „Ich möchte ein Zimmer buchen“ enthalten. Wenn der Endnutzer ein Buch über Räume kaufen möchte, sagt er vielleicht „Ich möchte ein Buch über Räume kaufen“. Damit der Endnutzerausdruck nicht Ihrem Intent zugeordnet wird, können Sie die Formulierung als negatives Beispiel hinzufügen.
Außerdem sollten Sie mögliche Wortgruppen hinzufügen, die nicht in den Zuständigkeitsbereich des Bots fallen, damit sie nicht mit einer Absicht übereinstimmen. Fügen Sie jedoch nicht zu viele dieser Wortgruppen hinzu. Wenn Sie beispielsweise 10.000 Standardformulierungen für auszuschließende Intents definieren, wirkt sich das negativ auf die normale Intent-Abgleichung aus.
Sie sollten diese Sätze regelmäßig überprüfen, da einige davon ursprünglich nicht zum Zuständigkeitsbereich des Bots gehörten, aber später Intents hinzugefügt wurden.
Der standardmäßig auszuschließende Intent wirkt sich auf die gesamte Intent-Abgleichsfunktion aus. Die hinzugefügten Wortgruppen können die Zuordnung für einen Intent verbessern, aber die Zuordnung für einen anderen verschlechtern. Sie können beispielsweise „internationale Anrufe“ zum Standard-Negativ-Intent hinzufügen, um einen Abgleich mit einem Intent für internationale Reisen zu vermeiden. Dadurch wird jedoch auch verhindert, dass der Ausdruck mit der Absicht für einen internationalen Anruf abgeglichen wird.
Bei Verwendung der API können Sie diesen Intent mit der folgenden Intent-ID referenzieren:
00000000-0000-0000-0000-000000000001
Intents abbrechen
Während einer Unterhaltung kann der Endnutzer das aktuelle Unterhaltungsthema abbrechen. Beispiel: Die aktuell aktive Seite fordert möglicherweise ein Datum für einen neuen Termin an, der Endnutzer hat sich jedoch gegen die Erstellung eines neuen Termins entschieden. Der Endnutzer sagt möglicherweise „Abbrechen“ oder „Ich möchte keinen neuen Termin“. Sie können in diesem Fall einen oder mehrere Intents abbrechen für Ihren Agent erstellen. Sie können diesen Abbruch-Intents einen beliebigen Namen geben. Der Name ist jedoch üblich, „cancel“ in den Namen aufzunehmen. Sie sollten diese Abbruch-Intents mit Intent-Routen verknüpfen, die sich im relevanten Bereich an relevanten Punkten in der Unterhaltung befinden. Diese Intent-Routen sollten auf eine entsprechende Seite wechseln, um den Abbruch zu verwalten.
Die Trainingsformulierungen für Abbrechen-Intents sollten sowohl allgemeine als auch themenspezifische Versuche zum Abbrechen verarbeiten. Beispiel:
Abbrechen
Beenden
Nein, doch nicht
Abbrechen
Zurück
Zurück
Ich möchte keinen neuen Termin
Neuen Termin stornieren
Neuen Termin löschen
Intent erstellen
So erstellen Sie einen Intent:
Console
API
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Intents.
Klicken Sie auf +Erstellen.
Geben Sie Intent-Daten ein.
Klicken Sie auf Speichern.
Intent löschen
So löschen Sie einen Intent:
Console
API
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Intents.
Setzen Sie den Mauszeiger auf den Intent, den Sie löschen möchten.
Klicken Sie auf die Schaltfläche Löschen delete.
Auf Intent-Daten zugreifen
So greifen Sie auf Intent-Daten zu:
Console
API
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Intents.
Klicken Sie auf den Intent, auf den Sie zugreifen möchten.
Sehen Sie sich Intent-Daten an oder aktualisieren Sie sie.
Klicken Sie auf Speichern, um die Änderungen zu speichern.
Vorschläge für Intents
Hinweis :Diese Funktion ist derzeit nur in den Regionen „global“ und „us-central1“ verfügbar. Wenn Sie diese Funktion für andere Regionen benötigen, wenden Sie sich an Ihr Google Cloud-Kontoteam.Hinweis: In den allgemeinen Einstellungen für Kundenservicemitarbeiter müssen Vorschläge für Absichten aktiviert sein.
Dialogflow analysiert automatisch nicht übereinstimmende Vorkommen während Unterhaltungen und kann neue Intents vorschlagen oder zusätzliche Trainingsphrasen für vorhandene Intents empfehlen. Wenn Sie diese Vorschläge annehmen, können Sie in Zukunft vermeiden, dass keine Übereinstimmung gefunden wird.
Wenn Sie Vorschläge verwenden, können Sie die Clustergröße anpassen. Kleinere Werte für die Clustergröße deuten auf mehr Intents mit weniger Trainingsformulierungen pro Intent hin. Größere Werte für die Clustergröße deuten auf weniger Intents mit mehr Trainingsphrasen pro Intent hin.
So akzeptieren Sie Vorschläge für Intents:
Console
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Intents.
Klicken Sie auf den Tab Vorschläge.
Passen Sie die Clustergröße nach Bedarf an.
Wählen Sie einen Vorschlag aus.
Wählen Sie die gewünschten Trainingsphrasen aus.
Fügen Sie die Trainingsformulierungen für den Ziel-Intent einem vorhandenen oder einem neuen Intent hinzu.
Klicken Sie auf Speichern oder Neu erstellen, um die Änderungen zu speichern. Wenn Sie Vorschläge für Intents annehmen, bleibt der Intent in der Vorschlagsliste.
Intents teilen
Sie können einen Intent in der Console in zwei Intents aufteilen. Über die Benutzeroberfläche können Sie Trainingsphrasen aus einem Quell-Intent auswählen und in einen neuen Intent verschieben:
Console
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Intents.
Wählen Sie den Intent aus, den Sie aufteilen möchten.
Klicken Sie auf Split.
Wählen Sie Intents aus dem Quell-Intent aus.
Klicken Sie auf Nach rechts verschieben.
Geben Sie weitere Details für den Ziel-Intent an.
Klicken Sie auf Split.
Intents vergleichen und zusammenführen
Sie können zwei Intents über die Console vergleichen oder zu einem einzigen Intent zusammenführen:
Console
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Intents.
Wählen Sie die beiden Intents aus, die Sie vergleichen oder zusammenführen möchten.
Klicken Sie auf Vergleichen.
Die Trainingsphrasen werden zum Vergleich nebeneinander angezeigt.
Klicken Sie auf Zusammenführen, um die beiden Intents zusammenzuführen.
Intents exportieren und importieren
Sie können Intents exportieren und importieren, um sie für mehrere Kundenservicemitarbeiter freizugeben.
Eine der Exportformatoptionen ist CSV. Diese Option umfasst die folgenden Spalten:
Anzeigename des Intents
Sprache
Wortgruppe
Jeder Eintrag enthält entweder den Anzeigenamen, die Sprache und den ersten Trainingssatz oder nur einen Trainingssatz für den zuvor deklarierten Intent. Dialogflow codiert Anmerkungen in exportierten Trainingsformulierungen, damit sie beim Importieren wiederhergestellt werden. Das Format für diese Codierung lautet:
(annotated part)[entity, parameter]
Beispiel:
Intent Display Name,Language,Phrase
Shirt Selection,en,I want a (green)[@sys.color, color] shirt
,,I would like a (yellow)[@sys.color, color] shirt
Store Hours,en,When are you open?
,,What are your hours?
Beim Importieren von Intents kann es zu Zusammenführungskonflikten kommen, wenn der Anzeigename eines Intents in Ihrem vorhandenen Agent mit dem eines importierten Intents übereinstimmt. Sie können das Zusammenführen von Intents steuern, wenn die Anzeigenamen übereinstimmen. Wählen Sie dazu eine der folgenden Optionen aus:
Vorhandene Intents ersetzen: Ein importierter Intent überschreibt alle Intents mit demselben Namen in Ihrem vorhandenen Agenten.
Umbenennen und als neue Intents importieren: Der importierte Intent wird umbenannt, indem dem Anzeigenamen „_1“ angehängt wird.
Mit vorhandenen Intents zusammenführen: Die Trainingsformulierungen eines importierten Intents werden dem vorhandenen Intent hinzugefügt. Wenn dieselben Trainingsphrasen vorhanden sind, werden sie nicht dupliziert.
Ursprüngliche Intents beibehalten: Der vorhandene Intent bleibt unverändert und der in Konflikt stehende Intent wird ignoriert. Nicht in Konflikt stehende Intents werden importiert.
So exportieren Sie Intents:
Console
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Intents.
Wählen Sie alle Intents aus, die Sie exportieren möchten.
Klicken Sie auf Ausgewählte Intents exportieren.
Wählen Sie das gewünschte Format und Ziel aus.
Klicken Sie auf Senden.
So importieren Sie Intents:
Console
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Intents.
Klicken Sie auf Importieren.
Wählen Sie die Quelle aus.
Falls Konflikte auftreten, wird ein Dialogfeld angezeigt, in dem Sie das Zusammenführungsverhalten auswählen können.
Klicken Sie auf Senden.
Trainingsphrasen exportieren und importieren
Sie können Trainingswortgruppen für einen vorhandenen Intent exportieren und importieren.
Das Dateiformat für den Import ist CSV ohne Spaltenüberschrift und mit einer einzelnen Spalte. Beispiel:
„I want a pony“
„I need a pony“
„I must have a pony“
Beim Importieren von Trainingsphrasen können Sie einen der folgenden Importmodi auswählen:
Als neue Trainingsphrasen importieren: Die Formulierungen in den Dateien werden der Liste der vorhandenen Formulierungen hinzugefügt.
Vorhandene Trainingsformulierungen ersetzen: Die vorhandenen Trainingsformulierungen werden gelöscht und die Trainingsformulierungen aus den Dateien werden hinzugefügt.
Importierte Trainingsphrasen werden standardmäßig automatisch annotiert. Sie können dieses Verhalten deaktivieren, indem Sie Automatische Anmerkungen überspringen auswählen.
So exportieren Sie Trainingsformulierungen für einen Intent:
Console
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Intents.
Wählen Sie einen Intent aus.
Scrollen Sie nach unten zum Abschnitt Training phrases (Trainingsformulierungen).
Wählen Sie die Trainingsformulierungen aus, die Sie exportieren möchten.
Klicken Sie auf Exportieren.
So importieren Sie Trainingsformulierungen für einen Intent:
Console
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Intents.
Wählen Sie einen Intent aus.
Scrollen Sie nach unten zum Abschnitt Training phrases (Trainingsformulierungen).
Wählen Sie bei Bedarf automatische Anmerkungen überspringen aus.
Klicken Sie direkt über der Liste der Trainingsphrasen auf die Schaltfläche „Importieren“.
Wählen Sie eine Datei und einen Importmodus aus.
Klicken Sie auf Senden.
Haupt- und ergänzende Intents
Beim Entwerfen von Bots ist es manchmal hilfreich, Absichten als Hauptabsichten oder zusätzliche Absichten zu betrachten.
Hinweis :Das Label „head intent“ ist ein Systemlabel, das Sie auf eine Intent anwenden können. Das kann beim Filtern von Analysedaten hilfreich sein.
Ein Haupt-Intent gibt den primären Zweck der Interaktion des Endnutzers mit einem Kundenservicemitarbeiter an. Mit einem ergänzenden Intent werden die nachfolgenden Fragen eines Endnutzers identifiziert, die sich auf den Haupt-Intent beziehen. Diese nachfolgenden Fragen können zusätzlichen Kontext zu den Anforderungen des Endnutzers liefern oder es können Anschlussfragen sein, die dem Endnutzer helfen, etwas zu klären oder besser zu verstehen.
Ein Haupt-Intent ist in der Regel einer der ersten Intents, der in einer Unterhaltung zugeordnet wird. Weitere Fragen von Endnutzern werden mit ergänzenden Intents abgeglichen. Beispiel:
Dialog
Erklärung
Endnutzer: Neues Smartphone aktivieren
Kundenservicemitarbeiter: Ich helfe Ihnen gern dabei. Wie lauten die letzten vier Ziffern der Telefonnummer, die Sie aktivieren möchten?
Haupt-Intent wird zugeordnet
Endnutzer: 1234
Kundenservicemitarbeiter: Sind Sie bereit, Ihr Smartphone jetzt zu aktivieren?
Ein Parameter ist festgelegt
Endnutzer: Werden alle meine Nachrichten auf mein neues Smartphone übertragen?
Kundenservicemitarbeiter: …
Zusätzlicher Intent wird zugeordnet

Hinweis :Mit einer Routengruppe können Sie mehreren Seiten gleichzeitig zugehörige ergänzende Intents hinzufügen.

Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Gegenseitige TLS-Authentifizierung
bookmark_border
Der von Dialogflow für Webhook-Anfragen initiierte Netzwerkverkehr wird über ein öffentliches Netzwerk gesendet. Dialogflow unterstützt optional die gegenseitige TLS-Authentifizierung (mTLS), um sicherzustellen, dass der Traffic in beide Richtungen sicher und vertrauenswürdig ist. Während des standardmäßigen TLS-Handshakes von Dialogflow stellt Ihr Webhook-Server ein Zertifikat vor, das von Dialogflow validiert werden kann. Dazu wird entweder die Zertifizierungsstellenkette verfolgt oder das Zertifikat mit einem benutzerdefinierten Zertifikat der Zertifizierungsstelle verglichen. Wenn Sie mTLS auf Ihrem Webhook-Server aktivieren, kann er das Google-Zertifikat authentifizieren, das Dialogflow zur Validierung an Ihren Webhook-Server sendet. So wird die gegenseitige Vertrauensstellung hergestellt.
mTLS anfordern
So fordern Sie mTLS an:
Sie konfigurieren Ihren Webhook-HTTPS-Server so, dass er während des TLS-Handshakes das Clientzertifikat anfordert.
Der Webhook-Server sollte das Clientzertifikat beim Empfang bestätigen.
Sie installieren für den Webhook-Server eine Zertifikatskette, die sowohl vom Client als auch vom Server als vertrauenswürdig eingestuft werden kann. Anwendungen, die eine Verbindung zu Google-Diensten herstellen, sollten allen von Google Trust Services aufgeführten Zertifizierungsstellen vertrauen. Sie können Root-Zertifikate von https://pki.goog/ herunterladen.
Beispielaufruf an einen Webhook-Server mit mTLS
In diesem Beispiel wird der in der Kurzanleitung gezeigte Agent mit einem Webhook-Server verwendet, auf dem openssl ausgeführt wird.
Beispielkonfiguration
Ein Dialogflow CX-Agent, der T-Shirtbestellungen entgegennimmt und an einen Webhook sendet, der auf einen eigenständigen Webserver verweist.
Ein privater Schlüssel für die TLS-Kommunikation in einer Datei mit dem Namen key.pem.
Eine Zertifikatskette, die von einer öffentlich vertrauenswürdigen Zertifizierungsstelle (Certificate Authority, CA) in einer Datei namens fullchain.pem signiert wurde.
Führen Sie das openssl s_server-Programm auf dem Server aus.
sudo openssl s_server -key key.pem -cert fullchain.pem -accept 443 -verify 1
Eine Anfrage wird von einem Clientcomputer an den Agenten gesendet. In diesem Beispiel lautet die Anfrage: „Ich möchte ein rotes Hemd in Größe L kaufen.“ Diese Anfrage kann über die Dialogflow-Konsole oder über einen API-Aufruf gesendet werden.
Ausgabe von openssl s_server auf dem Server
verify depth is 1
Using default temp DH parameters
ACCEPT
depth=2 C = US, O = Google Trust Services LLC, CN = GTS Root R1
verify return:1
depth=1 C = US, O = Google Trust Services LLC, CN = GTS CA 1D4
verify return:1
depth=0 CN = *.dialogflow.com
verify return:1
—–BEGIN SSL SESSION PARAMETERS—–
MII…
—–END SSL SESSION PARAMETERS—–
Client certificate
—–BEGIN CERTIFICATE—–
MII…
—–END CERTIFICATE—–
subject=CN = *.dialogflow.com

issuer=C = US, O = Google Trust Services LLC, CN = GTS CA 1D4

Shared ciphers:TLS_AES_128_GCM_SHA256:…
Signature Algorithms: ECDSA+SHA256:…
Shared Signature Algorithms: ECDSA+SHA256:…
Peer signing digest: SHA256
Peer signature type: RSA-PSS
Supported Elliptic Groups: 0xEAEA:…
Shared Elliptic groups: X25519:…
CIPHER is TLS_AES_128_GCM_SHA256
Secure Renegotiation IS NOT supported
POST /shirts-agent-webhook HTTP/1.1
authorization: Bearer ey…
content-type: application/json
Host: www.example.com
Content-Length: 1595
Connection: keep-alive
Accept: /
User-Agent: Google-Dialogflow
Accept-Encoding: gzip, deflate, br

{
„detectIntentResponseId“: „a7951ce2-2f00-4af5-a508-4c2cb45698b0“,
„intentInfo“: {
„lastMatchedIntent“: „projects/PROJECT_ID/locations/REGION/agents/AGENT_ID/intents/0adebb70-a727-4687-b8bc-fbbc2ac0b665“,
„parameters“: {
„color“: {
„originalValue“: „red“,
„resolvedValue“: „red“
},
„size“: {
„originalValue“: „large“,
„resolvedValue“: „large“
}
},
„displayName“: „order.new“,
„confidence“: 0.9978873
},
„pageInfo“: {
„currentPage“: „projects/PROJECT_ID/locations/REGION/agents/AGENT_ID/flows/00000000-0000-0000-0000-000000000000/pages/06e6fc4d-c2f2-4830-ab57-7a318f20fd90“,
„displayName“: „Order Confirmation“
},
„sessionInfo“: {
„session“: „projects/PROJECT_ID/locations/REGION/agents/AGENT_ID/sessions/session-test-001“,
„parameters“: {
„color“: „red“,
„size“: „large“
}
},
„fulfillmentInfo“: {
„tag“: „confirm“
},
„messages“: [{
„text“: {
„text“: [„Ok, let\u0027s start a new order.“],
„redactedText“: [„Ok, let\u0027s start a new order.“]
},
„responseType“: „ENTRY_PROMPT“,
„source“: „VIRTUAL_AGENT“
}, {
„text“: {
„text“: [„You have selected a large, red shirt.“],
„redactedText“: [„You have selected a large, red shirt.“]
},
„responseType“: „HANDLER_PROMPT“,
„source“: „VIRTUAL_AGENT“
}],
„text“: „I want to buy a large red shirt“,
„languageCode“: „en“
}ERROR
shutting down SSL
CONNECTION CLOSED

Benutzerdefiniertes Clientzertifikat
Benutzerdefinierte Clientzertifikate können auf Agentebene konfiguriert werden, damit sie von allen Webhooks verwendet werden. Beim Aufruf des Webhooks werden die konfigurierten Zertifikate während des Handshakes präsentiert.
Der private Schlüssel und die Passphrase werden als Secret Manager-Ressource konfiguriert. Dem Dialogflow-Dienstkonto müssen die Berechtigungen „Secret Manager Secret Accessor“ für das Secret gewährt werden.
Die Clientzertifikate müssen von einer Zertifizierungsstelle signiert sein, damit der Handshake erfolgreich ist.
Best Practice
Damit Webhook-Anfragen von Ihren eigenen Dialogflow-Agents initiiert werden, sollten Sie das Bearer-Dienstidentitätstoken im Autorisierungsheader der Anfrage prüfen. Alternativ können Sie einen Sitzungsparameter prüfen, der zuvor von einem Authentifizierungsserver auf Ihrer Seite bereitgestellt wurde.
Fehler
Wenn die Clientzertifikatsvalidierung fehlschlägt (z. B. weil der Webhook-Server das Clientzertifikat nicht vertraut), schlägt der TLS-Handshake fehl und die Sitzung wird beendet.
Häufige Fehlermeldungen:
Fehlermeldung
Erklärung
Failed to verify client’s certificate: x509: certificate signed by unknown authority
Dialogflow sendet das Clientzertifikat an den externen Webhook, der es jedoch nicht bestätigen kann. Das kann daran liegen, dass der externe Webhook die CA-Kette nicht korrekt installiert hat. Alle Stamm-CAs von Google sollten vertrauenswürdig sein.

Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Suche
bookmark_border
Mit der Suchfunktion können Sie die Kernressourcen innerhalb eines Agents suchen, filtern und darauf zugreifen. Sie können Ihre Suchergebnisse nach den folgenden Ressourcen filtern:
Abläufe
Seiten
Intents
Entitätstypen
Route-Gruppen
Webhooks
Generatoren
So suchen Sie nach einer Ressource:
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr GCP-Projekt aus.
Wählen Sie den Agent aus.
Klicken Sie in der oberen Menüleiste auf das Suchsymbol search.
Geben Sie in der Suchleiste den Suchbegriff für die Ressource ein, nach der Sie suchen. Sie können eine Ressource nach einem Attribut suchen, z. B. ID, Anzeigename, Textantwort, bedingte Antwort oder benutzerdefinierte Nutzlast. Optional können Sie die Ergebnisse nach Ressourcentyp aus dem Drop-down-Menü filtern.
Während der Eingabe wird im Drop-down-Menü nur eine begrenzte Anzahl an Ergebnissen angezeigt. Klicken Sie auf ein Ergebnis, um zum Bearbeitungsfeld dieser Ressource zu wechseln.
Sie können auch auf Referenzen suchen für ein Ergebnis klicken, um alle Ressourcen anzuzeigen, die auf die gesuchte Ressource verweisen. Wenn Sie beispielsweise das Schlüsselwort store eingeben und im Ergebnismenü für den Intent store.location auf Referenzen suchen klicken, werden in den Suchergebnissen alle Ressourcen angezeigt, die auf den Intent store.location verweisen.
Drücken Sie die Eingabetaste oder klicken Sie auf das Suchsymbol search, um die vollständige Liste der Suchergebnisse aufzurufen.
Für eine genauere Filteroption klicken Sie in der Suchleiste auf das expand_more Drop-down-Menü Infofeld anzeigen.
Wählen Sie den Ressourcentyp aus, nach dem gefiltert werden soll.
Wählen Sie unter Referenzfilter die Übereinstimmungsregel AND oder OR aus.
Fügen Sie eine oder mehrere Regeln hinzu, um nach Ressourcen über Ressourcen zu suchen, auf die sie verweisen, oder um nach ihren Attributen zu suchen. So können Sie beispielsweise nach allen Seiten mit dem Trigger-Intent store.hours suchen, wobei der Anzeigename store enthält:
Wählen Sie für die erste Regel im Drop-down-Menü Intent aus und geben Sie store.hours in das Textfeld ein.
Klicken Sie auf Regel hinzufügen (AND).
Wählen Sie für die zweite Regel Anzeigename aus dem Drop-down-Menü aus und geben Sie store in das Textfeld ein.
Klicken Sie auf Suchen.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Generativ versus deterministisch
bookmark_border
Während einer Unterhaltung verwenden Conversational Agents (Dialogflow CX) immer Sprachmodelle, um die Absicht des Endnutzers zu verstehen. Sie können jedoch auswählen, ob und wie Sprachmodelle für die Antworten des Kundenservicemitarbeiters verwendet werden. Beim Entwerfen Ihres Agents können Sie zwischen vollständig generativen, teilweise generativen und deterministischen Funktionen wählen.
Dieser Leitfaden bietet einen Überblick über diese Funktionen. Es ist hilfreich, zu entscheiden, welche dieser Funktionen Sie verwenden möchten, damit Sie wissen, welche Dokumentation für Sie relevant ist.
Vollständig generatives Modell
Die vollständig generativen Funktionen basieren auf Large Language Models (LLMs) von Vertex AI, um sowohl die Absicht der Endnutzer zu verstehen als auch Agentenantworten zu generieren. Diese Funktionen sind einfach zu bedienen und sorgen für eine sehr natürliche Unterhaltung. Im Folgenden finden Sie eine Übersicht über die vollständig generativen Funktionen:
Playbooks
Playbooks bieten eine neue Möglichkeit, virtuelle Agenten mithilfe von LLMs zu erstellen. Sie müssen nur Anweisungen in natürlicher Sprache und strukturierte Daten angeben. Dadurch lässt sich die Zeit für die Erstellung und Wartung virtueller Kundenservicemitarbeiter erheblich reduzieren und es können völlig neue Arten der Kommunikation für Ihr Unternehmen ermöglicht werden.
Datenspeicher
Datenspeicher analysieren und verstehen Ihre öffentlichen oder privaten Inhalte (Website, interne Dokumente usw.). Sobald diese Informationen indexiert sind, kann Ihr Kundenservicemitarbeiter Fragen beantworten und Unterhaltungen über die Inhalte führen. Sie müssen nur die Inhalte bereitstellen.

Deterministische Abläufe
Wenn Sie mehr deterministische Kontrolle über die Unterhaltung und alle vom Agenten generierten Antworten benötigen, können Sie Ihren Agenten mit Abläufen entwerfen.
Abläufe
Bei Abläufen werden Sprachmodelle verwendet, um die Absicht des Endnutzers während einer Unterhaltung zu verstehen, was nicht immer vollständig deterministisch ist. Sobald die Absicht ermittelt wurde, haben Sie jedoch die vollständige Kontrolle über den Gesprächsfluss und die Antworten des Kundenservicemitarbeiters. Das Entwerfen eines Bots mit deterministischen Abläufen nimmt in der Regel mehr Zeit in Anspruch. Dies ist jedoch eine gute Option für Bots, bei denen die Antworten des Bots explizit gesteuert werden müssen.

Teilweise generative Abläufe
Flows haben einige optionale generative Funktionen, die Sie verwenden können, wenn Sie in bestimmten Unterhaltungsszenarien keine deterministische Kontrolle über die Antworten von Kundenservicemitarbeitern benötigen. Im Folgenden finden Sie eine Übersicht über diese Funktionen:
Generatoren
Generatoren werden verwendet, um Antworten von Kundenservicemitarbeitern zu generieren. Anstatt die Antwort des Kundenservicemitarbeiters explizit anzugeben, geben Sie einen LLM-Prompt an, der mit vielen Szenarien umgehen kann, z. B. mit der Zusammenfassung von Unterhaltungen, der Beantwortung von Fragen, dem Abrufen von Kundeninformationen und der Eskalierung an einen Kundenservicemitarbeiter.
Generativer Fallback
Mit dem generativen Fallback werden Agentantworten generiert, wenn die Eingabe des Endnutzers nicht mit einer erwarteten Absicht übereinstimmt. Sie können den generativen Fallback in bestimmten Szenarien aktivieren, indem Sie einen LLM-Prompt zur Generierung der Antwort angeben.

Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Interaktionen mit der API
bookmark_border
Für jede Unterhaltungsrunde findet eine Interaktion statt. Während einer Interaktion sendet ein Endnutzer eine Eingabe an Conversational Agents (Dialogflow CX) und Conversational Agents (Dialogflow CX) sendet eine Antwort. Sie haben zwei Möglichkeiten, Ihr System für die Verarbeitung von Interaktionen zu implementieren: mithilfe der API oder mithilfe einer Integration.
Wenn Sie die API verwenden, muss Ihr System Folgendes verarbeiten:
Agent erstellen
Benutzeroberfläche für Endnutzer bereitstellen
Rufen Sie die Dialogflow API für jeden Sprecherwechsel auf, um Endnutzereingaben an die API zu senden.
Wenn die Agent-Antworten nicht nur statisch sind (seltener), müssen Sie einen Webhook-Dienst für die Verarbeitung der Webhook-aktivierten Auftragsausführung hosten.
Wenn Sie eine Integration verwenden, muss Ihr System nur Folgendes verarbeiten:
Agent erstellen
Implementieren Sie optional einen Webhook-Dienst.
Das folgende Diagramm zeigt die Schritte, die für einen Sprecherwechsel einer Sitzung ausgeführt werden.
Hinweis: Die Kommunikation zwischen Ihren Systemen und Integrationen und Dialogflow wird bei der Übertragung verschlüsselt. Außerdem wird die Kommunikation zwischen internen Google-Komponenten mit Application Layer Transport Security (ALTS) verschlüsselt.

Der Endnutzer gibt etwas ein oder sagt etwas. Dies wird als Endnutzereingabe bezeichnet.
Ihr Benutzeroberflächen- oder Integrationssystem empfängt die Eingabe und leitet sie in einer Anfrage zur Intent-Erkennung an die Dialogflow API weiter.
Die Dialogflow API empfängt die Anfrage zur Intent-Erkennung. Sie ordnet die Eingabe einem Intent- oder Formularparameter zu, legt bei Bedarf Parameter fest und aktualisiert den Sitzungsstatus. Falls eine Webhook-fähige Auftragsausführung aufgerufen werden muss, wird eine Webhook-Anfrage an Ihren Webhook-Dienst gesendet. Fahren Sie andernfalls mit Schritt 6 fort.
Ihr Webhook-Dienst empfängt die Webhook-Anfrage. Der Dienst führt alle erforderlichen Aktionen aus, z. B. das Aufrufen externer APIs, das Abfragen oder Aktualisieren einer Datenbank usw.
Ihr Webhook-Dienst erstellt eine Antwort und sendet eine Webhook-Antwort an den Konversations-Agenten (Dialogflow CX).
Conversational Agents (Dialogflow CX) erstellen eine Antwort für die Intent-Erkennung. Wenn ein Webhook aufgerufen wurde, verwendet es die Webhook-Antwort. Wenn kein Webhook aufgerufen wurde, verwendet es die im Agent definierte statische Antwort. Konversations-Agenten (Dialogflow CX) senden eine Antwort für die Intent-Erkennung an Ihre Benutzeroberfläche oder Ihr Integrationssystem.
Ihr Benutzeroberflächen- oder Integrationssystem empfängt die Antwort für die Intent-Erkennung und leitet die Text- oder Audioantwort an den Endnutzer weiter.
Der Endnutzer sieht oder hört die Antwort.
Zweck des Leitfadens
In dieser Anleitung erfahren Sie, wie Sie die API für eine Konversationsrunde für einen Agent aufrufen, der keine Integration verwendet (Schritt 2 im obigen Diagramm). In diesem Leitfaden erfahren Sie nicht, wie Sie eine Benutzeroberfläche für Ihren Endnutzer implementieren.
Hinweis
Bevor Sie diese Anleitung lesen, sollten Sie mit Folgendem vertraut sein:
Grundlagen von Abläufen
Einrichtungsschritte ausführen
Erstellen Sie einen neuen Agent oder verwenden Sie den Agent, den Sie unter Agent mithilfe von Abläufen erstellen oder Agent mithilfe von Playbooks erstellen erstellt haben.
IDs erfassen
In den folgenden Beispielen sind mehrere IDs als Eingabe erforderlich. So ermitteln Sie die Projekt-ID, Regions-ID und Agent-ID:
Dialogflow CX-Konsole
Agent Builder-Konsole
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud Projekt aus, um die Agent-Auswahl zu öffnen.
Klicken Sie in der Liste auf das Dreipunkt-Menü more_vert für einen Agent in der Liste.
Klicken Sie auf die filter_none-Schaltfläche Name kopieren.
Dadurch wird der vollständige identifizierende Name des Agents kopiert, der Ihre Projekt-ID, Regions-ID und Agent-ID im folgenden Format enthält:
projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID
Außerdem benötigen Sie eine Sitzungs-ID. Der Begriff Sitzung steht für eine Unterhaltung zwischen einem Konversations-Agenten (Dialogflow CX) und einem Endnutzer. Zu Beginn einer Unterhaltung erstellen Sie eine eindeutige Sitzungs-ID und verwenden sie für jede Unterhaltungsrunde. Zum Testen der API können Sie eine beliebige String-ID verwenden, die höchstens 36 Byte beträgt, z. B. test-session-123.
Intent-Erkennung aufrufen
In den folgenden Beispielen wird die Methode Sessions.detectIntent aufgerufen.
Zur API-Referenz für Sitzungen
REST
Java
Node.js
Python
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID: Ihre Google Cloud-Projekt-ID
AGENT_ID: Agent-ID
REGION_ID: Ihre Regions-ID
SESSION_ID: Ihre Sitzungs-ID
END_USER_INPUT: Endnutzereingabe
HTTP-Methode und URL:
POST https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/sessions/SESSION_ID:detectIntent
JSON-Text anfordern:
{
„queryInput“: {
„text“: {
„text“: „END_USER_INPUT“
},
„languageCode“: „en“
},
„queryParams“: {
„timeZone“: „America/Los_Angeles“
}
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
curl (Linux, macOS oder Cloud Shell)
PowerShell (Windows)
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
„responseId“: „38e8f23d-eed2-445e-a3e7-149b242dd669“,
„queryResult“: {
„text“: „I want to buy a shirt“,
„languageCode“: „en“,
„responseMessages“: [
{
„text“: {
„text“: [
„Ok, let’s start a new order.“
]
}
},
{
„text“: {
„text“: [
„I’d like to collect a bit more information from you.“
]
}
},
{
„text“: {
„text“: [
„What color would you like?“
]
}
},
{}
],
„currentPage“: {
„name“: „projects/PROJECT_ID/locations/us-central1/agents/133b0350-f2d2-4928-b0b3-5b332259d0f7/flows/00000000-0000-0000-0000-000000000000/pages/ce0b88c4-9292-455c-9c59-ec153dad94cc“,
„displayName“: „New Order“
},
„intent“: {
„name“: „projects/PROJECT_ID/locations/us-central1/agents/133b0350-f2d2-4928-b0b3-5b332259d0f7/intents/0adebb70-a727-4687-b8bc-fbbc2ac0b665“,
„displayName“: „order.new“
},
„intentDetectionConfidence“: 1,
„diagnosticInfo“: { … },
„match“: {
„intent“: {
„name“: „projects/PROJECT_ID/locations/us-central1/agents/133b0350-f2d2-4928-b0b3-5b332259d0f7/intents/0adebb70-a727-4687-b8bc-fbbc2ac0b665“,
„displayName“: „order.new“
},
„resolvedInput“: „I want to buy a shirt“,
„matchType“: „INTENT“,
„confidence“: 1
}
}
}

Produktion
Bevor Sie den Agent in der Produktion ausführen, sollten Sie die Best Practices für die Produktion implementieren.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Dialogflow CX Console – Übersicht
bookmark_border
Conversational Agents (Dialogflow CX) bietet eine Webbenutzeroberfläche namens Dialogflow CX Console (Dokumentation aufrufen, Konsole öffnen). Mit dieser Konsole können Sie Agents erstellen und testen. Sie stellt jeden Ablauf als Maschinendiagramm des Unterhaltungsstatus dar, wodurch komplexe Bots leichter zu entwerfen und zu verstehen sind.
Die Dialogflow CX Console unterscheidet sich von der Google Cloud Console (Dokumentation ansehen, Konsole öffnen). Die Dialogflow CX Console dient zum Verwalten von Conversational Agents (Dialogflow CX), während mit der Google Cloud Console Google Cloud-spezifische Conversational Agents (Dialogflow CX)-Einstellungen (z. B. für die Abrechnung) und andere Google Cloud -Ressourcen verwaltet werden.
In den meisten Fällen sollten Sie zum Erstellen von Agents die Dialogflow CX Console verwenden. Agents für komplexere Szenarien können Sie aber auch mit der Dialogflow API erstellen.
Kurzanleitung, Konzept und Anleitungen führen Sie durch die Schritte zur Verwendung der Console. Dieser Leitfaden bietet eine zusammenfassende Darstellung der Console.
Konsole verwenden
Mit der Konsole können Sie Projekte und Agents erstellen, verwalten, optimieren und testen. Sie können mit ihr:
Projekte erstellen.
Agents erstellen, die alle jene Einstellungen und Daten enthalten, die das Unterhaltungserlebnis definieren.
Abläufe und Seiten erstellen, die zur Unterhaltungssteuerung dienen.
Entitäten erstellen, die nützliche Daten aus den Eingaben der Endnutzer extrahieren.
Intents erstellen, die Endnutzereingaben kategorisieren.
Agent über den Simulator testen.
Und vieles mehr…
Projektauswahl
Wenn Sie die Konsole laden, müssen Sie ein Projekt auswählen. Die Benutzeroberfläche der Projektauswahl ermöglicht Folgendes:
Vorhandene Projekte auswählen
Neue Projekte erstellen

Agent-Selector
Nachdem Sie ein Projekt ausgewählt haben, müssen Sie einen Agent auswählen. Die Benutzeroberfläche zur Agent-Auswahl wird für Folgendes verwendet:
Vorhandene Agents auswählen
Neue Agents erstellen
Vordefinierte Agents erstellen
Agents exportieren und wiederherstellen
Agents löschen
Standorteinstellungen konfigurieren
Agents nach Standort filtern

Agent-Builder
Sobald ein Projekt und ein Agent ausgewählt wurden, wird der Agent-Builder geladen. Der Builder umfasst folgende Bereiche:

Konsolenmenü (1)
Über dieses Menü können Sie zwischen Konsolen wechseln.
Projekt und Agent auswählen (2)
Sie können diese Menüs verwenden, um das Projekt, den Agent oder die aktuell aktive Sprache für mehrsprachige Agents zu ändern.
Suchleiste und Aufgabenindikator (3)
Mit der Suchleiste search können Sie die Kernressourcen im Agent suchen, filtern und darauf zugreifen. Der Aufgabenindikator hourglass_full zeigt den Status von Aufgaben wie das Training an.
Tabs erstellen und verwalten (4)
Der Tab Build enthält Bereiche zur Verwaltung von Abläufen und Seiten. Wenn Sie im Ablaufbereich einen Ablauf wählen, werden die im Ablauf enthaltenen Seiten im Abschnitt „Seiten“ aufgeführt.
Der Tab Verwalten enthält dem Agent zur Verfügung stehende Ressourcen und Tools: Intents, Entitätstypen, Webhooks usw.
Grafikeinstellungen (5)
Diese Schaltflächen umfassen verschiedene Steuerelemente zur Anzeige und zur Interaktion mit der Agent-Grafik.
Agent-Einstellungen und Simulator-Schaltflächen (6)
Die Schaltfläche settingsAgent-Einstellungen ruft den Bereich der Agent-Einstellungen auf. Die Schaltfläche forumAgent testen ruft den Bereich Simulator auf.
Graph (7)
Die Grafik enthält eine visuelle Darstellung des ausgewählten Ablaufs, ähnlich einem Zustandsautomatendiagramm. Jeder Knoten in der Grafik stellt eine Seite oder die Ablaufstartseite dar. Durch Klicken auf einen Knoten können Sie ihn maximieren oder reduzieren. Wenn der Knoten maximiert ist, können Sie die Knotendaten bearbeiten.
Der erste Knoten der Grafik mit dem Namen Start ist die Startseite des Ablaufs.
Die Linien zwischen Knoten stellen einen möglichen Übergang dar. Sie sind farblich so gekennzeichnet:
Blau steht für Übergänge, die für Intent-Anforderungen oder für Intent- und Bedingungsanforderungen definiert sind.
Orange steht für Übergänge, die nur für Bedingungsanforderungen definiert sind.
Cyan steht für Übergänge, die für Event-Handler definiert sind.
Grau stellt andere als die oben beschriebenen Übergänge dar (z. B. eine Mischung der oben genannten Übergangstypen).
Wenn ein Übergang zu einem anderen Ablauf führt, wird der Zielablauf als Knoten angezeigt.
Bereiche für Bearbeitung und Simulation (8)
Wenn Sie Agent-Inhalte bearbeiten oder den Agent mit dem Simulator testen, werden auf der rechten Seite der Console inhaltsspezifische Bereiche angezeigt. Diese Felder können maximiert werden, um den verfügbaren Consolen-Bereich zu füllen, auf einen Abschnitt auf der rechten Seite der Console reduziert werden oder nach Abschluss des Vorgangs geschlossen werden.
Simulator
Der Simulator dient dazu, Ihren Agent zu testen. Sie können sich mit Ihrem Agent unterhalten und dabei Änderungen am Sitzungsstatus überwachen.
Sie können auch den Simulator verwenden, um ausführbare Testfälle zu erstellen.
Simulator-Einstellungen
Wenn Sie den Simulator zum ersten Mal öffnen, müssen Sie eine Agent-Umgebung oder Ablaufversionen und einen aktiven Ablauf auswählen. In den meisten Fällen sollten Sie die Entwurfsumgebung und den Standardstartablauf verwenden.
Über die Schaltflächen über dem Simulator haben Sie außerdem folgende Möglichkeiten:
Sie können Webhook-Aufrufe jederzeit mit der Schaltfläche aktivieren oder deaktivieren.
Aktivieren oder deaktivieren Sie teilweise Antworten.
Aktivieren oder deaktivieren Sie die Sentimentanalyse.
Simulatoreingabe
Bei der Interaktion mit dem Simulator stellen Sie die Endnutzereingabe als Text bereit. Drücken Sie dann die Eingabetaste oder klicken Sie auf die Schaltfläche „Send“ send. Zusätzlich zu reinem Text können Sie mithilfe des input-Selektors alternative Eingabetypen auswählen:
Parameter: Fügen Sie einen Parameterwert ein. Sie können neue Parameter angeben oder für vorhandene Parameter voreingestellte Werte angeben.
Ereignis: Rufen Sie ein Ereignis auf.
DTMF: Senden von Zweiton-Mehrfrequenzsignalisierung-Eingaben (Touch-Tone) für Telefonie-Interaktionen.
Simulatorsitzungsstatus
Wenn Sie mit dem Simulator eine Unterhaltung mit Ihrem Kundenservicemitarbeiter führen, wird der Sitzungsstatus links neben der Unterhaltung angezeigt. Der derzeit aktive Ablauf, die derzeit aktive Seite, ausgefüllte Parameterwerte und Ausführungsschritte werden angezeigt. Diese Informationen können Ihnen bei der Fehlerbehebung für einen Bot oder bei der Überprüfung seines Verhaltens in bestimmten Unterhaltungsszenarien helfen.
Simulatoreinschränkungen
Für den Simulator gelten die folgenden Einschränkungen:
Parameterwerte können nicht auf „null“ gesetzt werden.
Auf Unterhaltungen, die mit dem Simulator erstellt wurden, kann nicht über API-Methoden zugegriffen werden.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Analytics
bookmark_border
Die Dialogflow CX Console bietet einen Analysebereich mit verschiedenen Ansichten zum Überwachen der Leistungsdaten von Kundenservicemitarbeitern. Sie können beispielsweise Eskalierungen, Seiten mit vielen nicht übereinstimmenden Ergebnissen und Webhooks mit vielen Fehlern im Blick behalten. Sie können jede Ansicht nach Zeitraum filtern. Alle angezeigten Statistiken werden stündlich berechnet.
Mithilfe dieser Analyseansichten können Sie die Leistung Ihrer Kundenservicemitarbeiter anhand verschiedener Unterhaltungspfade nachvollziehen und entsprechende Maßnahmen ergreifen, um die Leistung zu verbessern.
Beschränkungen
Bei großen Kundenservicemitarbeitern kann das Laden von Analysedaten einige Zeit in Anspruch nehmen.
Interaktions-Logging aktivieren
Das Analysetool verwendet Daten aus Interaktionsprotokollen. Sie können diese Protokollierung mit der Agent-Einstellung Interaktions-Logging aktivieren aktivieren und deaktivieren.
Analysebereich öffnen
So öffnen Sie den Analysebereich:
Rufen Sie die Dialogflow CX Console auf.
Wählen Sie Ihr Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Analytics.
Über den Link oben können Sie auch auf Legacy Analytics zugreifen.
Gesprächsergebnisse
In dieser Ansicht werden die Anzahlen bestimmter Unterhaltungsergebnisse als Zeitreihendiagramm dargestellt.
Die folgenden Messwerte werden angezeigt:
Interaktion beenden
Die Anzahl der Unterhaltungen, die abgebrochen wurden.
Übergabe an Kundenservicemitarbeiter
Die Anzahl der Unterhaltungen, bei denen eine Eskalierung an einen Kundenservicemitarbeiter angefordert wurde.
Sonstiges
Eine Sicherungskategorie für den Fall, dass die Unterhaltung nicht an den Kundenservicemitarbeiter übergeben wurde und die Seite END SESSION nicht erreicht wurde . Wenn ein Nutzer beispielsweise „Hallo“ sagt und die Unterhaltung sofort schließt, wird die Unterhaltung unter Other kategorisiert.

Eskalierungen von Intents
In dieser Ansicht sehen Sie eine Tabelle mit den Intents mit der höchsten Anzahl an Eskalationen durch einen Kundenservicemitarbeiter. Außerdem wird ein Eskalationstrend für eine ausgewählte Absicht als Zeitreihendiagramm angezeigt. Wenn Sie bestimmte Intents als Hauptintent gekennzeichnet haben, können Sie die Ansicht auf diese Intents beschränken.
Die folgenden Messwerte werden angezeigt:
Sitzungen
Gesamtzahl der Sitzungen, in denen der Intent erkannt wurde.
Eskalationsrate
Prozentsatz der Sitzungen, bei denen eine Eskalierung an einen Kundenservicemitarbeiter angefordert wurde.
Abbiegen
Die Anzahl der Unterhaltungsrunden, in denen der Intent erkannt wurde. Für jede Unterhaltung kann es mehrere Übereinstimmungen für einen Intent geben.
Eskalierte Hauptabsicht
Prozentsatz der Eskalierungsanfragen für Sitzungen, bei denen der Intent der endgültige Haupt-Intent war.

Fehlerbehebung
Der Abschnitt zur Fehlerbehebung enthält mehrere Arten von Ansichten, die bei der Behebung häufiger Probleme mit Abläufen und Seiten helfen.
Fehlende Übergänge
In dieser Ansicht werden Seiten in Tabellenform angezeigt, bei denen ein vorhandener Intent eigentlich hätte abgeglichen werden sollen, dies aber aufgrund fehlender Pfade nicht geschehen ist.
Die folgenden Messwerte werden angezeigt:
Intent-Name
Der Name des Intents, der übereinstimmt hätte, wenn er in den Geltungsbereich fiele.
Abbiegen
Die Anzahl der Unterhaltungsrunden, die dem Intent zugeordnet werden sollten.

Seiten ohne Übereinstimmungen
In dieser Ansicht werden Seiten in Tabellenform angezeigt, sortiert nach den Raten für nicht übereinstimmende Ergebnisse.
Die folgenden Messwerte werden angezeigt:
Keine Abgleichsrate
Der Prozentsatz der Unterhaltungsrunden insgesamt, bei denen keine Übereinstimmung mit der Seite gefunden wurde.
Keine Übereinstimmung
Die Gesamtzahl der Unterhaltungsrunden, die zu keiner Übereinstimmung mit der Seite geführt haben.

Seiten ohne Antworten
In dieser Ansicht werden Seiten in Tabellenform angezeigt, für die keine Antwort des Kundenservicemitarbeiters erfolgt ist.
Die folgenden Messwerte werden angezeigt:
Leere Antworten
Die Anzahl der Interaktionen auf der Seite ohne Antwort des Kundenservicemitarbeiters.

Webhook-Fehler
In dieser Ansicht werden Webhook-Fehler in Tabellenform angezeigt. Sie können die Liste nach folgenden Kriterien organisieren:
Nach Name: Nach Webhook-Namen sortiert.
Nach Tag: Nach Webhook-Tags sortiert.
Anrufe
Die Anzahl der Webhook-Aufrufe.
Fehler
Die Anzahl der Webhook-Fehler ohne Zeitüberschreitungen.
Zeitüberschreitungsrate
Prozentsatz der Webhook-Aufrufe, bei denen eine Zeitüberschreitung aufgetreten ist.
Durchschnittliche Latenz
Durchschnittliche Latenz der Webhook-Aufrufung.

Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Seiten
bookmark_border
Eine Unterhaltung (Sitzung) in Conversational Agents (Dialogflow CX) kann als Zustandsmaschine beschrieben und dargestellt werden. Die Zustände einer Sitzung werden durch Seiten dargestellt.
Für jeden Ablauf definieren Sie mehrere Seiten, wobei die Gesamtheit der Seiten eine vollständige Unterhaltung zu den Themen ermöglicht, für die der Ablauf bestimmt ist. Es ist immer genaue eine Seite die aktuelle Seite. Diese aktuelle Seite wird als aktiv bezeichnet. Weiter wird der mit dieser Seite verknüpfte Ablauf als aktiv angesehen. Jeder Ablauf hat eine besondere Startseite. Wird ein Ablauf zum ersten Mal aktiviert, wird die Startseite zur aktuellen Seite. Pro Unterhaltungsrunde bleibt die aktuelle Seite entweder gleich oder wechselt zu einer anderen Seite.
Sie konfigurieren jede Seite so, dass vom Endnutzer Informationen erfasst werden, die für den von der Seite dargestellten Unterhaltungsstatus relevant sind. Sie können beispielsweise die Seiten (in Blau) im folgenden Diagramm erstellen, um einen Essensbestellungsablauf eines Pizza-Lieferdienst-Agents zu sehen. Der Startknoten des Diagramms stellt die Startseite des Essensbestellungsablaufs dar. Wenn der Ablauf abgeschlossen ist, wird zur Bestätigung gewechselt.

Lebenszyklus einer Seite
Sobald eine Seite aktiv ist, führt der Agent mehrere Schritte aus, die die Eintragsauftragsausfüllung, das Vorabausfüllen von Formularen, die Zustands-Handler-Evaluierung, die Aufforderung von Formularparametern, das Senden von Antwortnachrichten an den Endnutzer und entweder eine Seitenänderung oder eine Wiederholungsschleife umfassen:

Dieser Vorgang läuft so ab:
Wenn für die Seite eine Eintragsauftragsausführung vorhanden ist, wird sie aufgerufen. Alle von der Auftragsausführung bereitgestellten statischen Antworten werden der Antwortwarteschlange hinzugefügt.
Wenn die Teilantwort aktiviert ist, löscht Conversational Agents (Dialogflow CX) die Antwortwarteschlange und sendet alle Nachrichten in der Warteschlange als Teilantwort an den Aufrufer der Streaming API.
Wenn die Auftragsausführung einen Webhook hat, wird der Webhook aufgerufen, der zusätzliche Antworten an die Warteschlange anhängen kann. Diese zusätzlichen Antworten lösen nicht sofort eine Leerung der Antwortwarteschlange aus.
Wenn die Seite Formularparameter enthält, sind diese möglicherweise bereits ausgefüllt:
Alle Sitzungsparameter, deren Namen dem Namen eines Formularparameters entsprechen, werden in den Formularparameter kopiert.
Wenn eine Route einen Übergang zu dieser Seite ausgelöst hat und die Route einen übereinstimmenden Intent enthält, wird jeder Intent-Parameter mit demselben Namen wie ein Formularparameter in den Formularparameter kopiert.
Wenn Zustands-Handler dem Bereich entsprechen, werden sie gemäß den Regeln zur Handler-Evaluierungsreihenfolge ausgewertet. Dies kann Routen, Event-Handler oder Reprompt-Handler umfassen, die von der vorherigen Schleifenausführung aufgerufen wurden. Wenn ein Zustands-Handler aufgerufen wird, kann eine oder beide der folgenden Situationen auftreten:
Wenn für den Handler eine Auftragsausführung vorhanden ist, wird sie aufgerufen. Alle von der Auftragsausführung bereitgestellten statischen Antworten werden der Antwortwarteschlange hinzugefügt. Teilantworten und Webhook werden ebenfalls ausgeführt, wenn sie aktiviert sind.
Wenn ein Zielablauf oder eine Seite für den Handler vorhanden ist, wechselt die Sitzung zum Ziel und die Seite wird inaktiv.
Treffen alle folgenden Bedingungen zu, so wird der Antwortwarteschlange eine Formularparameteraufforderung hinzugefügt:
Die Seite enthält ein Formular.
Es müssen noch erforderliche Formularparameter ausgefüllt werden.
Einem Handler für erneute Eingabeaufforderungen wurde in Schritt 3 nicht gefolgt.
Teilantworten und Webhook werden ausgeführt, sofern sie aktiviert sind.
Die Nachrichten in der Antwortwarteschlange werden an den Endnutzer gesendet und der Agent wartet auf die Endnutzereingabe.
Wenn die Endnutzereingabe einen angeforderten Formularparameter bereitstellt, füllen Sie den Parameter aus. Fahren Sie mit Schritt 3 fort.
Navigation im Seitenlebenszyklus
Der Betrachter der Ausführungsschritte für den Simulator ermöglicht Ihnen, zwischen den Schritten für eine bestimmte Unterhaltungsrunde zu wechseln und die zugehörigen Agent-Builder-Elemente für jeden Schritt in den Fokus zu rücken. Im folgenden Beispiel löst die Endnutzereingabe „Ich möchte ein Auto mieten“ fünf Ausführungs- und Umstellungsschritte aus:
Der Viewer für Ausführungsschritte führt Sie zur Startseite der Unterhaltung für den ersten Schritt. In diesem Fall ist es die Standardstartseite.
Die Transition-Route für den Intent car_rental.reservation_create wird ausgelöst. Der Betrachter der Ausführungsschritte zeigt diese Route im Mittelpunkt, wo Sie sehen können, dass das Umstellungsziel die Seite Pickup Location ist.
Der Agent gibt die Seite Pickup Location ein.
Der Agent wertet die Eingabeauftragsausführung der Seite Pickup Location aus. Die Auftragsausführung ist leer, sodass nichts geschieht.
Der Agent versucht, den erforderlichen Formularparameter pickup_location zu erfassen, und der Endnutzer zeigt die erste Auftragsausführungsnachricht für diesen Parameter an.
Sie können auch die letzte Äußerung rückgängig machen und versuchen, andere Seitenübergänge zu testen.

Seite erstellen
Hinweis: Eine Seite wird erst dann in der Konsolengrafik angezeigt, wenn Umstellungen mit einem auf die Seite festgelegten Ziel erstellt wurden.
So erstellen Sie eine Seite:
Console
API
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie im Abschnitt Abläufe einen Ablauf für die Seite aus.
Klicken Sie im Abschnitt Seiten auf die Schaltfläche „add hinzufügen“.
Geben Sie einen Anzeigenamen für Ihren Agent ein
Klicken Sie neben dem Seitennamen auf die Schaltfläche „Einstellungen für more_vert“.
Wählen Sie Bearbeiten aus.
Geben Sie die Felder im angezeigten Bearbeitungsfeld ein.
Klicken Sie auf Speichern.
Seitendaten
So greifen Sie auf die Daten einer Seite zu:
Console
API
Öffnen Sie die Dialogflow CX Console.
Wählen Sie das Google Cloud Projekt für den Agenten aus.
Wählen Sie den Agent aus.
Klicken Sie im Abschnitt Abläufe auf den Ablauf.
Die Seiten des Ablaufs werden im Abschnitt Seiten ausgefüllt.
Klicken Sie neben dem Seitennamen auf die Schaltfläche „Einstellungen für more_vert“.
Wählen Sie Bearbeiten aus.
Geben Sie die Felder im angezeigten Bearbeitungsfeld ein.
Klicken Sie auf Speichern, um die Änderungen zu speichern.
Die folgenden Daten sind Seiten zugeordnet:
Anzeigename: Ein von Menschen lesbarer Name für Ihre Seite.
Einstiegs-Auftragsausführung (auch als Einstiegsdialog bezeichnet): Dies ist die Auftragsausführung, die aufgerufen wird, wenn die Seite erstmals aktiv wird.
Parameter: Dies sind die Parameterwerte in einem Seitenformular, das strukturierte Eingaben vom Endnutzer erfasst.
Routen: Diese Status-Handler können aufgerufen werden, wenn die Seite aktiv ist. Weitere Informationen finden sich unter Handler-Routen auf Seitenebene.
Routengruppen: Die Routen innerhalb dieser Gruppen können aufgerufen werden, wenn die Seite aktiv ist. Ausführliche Informationen dazu finden Sie unter Routengruppen
Ereignis-Handler: Diese Ereignis-Handler sind aufrufbar, wenn die Seite aktiv ist. Weitere Informationen finden Sie unter Event-Handler auf Seitenebene.
Seiteneinstellungen
Die folgenden Einstellungen sind für Seiten verfügbar:
Erweiterte Spracheinstellungen: Mit diesen erweiterten Spracheinstellungen können Sie optional dieselben Ablaufspracheinstellungen und Spracheinstellungen des Agents überschreiben.
Einstellungen für die Sprachanpassung: Die Einstellungen für die Sprachanpassung auf Seitenebene können optional dieselben Einstellungen für die Sprachanpassung des Ablaufs überschreiben. Eine ausführlichere Anleitung finden Sie unter Manuelle Sprachanpassung.
So rufen Sie die Seiteneinstellungen auf:
Console
API
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud Projekt aus.
Wählen Sie den Agent aus.
Bewegen Sie den Mauszeiger im Abschnitt Seiten über die Seite.
Klicken Sie auf die Schaltfläche „Optionen“ more_vert.
Wählen Sie Seiteneinstellungen aus.
Suchen oder bearbeiten Sie die Einstellungen.
Klicken Sie auf Speichern, um die Änderungen zu speichern.
Seiten löschen
So löschen Sie eine Seite:
Console
API
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie im Abschnitt Abläufe einen Ablauf für die Seite aus.
Klicken Sie im Abschnitt Seiten neben dem Seitennamen auf die Schaltfläche „Einstellungen für more_vert“.
Wählen Sie Löschen aus.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Playbooks
bookmark_border
Versionshinweise
Preview
This product or feature is subject to the „Pre-GA Offerings Terms“ in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available „as is“ and might have limited support. For more information, see the launch stage descriptions.
Hinweis: Die Funktion Playbook ist vom Dialogflow-SLA ausgenommen.
Ein Playbook ist der grundlegende Baustein generativer Agenten. Ein generativer Agent hat in der Regel viele Playbooks, wobei jedes Playbook für die Verarbeitung bestimmter Aufgaben definiert ist. Die Playbook-Daten werden dem LLM zur Verfügung gestellt, damit es die Informationen hat, die es zum Beantworten von Fragen und Ausführen von Aufgaben benötigt. Jedes Playbook kann Informationen bereitstellen, Abfragen an externe Dienste senden oder die Unterhaltungsverwaltung an einen Ablauf oder ein anderes Playbook übergeben, um untergeordnete Aufgaben zu erledigen.
Beschränkungen
Es gelten folgende Einschränkungen:
Bei Kundenservicemitarbeitern, die Playbooks verwenden, wird das Senden einer Anruf-Begleiter-SMS über die Route „Standard-Begrüßungs-Intent“ im Standardstartablauf nicht unterstützt. Sie können die Option für Anruf-Begleiter-SMS jedoch in Standardabläufen aktivieren.
Sprachunterstützung
Playbooks unterstützen dieselben Sprachen wie Gemini-Modelle.
Regionsunterstützung
Playbooks werden in den folgenden Regionen unterstützt:
global
asia-south1
asia-southeast1
asia-northeast1
australia-southeast1
eu (mehrere Regionen)
europe-west1
europe-west2
europe-west3
northamerica-northeast1
us (mehrere Regionen)
us-central1
us-east1
us-west1
Playbook-Daten
Ein Playbook besteht aus den folgenden Daten:
Playbook-Name: Ein prägnanter Name in natürlicher Sprache, der Entwicklern und dem LLM hilft zu verstehen, welche Aufgaben das Playbook übernimmt.
Ziele: Eine allgemeine Beschreibung dessen, was das Playbook erreichen soll.
Anleitung: Hier werden die Prozessschritte definiert, die zum Erreichen des Ziels erforderlich sind.
Beispiele: Beispielunterhaltungen, die effektiv als Few-Shot-Prompts für das LLM dienen
Parameter: Sie werden verwendet, um Informationen zu einer Unterhaltung zu speichern, z. B. Nutzereingaben, Nutzersysteminformationen und Ergebnisse von Aktionen.
Playbook-Typen
Wenn Sie ein Playbook erstellen, wählen Sie den gewünschten Playbook-Typ aus: Playbook für Aufgaben oder Playbook für Abläufe.
Playbooks für Aufgaben
Aufgaben-Playbooks sind der ursprüngliche Playbook-Typ. Sie werden verwendet, um komplexe Aufgaben in kleinere, wiederverwendbare Teilaufgaben aufzuteilen. Sie werden zum Modellieren von zusammengesetzten Unterhaltungsphasen verwendet, bei denen jede Phase über Eingabe- und Ausgabeparameter kommuniziert.
Im Folgenden wird ein Aufgaben-Playbook (Caller) gezeigt, das ein anderes Aufgaben-Playbook (Callee) aufruft:

Der Anrufer startet den Anruf.
Der Aufrufer stellt dem Gerufenen die erforderlichen Eingabeparameter zur Verfügung.
Der aufgerufene Code verarbeitet diese Informationen, führt die angegebene Funktion aus und gibt Ausgabeparameter zurück.
Der Aufrufer empfängt Parameter vom Gerufenen.
Jedes Playbook für Abläufe oder Aufgaben kann ein anderes Playbook für Aufgaben aufrufen, ein Playbook für Aufgaben kann jedoch kein anderes Playbook für Abläufe aufrufen.
Playbooks für Abläufe
Playbooks für Routineaufgaben sind eine neue Art von Playbook. Sie werden zum Modellieren sequenzieller Unterhaltungsphasen verwendet, wobei jede Phase vollständig und unabhängig ist. Sie können Aufgaben-Playbooks aufrufen, um größere Aufgaben in kleinere Teilaufgaben aufzuteilen, und zu anderen Routine-Playbooks oder ‑Abläufen wechseln.
Im Folgenden wird ein Ablauf-Playbook (A) gezeigt, das zu einem anderen Ablauf-Playbook (B) und dann zu einem Ablauf (C) übergeht:

Das Ablauf-Playbook A kann Sitzungsparameter beim Starten lesen und kurz vor dem Beenden Sitzungsparameter schreiben.
Das Routine-Playbook A wird beendet und es erfolgt ein Übergang zu Routine-Playbook B.
Das Routine-Playbook B kann Sitzungsparameter beim Starten lesen und kurz vor dem Beenden Sitzungsparameter schreiben.
Das Ablauf-Playbook B wird beendet und es wird zu Ablauf C gewechselt.
Ablauf C kann Sitzungsparameter lesen und schreiben.
Wenn ein Playbook für Abläufe nicht zu einem anderen Playbook oder Ablauf für Abläufe wechselt, kehrt die Sitzung zum letzten aktiven Ablauf zurück oder wird beendet, falls es keinen gibt.
Bei Routine-Playbooks gilt für die Parameterverwaltung Folgendes:
Wenn ein Playbook für eine Routine eingegeben wird, werden seinen Eingabeparametern Werte zugewiesen, die den Sitzungsparametern mit demselben Namen entsprechen.
Wenn ein Routine-Playbook beendet wird, generiert es Werte für seine Ausgabeparameter und weist sie Sitzungsparametern mit demselben Namen zu.
Standard-Playbook
Wenn Sie einen generativen Agenten mit der Conversational Agents Console erstellen, wird automatisch ein Standard-generatives Playbook erstellt.
Das Standard-Playbook ist der Ausgangspunkt für Unterhaltungen und unterscheidet sich daher in einigen wichtigen Punkten von anderen Playbooks:
Das Standard-Playbook erhält keine Zusammenfassung der vorangegangenen Gesprächsschritte.
Das Standard-Playbook kann keine Eingabeparameter definieren oder empfangen.
Playbooks importieren und exportieren
Nachdem Sie Playbooks mit der Konsole für Konversations-Agenten erstellt haben, können Sie diese Playbooks zur Verwendung in einem anderen Agenten exportieren. So exportieren Sie ein Playbook:
Rufen Sie die Playbook-Liste auf.
Klicken Sie auf die Schaltfläche „Exportieren“ für das Playbook, das Sie exportieren möchten.
Wählen Sie die Exportoptionen aus.
Klicken Sie auf Exportieren.
So importieren Sie ein zuvor exportiertes Playbook:
Rufen Sie die Playbook-Liste auf.
Klicken Sie auf Importieren.
Wählen Sie die Importoptionen aus.
Klicken Sie auf Importieren.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Validierung
bookmark_border
Damit Agent-Designer qualitativ hochwertige Agents erstellen können, bietet Conversational Agents (Dialogflow CX) eine Validierungsfunktion. Die Agent-Validierung wird bei Bedarf durchgeführt. Sie können die Agent-Validierung entweder über die Dialogflow-Konsole oder über die API anfordern, wenn Sie den Agent bearbeiten und die NLU-Modelle noch einmal trainieren. Sie können auch die neuesten Validierungsergebnisse abfragen, ohne eine neue Validierung durchzuführen.
Die Validierungsergebnisse dienen nur zur Information. Sie enthalten eine Liste klassifizierter Validierungsnachrichten, die Sie korrigieren können, um die Qualität und Leistung Ihres Agents zu verbessern. Die Agent-Validierung hat keinerlei Auswirkungen auf das Verhalten eines Agents. Sie können die Validierungsnachrichten ignorieren und den Agent trotzdem starten. Die Validierungsnachrichten umfassen die Qualität der NLU-Modelltrainingsdaten, einschließlich der Intents und Entitätstypen, sowie die Qualität der seitenbasierten Ablaufstruktur wie Übergangsregeln. Im Folgenden finden Sie einige Beispiele für Validierungsnachrichten:
Unterschiedliche Intents haben zu ähnliche Trainingsformulierungen.
Für den standardmäßig auszuschließenden Intent sind keine Negativbeispiele vorhanden.
This text is annotated in some training phrases but not others. (Dieser Text ist in einigen Trainingsformulierungen mit Anmerkungen versehen, in anderen jedoch nicht.)
Dasselbe Synonym wird für verschiedene Werte in einem Entitätstyp verwendet.
Dieser Intent-Routen-Bedingungs-Parameter ist nicht definiert.
Dieser Formularparameter ist mit dem Typ „sys.any“ definiert.
Ergebnisse ansehen
So greifen Sie auf die Validierungsergebnisse für Ihren Agent zu:
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie im Bereich Verwalten auf Validierung.
Wählen Sie einen Ablauf aus.
Es werden die neuesten Validierungsergebnisse angezeigt. Diese können veraltet sein.
Zum Auslösen neuer Ergebnisse klicken Sie oben im Bereich auf die Schaltfläche refresh Aktualisieren.
Um neue Ergebnisse nur für einen Ablauf auszulösen, klicken Sie in der Ergebniszeile des Ablaufs auf Aktualisieren ().
Geben Sie in das Feld Validierungsnachrichten suchen einen Suchbegriff ein, um Validierungsnachrichten zu filtern. Verwenden Sie den Operator „-“ vor dem Schlüsselwort, um die Validierungsnachrichten herauszufiltern. Beispiele:
Geben Sie „Rechnung“ ein, um nach Validierungsnachrichten zu suchen, die „Rechnung“ enthalten.
Geben Sie „-bill“ ein, um nach Validierungsnachrichten zu suchen, die NICHT „Rechnung“ enthalten.
Hinweis: Intent- und Entitätsprobleme werden erst aktualisiert, wenn das NLU-Training abgeschlossen ist.

Inline-Ergebnisse für Intents, Entitäten und Seiten
Validierungsnachrichten werden auch in den Listen der Intents, der Entitäten und der Seiten angezeigt. Beispiel: Auf der Seitenliste wird ein Symbol angezeigt, das den Schweregrad angibt, wenn Validierungsnachrichten für diese Seite vorhanden sind. Wenn Sie den Mauszeiger auf das Symbol bewegen, wird eine Kurzinfo mit detaillierten Validierungsmeldungen angezeigt.

Schweregradebenen
Bei der Validierung können die folgenden Schweregradebenen angezeigt werden:
Schweregrad
Beschreibung
INFO
Der Agent folgt nicht der Best Practice.
WARNUNG
Der Agent verhält sich eventuell nicht wie erwartet.
FEHLER
Beim Agent kann es zu Fehler kommen.

Einstellungen
Im Validierungsbereich können Sie Validierungsergebnisse nach Schweregradebene filtern oder indem Sie nach Text von Validierungsnachrichten suchen:
Verwenden Sie die Kästchen für die Schweregradebenen.
Geben Sie Text in das Suchfeld search ein.
Das Umschaltfeld Validierung im Visual Builder anzeigen im Validierungsbedienfeld steuert, ob die Validierungsergebnisse für Intents, Entitäten und Seiten inline angezeigt werden.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Parameter
bookmark_border
Parameter werden zum Erfassen und Referenzieren von Werten verwendet, die der Endnutzer während einer Sitzung bereitgestellt hat. Jeder Parameter hat einen Namen und einen Entitätstyp. Im Unterschied zu unstrukturierten Endnutzereingaben sind Parameter strukturierte Daten, mit denen auf einfache Weise ein bestimmter Ablauf ausgeführt werden kann oder Antworten erzeugt werden können.
Parameter definieren, referenzieren, festlegen und abrufen
Es gibt vier allgemeine Arten der Verwendung von Parametern:
Während der Entwicklung definieren: Während der Entwicklung verwenden Sie die Konsole oder die API, um Parameter zu definieren. Sie können beispielsweise einen Intent-Parameter definieren und in einer Trainingsformulierung verwenden, um die Endnutzereingabe zu bestimmen, die extrahiert werden soll.
Bei der Entwicklung referenzieren: Parameterverweise sind Variablen, die zur Laufzeit extrahierte Parameterwerte enthalten. Während der Entwicklung verwenden Sie die Konsole oder die API, um auf Parameter in verschiedenen Datentypen zu verweisen. Sie können beispielsweise auf einen Sitzungsparameter in einer statischen Auftragserfüllungsantwort für eine Route verweisen.
Zur Laufzeit festgelegt: Zur Laufzeit können der Dienst für Konversations-KI (Dialogflow CX), der Dienst, der die API aufruft, und Ihr Webhook-Dienst alle Parameterwerte festlegen. Beispiel: Der Conversational Agents-Dienst (Dialogflow CX) legt den Wert eines Intent-Parameters fest, wenn eine Endnutzereingabe dem Intent entspricht und die Eingabe Parameterdaten enthält.
Zur Laufzeit abrufen: Zur Laufzeit verweist Ihr Parameter auf die festgelegten Parameterwerte. Sie können die Parameterwerte mit der API oder einem Webhook abrufen. Wenn beispielsweise ein Intent zugeordnet und Ihr Webhook aufgerufen wird, empfängt Ihr Webhook-Dienst die Parameterwerte für den Intent.
Parameter benennen
Für die Benennung von Parametern gelten die folgenden Regeln:
Verwenden Sie die folgenden Zeichen: [A-Z], [a-z], [0-9], ., -, _
Bei Parameternamen wird nicht zwischen Groß- und Kleinschreibung unterschieden. Daher behandelt Conversational Agents (Dialogflow CX) Apple und apple als denselben Parameter. Der Webhook und der API-Clientcode sollten auch Parameternamen als nicht Groß- und Kleinschreibung behandeln, da es für Parameternamen, die von Conversational Agents (Dialogflow CX) zurückgegeben werden, keine Garantie gibt.
Wenn Sie Parameter mit derselben ID oder demselben Anzeigenamen in verschiedenen Intents oder Formularen erstellen, müssen der Entitätstyp und andere Einstellungen für alle Definitionen gleich sein. Wenn sich der Entitätstyp oder andere Parametereinstellungen unterscheiden, verwenden Sie für jede Definition eine eindeutige Parameter-ID oder einen eindeutigen Anzeigenamen.
Parameterwerttypen
Parameterwerte unterstützen mehrere Werttypen. Im Abschnitt Sitzungen unten wird beschrieben, wie Sie auf die einzelnen Parameterwerttypen verweisen. Die folgenden Typen werden unterstützt:
Typ
Beschreibung
Skalar
Ein einzelner numerischer oder Stringwert.
Zusammengesetzte Indexe
Ein JSON-Objekt, das durch Übereinstimmung mit einer zusammengesetzten Entität oder durch Ausfüllen eines Intent-Parameters mit den Feldern original und resolved ausgefüllt wird.
Liste
Eine Liste von Skalar- oder zusammengesetzten Werten, die für einen als Liste konfigurierten Parameter ausgefüllt werden. Weitere Informationen finden Sie unten unter Is List (Ist Liste).

Leere Strings und Nullwerte als Parameter
Sie können Stringparameterwerte auf „“ festlegen, wodurch der Parameter auf den leeren String gesetzt wird.
Sie können jeden Parameterwert auf null setzen, was bedeutet, dass der Parameter nicht festgelegt wurde.
Ursprüngliche Parameterwerte
Wird einer bestimmten Entität während der Laufzeit ein Text zugeordnet, wird dieser oft in einen Wert aufgelöst, der eine einfachere Verarbeitung erlaubt. Beispielsweise kann das Wort „Äpfel“ in der Endnutzereingabe für eine Obstentität als „Apfel“ aufgelöst werden.
Alle Werttypen für Intent-Parameterverweise können entweder auf den ursprünglichen oder den aufgelösten Wert verweisen.
Nur zusammengesetzte Werttypen für Sitzungsparameterreferenzen können auf den ursprünglichen Wert verweisen.
Intent-Parameter
Intents verwenden Parameter, um beim Abgleich von Intents von Endnutzern angegebene Daten zu extrahieren. Zum Definieren von Intent-Parametern werden folgende Daten verwendet:
Name (auch als ID oder Anzeigename bezeichnet): Ein Name zur Bezeichnung des Parameters.
Entitätstyp: der Entitätstyp, der dem Parameter zugeordnet ist
Ist-Liste: Wenn „true“, wird der Parameter als Liste von Werten behandelt.
Im Log entfernen: Wenn der Wert „true“ ist, werden vom Endnutzer bereitgestellte Parameterdaten entfernt.
Intent-Parameter definieren
Intent-Parameter werden während der Erstellung definiert, wenn Intent-Daten erstellt oder Trainingsformulierungen annotiert werden.
Intent-Parameter referenzieren
Hinweis: Aufgrund der kurzen Lebensdauer von Intent-Parameterwerten wird normalerweise die Verwendung von Sitzungsparameterreferenzen anstelle von Intent-Parameterreferenzen empfohlen.
Intent-Parameterverweise können in statischen Antwortnachrichten der Auftragsausführung von Intent-Routen verwendet werden.
Sie können entweder auf den ursprünglichen Wert oder auf den aufgelösten Wert verweisen.
Verwenden Sie eines der folgenden Formate, um für den aktuell zugeordneten Intent auf einen Parameter zu verweisen:
$intent.params.parameter-id.original
$intent.params.parameter-id.resolved
Wenn die Parameter-ID beispielsweise date lautet, können Sie auf den aufgelösten Wert als $intent.params.date.resolved verweisen.
Intent-Parameter festlegen
Wenn eine Endnutzereingabe zur Laufzeit einem Intent zugeordnet wird, wird jeder von einer Anmerkung verwendete Parameter für die zugehörige Trainingsformulierung von Conversational Agents (Dialogflow CX) festgelegt.
Die Auftragsausführung für eine Intent-Route kann mit einer Voreinstellung für den Auftragsausführungsparameter einen Intent-Parameterwert zur Laufzeit festlegen.
Intent-Parameter abrufen
Während der Unterhaltungsrunde, in der ein Intent zugeordnet wird, kann Ihr Code auf die Werte des Intent-Parameters zugreifen.
Interaktionen mit der API geben Intent-Parameterwerte zurück. Weitere Informationen finden Sie im Feld queryResult.parameters der Methode detectIntent für den Typ Session.
Zur API-Referenz-Sitzung
Die empfangenden Intent-Parameterwerte von Webhook. Weitere Informationen finden Sie in der Webhook-Anfrage im Feld intentInfo.parameters.
Formularparameter
Für jede Seite können Sie ein Formular definieren. Dies ist eine Liste von Parametern, die vom Endnutzer für die Seite erfasst werden sollen. Der Agent interagiert mit dem Endnutzer mehrere Unterhaltungsrunden lang, bis er alle erforderlichen Formularparameter, auch Seitenparameter genannt, erfasst hat. Der Agent erfasst diese Parameter in der auf der Seite definierten Reihenfolge. Für jeden Formularparameter geben Sie auch Aufforderungen an, mit denen der Agent diese Informationen vom Endnutzer anfordert. Dieser Vorgang wird als Ausfüllen von Formularen bezeichnet.
Sie können beispielsweise ein Formular erstellen, in dem der Name und die Telefonnummer des Endnutzers für eine Collect Customer Info-Seite erfasst werden.
Folgende Daten werden verwendet, um Formularparameter zu definieren:
Name der Konsolenoption
API-Feldkette
Beschreibung
Anzeigename
Page.form.parameters[].displayName
Ein Name zur Identifizierung des Parameters.
Entitätstyp
Page.form.parameters[].entityType
Entity (Entität): Der Entitätstyp für den Parameter.
Erforderlich
Page.form.parameters[].required
Gibt an, ob der Parameter erforderlich ist. Erforderliche Parameter müssen ausgefüllt werden, bevor das Ausfüllen des Formulars abgeschlossen ist. Der Agent fordert den Endnutzer auf, Werte einzugeben. Weitere Informationen finden Sie unten im Abschnitt Formularparameter festlegen.
Standardwert (nur sichtbar, wenn Erforderlich deaktiviert ist)
Page.form.parameters[].defaultValue
Der Standardwert eines optionalen Parameters. Weitere Informationen finden Sie unten im Abschnitt Formularparameter festlegen.
Is list
Page.form.parameters[].isList
Wenn „true“, wird der Parameter als Liste von Werten behandelt.
Im Log entfernen
Page.form.parameters[].redact
Bei Einstellung auf „true“ werden vom Endnutzer bereitgestellte Parameterdaten entfernt.
Erstauftragsausführung
Page.form.parameters[].fillBehavior.initialPromptFulfillment
Erste Aufforderungen in Form von Auftragsausführung, um einen erforderlichen Parameterwert vom Endnutzer anzufordern. Weitere Informationen finden Sie unten im Abschnitt Formularparameter festlegen.
Event-Handler für erneute Eingabeaufforderungen
Page.form.parameters[].fillBehavior.repromptEventHandlers
Handler für erneute Eingabeaufforderungen: Diese werden verwendet, wenn der Agent den Endnutzer nach einem fehlgeschlagenen Versuch zur erneuten Eingabe zum Ausfüllen des Parameters hinweisen muss. Weitere Informationen finden Sie unter Handler für die erneute Eingabeaufforderung zum Ausfüllen von Formularen. Wenn keine Ereignis-Handler für die erneute Eingabeaufforderung definiert sind, wird der Nutzer nach einem fehlgeschlagenen Versuch noch einmal mit den ursprünglichen Prompts aufgefordert.
DTMF
Nicht verfügbar
Weitere Informationen finden Sie im Abschnitt DTMF weiter unten.

Formularparameter definieren und verwalten
Formularparameter werden bei der Erstellung einer Seite zur Entwurfszeit definiert.
Um die Reihenfolge der Formularparameter mit der Konsole zu ändern, klicken Sie auf der Seite auf den Abschnitt Parameter und ziehen Sie die Parameterzeilen per Drag-and-drop in die Parametertabelle.
Wenn Sie einen Formularparameter löschen möchten, klicken Sie auf der Seite auf den Abschnittstitel Parameter, bewegen Sie den Mauszeiger auf einen Parameter und klicken Sie dann auf die Schaltfläche „Löschen“ delete.
Formularparameter referenzieren
Formularparameterreferenzen werden nicht direkt verwendet. Sie können nur den Ausfüllstatus einzelner Formularparameter oder des gesamten Formulars prüfen. Sie können diese Formularstatusreferenzen in einer Bedingungsanforderung einer Bedingungsroute verwenden.
Verwenden Sie die folgende Bedingung, um zu prüfen, ob das vollständige Formular der aktuellen Seite ausgefüllt ist:
$page.params.status = „FINAL“
Mit der folgenden Bedingung können Sie prüfen, ob ein bestimmter Formularparameter in der letzten Runde ausgefüllt wurde:
$page.params.parameter-id.status = „UPDATED“
Formularparameter festlegen
Formularparameterwerte können auf verschiedene Arten festgelegt werden. In den folgenden Unterabschnitten werden die einzelnen Mechanismen zum Festlegen von Formularparameterwerten beschrieben.
Standardparameterwerte
Sie können Standardwerte für optionale Formularparameter angeben. Wenn das Ausfüllen des Formulars beginnt, werden alle nicht festgelegten optionalen Formularparameter auf ihre Standardwerte gesetzt. Diese Werte können mit einigen der folgenden Mechanismen initialisiert oder überschrieben werden.
Wenn ein Parameter erforderlich ist, wird sein Standardwert ignoriert.
Formular ausfüllen
Hinweis: Sie können die Auftragsausführung für Seiteneingaben definieren, um den Endnutzer darüber zu informieren, dass Parameterwerte einzeln erfasst werden. Sie müssen jedoch eine Aufforderung für jeden erforderlichen Parameter separat.
Konversations-Agenten (Dialogflow CX) legen automatisch Parameterwerte fest, die der Endnutzer während des Ausfüllens eines Formulars angegeben hat. Der Agent erfasst die erforderlichen Parameter in der auf der Seite definierten Reihenfolge. Der Agent fordert den Endnutzer auf, die erforderlichen Werte mithilfe der anfänglichen Eingabeauftragsausführung für jeden erforderlichen Parameter einzugeben. Optionale Parameter lösen keine Aufforderungen aus.
Wenn ein erforderlicher Parameterwert nicht vom Endnutzer nach einer Agent-Eingabeaufforderung bereitgestellt wird, wird die erste Eingabeaufforderung wiederholt, es sei denn, in den Handlern für erneute Eingabeaufforderungen ist ein anderes Verhalten definiert. Wenn mehrere anfängliche Texteingaben definiert sind, entspricht das Agent-Verhalten dem Verhalten von Antworttexten der Auftragsausführung.
Hinweis: Wenn der Endnutzer während des Ausfüllens eines Formulars mehrere Parameterwerte in einer einzigen Unterhaltung bereitstellt, wird normalerweise nur ein Formularparameter festgelegt. Wenn dieselben Parameter jedoch als Intent-Parameter in einem Intent definiert sind, auf den im selben Ablauf verwiesen wird, können Conversational Agents (Dialogflow CX) mehrere Formularparameter in einer einzigen Unterhaltungsrunde festlegen. Dieses Verhalten ist eine Optimierung von NLU, die während einer Unterhaltung auftreten kann. Daher sollte dieses Verhalten nicht verwendet werden.
Weitergabe von Intent- und Sitzungsparametern
Wenn ein Parameter eines beliebigen Typs zur Laufzeit festgelegt wird, wird er in die Sitzung geschrieben und wird zu einem Sitzungsparameter.
Wenn eine Seite erstmalig aktiv wird und während ihres aktiven Zeitraums, wird jeder Formularparameter mit demselben Namen wie ein Sitzungsparameter automatisch auf den Sitzungsparameterwert gesetzt.
Dies kann mit einem zugeordneten Intent-Parameter in einer Intent-Route oder Parameterverteilung auftreten.
Die Intent- und Sitzungsparameterverteilung ist der einzige Mechanismus, um optionale Formularparameter auf Werte aus der Endnutzereingabe festzulegen. Dieser Mechanismus kann jedoch auch die erforderlichen Formularparameterwerte festlegen oder überschreiben.
Voreinstellungen für Auftragsausführungsparameter
Die Auftragsausführung für eine Route, einen Event-Handler oder eine erneute Aufforderung zur Formulareingabe kann eine Voreinstellung für einen Auftragsausführungsparameter verwenden, um einen Formularparameterwert zur Laufzeit festzulegen. Eine Voreinstellung für einen Auftragsausführungsparameter überschreibt einen Parameterwert, einschließlich der Standardwerte von Parametern.
Webhook-Parametereinstellung
Ihr Webhook kann Formularparameterwerte zur Laufzeit festlegen. Weitere Informationen finden Sie in der Webhook-Antwort im Feld pageInfo.formInfo.parameterInfo.
Formularparameter abrufen
Interaktionen mit der API geben Formularparameterwerte zurück. Weitere Informationen finden Sie im Feld queryResult.parameters der Methode detectIntent für den Typ Session.
Zur API-Referenz-Sitzung
Die empfangenden Formularparameterwerte von Webhook. Weitere Informationen finden Sie in der Webhook-Anfrage im Feld pageInfo.formInfo.parameterInfo.
Handler für die erneute Eingabeaufforderung zum Ausfüllen von Formularen
Handler für erneute Eingabeaufforderungen, auch als Event-Handler auf Parameterebene bezeichnet, werden verwendet, um das Verhalten von komplexen Parametern für erforderliche Parameter zu definieren. Handler für die erneute Eingabeaufforderung können beispielsweise verwendet werden, um die Eingabeaufforderung zu ändern, wenn der Endnutzer nach der ersten Eingabeaufforderung keinen Wert angibt, und um nach einer fehlgeschlagenen N-Eingabe zu einer anderen Seite zu wechseln.
Wenn keine Handler für die erneute Eingabeaufforderung definiert sind, wird die erste Eingabeaufforderung verwendet, um den Endnutzer nach Bedarf noch einmal aufzufordern.
Macht der Endnutzer unerwartete Eingaben, wird ein Ereignis vom Typ sys.no-match-* oder sys.no-input-* aufgerufen und alle für diese Ereignisse definierten Handler für die erneute Eingabeaufforderung werden aufgerufen.
Wie andere Ereignis-Handler ist ein Reprompt-Handler ein Zustands-Handler, der mit einer oder beiden der folgenden Optionen konfiguriert werden kann:
Eine Auftragsausführung zur Bereitstellung einer Nachricht an den Nutzer mit einer erneuten Eingabeaufforderung und/oder einer Parametervoreinstellung.
Ein Umstellungsziel zum Ändern der aktuellen Seite.
Sitzungsparameter
Wenn ein Parameter eines beliebigen Typs zur Laufzeit festgelegt wird, wird er in die Sitzung geschrieben und wird zu einem Sitzungsparameter. Diese Parameter werden nicht explizit bei der Entwicklung definiert. Sie können während einer Sitzung jederzeit auf diese Sitzungsparameter verweisen.
Sitzungsparameter referenzieren
Sitzungsparameterverweise können in den statischen Antwortnachrichten für die folgenden Arten von Auftragsausführungen verwendet werden:
Auftragsausführung für Seiteneingaben
Auftragsausführung für Routen
Auftragsausführung für Event-Handler
Auftragsausführung für Eingabeaufforderungen für Formulare
Auftragsausführungen für erneute Eingabeaufforderungen für Formulare
Die Verweise können auch in folgenden Tools verwendet werden:
Webhook-Headerwerte für die Authentifizierung.
Flexible Webhook-Anfragen zum Senden von Parameterwerten an einen Webhook.
Verwenden Sie folgende Formate, um auf einen Sitzungsparameter zu verweisen:
Skalar
Composite
Liste
So greifen Sie auf einen Parameter mit dem Entitätstyp „Skalar“ zu:
$session.params.parameter-id
Wenn die Parameter-ID beispielsweise date lautet, können Sie auf den Wert als $session.params.date verweisen.
Sitzungsparameter festlegen
Wenn das Ausfüllen des Formulars abgeschlossen ist, werden die ausgefüllten Parameter von Conversational Agents (Dialogflow CX) in die Sitzung geschrieben.
Die Auftragsausführung für eine Route, einen Event-Handler oder eine erneute Eingabeaufforderung für Formulare kann mit einer Voreinstellung für Auftragsausführungsparameter einen Sitzungsparameterwert zur Laufzeit festlegen.
Ihr Webhook kann Sitzungsparameterwerte zur Laufzeit festlegen. Weitere Informationen finden Sie in der Standard-Webhook-Antwort im Feld sessionInfo.parameters oder in der flexiblen Webhook-Antwort.
Durch Interaktion mit der API können Sitzungsparameterwerte festgelegt werden. Weitere Informationen finden Sie im Feld queryParams.parameters der Anfragemethode detectIntent für den Typ Session.
Zur API-Referenz-Sitzung
Sitzungsparameter abrufen
Interaktionen mit der API geben Sitzungsparameterwerte zurück Weitere Informationen finden Sie im Feld queryResult.parameters der Methode detectIntent für den Typ Session.
Zur API-Referenz-Sitzung
Die empfangenden Sitzungsparameterwerte von Webhook. Weitere Informationen finden Sie in der Webhook-Anfrage im Feld sessionInfo.parameters.
Parameterverteilung
Wenn eine Endnutzereingabe einen Parameterwert bereitstellt, kann der Parameter an andere Ebenen weitergegeben werden:
Wenn ein Intent-Parameter durch eine Intent-Übereinstimmung festgelegt wird, werden ähnliche Formularparameter für die aktive Seite auf denselben Wert gesetzt. Der Entitätstyp des Parameters wird durch die Intent-Parameterdefinition festgelegt.
Wenn ein Intent-Parameter durch einen Intent-Abgleich festgelegt wird oder ein Formularparameter beim Ausfüllen eines Formulars festgelegt wird, wird der Parameter zu einem Sitzungsparameter.
DTMF für Telefonieintegrationen
Sie können DTMF (Dual-Tone-Multifrequenzsignalisierung) für einen Parameter aktivieren und konfigurieren. Nach der Aktivierung kann ein Endnutzer für einen Kundenservicemitarbeiter, der eine Telefonieintegration verwendet, das Telefon-Keypad verwenden, um Parameterwerte bereitzustellen.
Zur Vermeidung von Mehrdeutigkeit kann die DTMF-Eingabe sowohl in normalen als auch in DTMF-spezifischen Formen (empfohlen) interpretiert werden:
Die normale Form ist einfach die Keypad-Werte, die vom Endnutzer eingegeben werden. z. B. 123#.
Die DTMF-spezifische Form konvertiert die Eingabe in dtmf_digits_[digits], wobei [digits] die ursprünglichen DTMF-Ziffern sind, wobei * durch star und # durch pound ersetzt wird. Beispiel: 123# wird als dtmf_digits_123pound interpretiert.
Beim Abgleich von Entitätstypen für einen Parameter versucht Conversational Agents (Dialogflow CX), sowohl die normalen als auch die DTMF-spezifischen Formen abzugleichen. Wenn ein Entitätstyp für die DTMF-Eingabe verwendet wird, sollten Sie Synonyme wie dtmf_digits_123 definieren, um den NLU-Abgleich zu verbessern.
Wenn die DTMF-Eingabe nicht die Beendigungsbedingung erfüllt (entweder hat sie die maximale Ziffernlänge nicht erreicht oder wurde sie nicht durch die Ziffer beendet wurde), wartet der Conversational Agents (Dialogflow CX)-Agent auf weitere Eingabe. Wenn in diesem Zeitraum das Zeitlimit ohne Sprache ausgelöst wird, ruft der Agent stattdessen ein Ereignis ohne Eingabe auf. Wenn nur eine Sprachäußerung erkannt wird, stimmt der Agent mit der Spracheingabe überein. Wenn sowohl die Sprach- als auch die DTMF-Eingabe erkannt werden, wird die Spracheingabe verworfen und nur die DTMF-Eingabe berücksichtigt.
So aktivieren und passen Sie DTMF für einen Parameter an:
Console
Aktivieren Sie Erweiterte Einstellungen in den Agent-Sprach- und IVR-Einstellungen, falls Sie diese noch nicht aktiviert haben.
Erstellen Sie einen Seitenparameter.
Wählen Sie im Parameterbereich die Option DTMF aktivieren aus.
Legen Sie für Maximale Ziffern die maximale Anzahl von Ziffern fest, die der Endnutzer für diesen Parameter angeben kann.
Setzen Sie Ziffer beenden auf den Keypad-Wert, der die DTMF-Eingabe für den Parameter beendet. Für diese Einstellung ist die Verwendung von # üblich. Die Ziffer wird nicht zur Conversational Agents-Abfrage (Dialogflow CX) im Agent hinzugefügt. Wenn die Ziffer also # ist und die Eingabe 123# ist, lautet die tatsächliche Abfrageeingabe „123“.
Beim Erstellen Ihres Agents können Sie DTMF-Eingabe im Simulator testen.
Intelligente Endpunktermittlung
Wenn die intelligente Weiterleitung für den Kundenservicemitarbeiter aktiviert ist, können Sie das Verhalten der intelligenten Weiterleitung für einen numerischen Parameter anpassen.
Legen Sie Mindestanzahl der Ziffern fest, um dem Smart Endpointer zu signalisieren, dass er warten soll, bis alle Ziffern erfasst wurden.
Wenn Sie Transkripte korrigieren auswählen, werden häufige Transkriptionsfehler bei Ziffern korrigiert, um die Spracherkennung von Ziffern zu verbessern. Dies wird nur für Anfragen unterstützt, bei denen ein Sprachcode „en“ oder „en-*“ angegeben ist.
Legen Sie mit Wartezeitüberschreitung fest, wie lange Konversations-Agenten (Dialogflow CX) zusätzlich warten, bis der Nutzer weitere Eingaben macht.
Parameter auf Flussebene
Parameter auf Flussebene können als Voreinstellungen für Auftragsausführungsparameter oder Formularparameter definiert werden. Auf diese Parameter kann nur verwiesen werden, solange der Ablauf, in dem sie definiert sind, aktiv ist. Sie werden nicht in den Sitzungsparametern gespeichert.
Verwenden Sie die folgende Syntax, um einen Parameter auf Flussebene zu definieren oder darauf zu verweisen:
$flow.parameter-name
Beispiel: Wenn der Parametername date lautet, können Sie den Parameter als $flow.date definieren oder darauf verweisen.
Die Verwendung eines $-Präfixes bei der Definition von Parametern unterscheidet sich von anderen Parametertypen, bei denen $ nicht für Parameterdefinitionen verwendet wird.
Beispiel für eine Parameterdefinition auf Flussebene:
Gültigkeitsdauer von Parameterwerten auf Flussebene
Hinweis: Wenn Sie dafür sorgen möchten, dass Parameterwerte während einer Sitzung beibehalten werden, ist es einfacher, Sitzungsparameter zu verwenden.
In bestimmten Fällen ist es jedoch wichtig zu wissen, wie Parameterwerte auf Flussebene beibehalten (oder verworfen) werden, wenn ein Fluss inaktiv wird und dann wieder aktiv wird.
Ob Parameterwerte auf Ablaufebene bei Inaktivität eines Ablaufs beibehalten werden, hängt vom Ablaufstack und den Ablaufinstanzen im Stack ab.
Wenn Ablauf A über ein bestimmtes Übergangsziel zu Ablauf B wechselt, bleibt Ablauf A (übergeordneter Ablauf) im Stapel, behält seine Parameterwerte auf Ablaufebene bei und dem Stapel wird eine neue Instanz von Ablauf B (untergeordneter Ablauf) hinzugefügt.
Wenn ein untergeordneter Ablauf über ein symbolisches Übergangsziel (z. B. END_FLOW) zu einem übergeordneten Ablauf zurückkehrt, wird der untergeordnete Ablauf aus dem Stapel entfernt, alle Parameterwerte auf Ebene des untergeordneten Ablaufs werden verworfen und alle Parameterwerte auf Ebene des übergeordneten Ablaufs bleiben erhalten.
Mit einer Reihe von Übergängen mit bestimmten Übergangszielen kann der Ablaufstapel mehrere Instanzen eines Ablauftyps enthalten. Jede Instanz des Ablauftyps hat eindeutige Parameterwerte auf Ablaufebene. Beispiel: A1 -> B1 -> C1 -> B2, wobei A, B und C Flusstypen sind und die Zahlen Instanzen dieser Flusstypen bezeichnen. In diesem Beispiel sind B1 und B2 unterschiedliche Instanzen von Ablauf B und haben eindeutige Parameter auf Ablaufebene.
Beispiele:
Übergänge
Ergebnis
Ablauf A (A1) wird aktiv.
Ablauf B (B1) wird über ein bestimmtes Umstellungsziel aktiviert.
Ablauf B wechselt über ein symbolisches Umstellungsziel zurück zu Ablauf A (A1), der ihn gestartet hat.
Bei Ablauf A bleiben die Parameterwerte erhalten.
Ablauf A (A1) wird aktiv.
Ablauf B (B1) wird über ein bestimmtes Umstellungsziel aktiviert.
In Ablauf B wird über ein bestimmtes Umstellungsziel zu einer neuen Instanz von Ablauf A (A2) gewechselt.
Die neue Instanz von Ablauf A (A2) oben im Stack hat keinen Zugriff auf die Parameterwerte von Ablauf A (A1) unten im Stack.
Ablauf A (A1) wird aktiv.
Ablauf B (B1) wird über ein bestimmtes Umstellungsziel aktiviert.
Ablauf A (A1) wird über ein symbolisches Umstellungsziel aktiviert.
Ablauf B (B2) wird über ein bestimmtes Umstellungsziel aktiviert.
In Ablauf B (B2) werden keine Parameterwerte beibehalten, die nach dem zweiten Übergang (B1) festgelegt wurden, während er aktiv war.

Parameter auf Anfrageebene
Parameter auf Anfrageebene sind kurzlebige Parameter, die von Conversational Agents (Dialogflow CX) erstellt werden. Sie können nur während des Lebenszyklus der aktuellen Anfrage referenziert werden und werden nicht in den Sitzungsparametern gespeichert.
Parameter auf Anfrageebene werden von Conversational Agents (Dialogflow CX) für die folgenden Funktionen generiert.
Integrierte Parameter
Sie können auf die verschiedenen Daten zugreifen, die mit der Anfrage verknüpft sind:
Referenz
Beschreibung
$request.agent-id
Die Kennung des Kundenservicemitarbeiters.
$request.session-id
Die Kennung der Sitzung.
$request.language
In QueryInput.language_code angegebener Sprachcode.
$request.resolved-language
Der tatsächliche Sprachcode, der vom Kundenservicemitarbeiter während der Bearbeitung verwendet wird. Die ermittelte Sprache kann von der in der Anfrage angegebenen Sprache abweichen. Wenn der Kundenservicemitarbeiter beispielsweise nur „en“ unterstützt, in der Anfrage aber „en-US“ angegeben ist, wird „en“ als Sprache ermittelt.
$request.user-utterance
Die in der Anfrage angegebene Äußerung des aktuellen Nutzers.
$request.last-agent-utterance
Die letzte vom Kundenservicemitarbeiter gesendete Äußerung.

Benutzerdefinierte Nutzlast
Wenn QueryParameters.payload festgelegt ist, können Sie über $request.payload.param-id auf den entsprechenden Parameter zugreifen.
Sentimentanalyse
Wenn die Sentimentanalyse aktiviert ist, sind die folgenden Sentimentreferenzen verfügbar:
Referenz
Typ
Beschreibung
$request.sentiment.score
Zahl
Stimmungswert zwischen -1,0 (negative Stimmung) und 1,0 (positive Stimmung).
$request.sentiment.magnitude
Zahl
Gibt die allgemeine Stärke der (sowohl positiven als auch negativen) Stimmung zwischen 0,0 und +inf an. Anders als der „Score“-Wert ist dieser Wert nicht angepasst. Jeder Ausdruck von Stimmung in der Endnutzereingabe, ob positiv oder negativ, trägt zum Magnitude-Wert bei. Längere Eingaben können eine größere Größe haben.
$request.sentiment.succeeded
Boolesch
„True“, wenn die Stimmungsanalyse erfolgreich war, andernfalls „false“.

Entfernen von Parametern
Hinweis: Derzeit kann nur Text von Nutzern entfernt werden.
Für jeden Intent- oder Formularparameter können Sie die Parameterentfernung aktivieren, um Endnutzer-Laufzeitparameterdaten aus Logs und dem internen Speicher von Conversational Agents (Dialogflow CX) zu entfernen. Entfernende Parameter werden in Logs als $parameter-name_redacted angezeigt.
Beispiel: Der Endnutzer gibt „My address is 1600 Amphitheatre Parkway“ ein. Dies führt dazu, dass ein Address-Parameter an „1600 Amphitheatre Parkway“ gesendet wird. Der protokollierte Text lautet „My address is $address_redacted“.
So aktivieren Sie die Parameterentfernung:
Console
API
Klicken Sie beim Erstellen oder Aktualisieren eines Parameters das Kästchen Redlog im Log entfernen an.
Alternativ können Sie alle Parameter eines bestimmten Entitätstyps entfernen.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Tests
bookmark_border
Tests werden verwendet, um die Leistung mehrerer Ablaufversionen (Variantenversionen) mit einer Kontrollversion (in der Regel eine Produktionsversion) zu vergleichen, während Live-Traffic verarbeitet wird. Sie können jeder Ablaufversion einen Teil des Live-Traffics zuweisen und die folgenden Messwerte überwachen:
Enthalten: Anzahl der Sitzungen, die END_SESSION erreicht haben, ohne unten weitere Messwerte auszulösen. Nur für Agents verfügbar, die eine Telefonieintegration verwenden.
Live-Agent-Handoff-Rate: Anzahl der Sitzungen, die an einen Live-Agent übergeben werden.
Callback Rate: Anzahl der Sitzungen, die von einem Endnutzer neu gestartet wurden. Nur für Agents verfügbar, die eine Telefonieintegration verwenden.
Verworfene Rate: Anzahl der Sitzungen, die von einem Endnutzer verworfen wurden. Nur für Agents verfügbar, die eine Telefonieintegration verwenden.
Ende der Sitzung: Anzahl der Sitzungen, die END_SESSION erreicht haben.
Gesamtzahl der Übereinstimmungen: Gesamtzahl der Vorkommen eines Ereignisses ohne Übereinstimmung.
Gesamtzahl der Unterhaltungsrunden: Gesamtzahl der Unterhaltungsrunden (eine Endnutzereingabe und eine Agent-Antwort gilt als Unterhaltungsrunde).
Durchschnittliche Anzahl von Runden: Durchschnittliche Anzahl der Runden.
Vorbereitung
So bereiten Sie einen Test vor:
Entscheiden Sie, welcher Ablauf für den Test verwendet werden soll. Sie können nicht mehrere Tests für einen einzelnen Ablauf ausführen. Achten Sie daher darauf, dass Sie Ihren Agent in mehrere Abläufe partitioniert haben.
Erstellen Sie mehrere Versionen für Ihren Ablauf. Die Unterschiede zwischen den einzelnen Versionen können klein oder groß sein, je nachdem, was Sie vergleichen möchten.
Entscheiden Sie, wie viele Zugriffe Ihrem Test zugewiesen werden sollen. Wenn Sie geringfügige Änderungen testen, beginnen Sie möglicherweise mit einem höheren Traffic. Bei großen Änderungen, die zu Unterbrechungen führen können, sollten Sie Ihrem Test eine kleine Menge von Traffic zuweisen.
Test erstellen
So erstellen Sie einen Test:
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Projekt aus, um die Agent-Auswahl zu öffnen.
Wählen Sie den Agent aus, um den Agent-Builder zu öffnen.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Tests, um das Steuerfeld „Tests“ zu öffnen.
Wählen Sie den Tab Status aus.
Klicken Sie auf Erstellen.
Geben Sie eine Beschreibung ein.
Wählen Sie die Umgebung aus, aus der Sie den Test ausführen möchten.
Wählen Sie den Ablauf für den Test aus.
Geben Sie optional die Anzahl der Tage ein, an denen der Test automatisch beendet wird.
Geben Sie die Version des Steuerungsflusses und den Prozentsatz des Traffics ein, der an die Steuerungsversion gesendet wird.
Geben Sie eine bis vier Variantenablaufversionen und den Prozentsatz des Traffics an die Variantenversion ein.
Klicken Sie optional auf Automatische Einführung und Schritte aktivieren, um den Traffic schrittweise in den Variantenablauf zu übertragen. Ein automatisierter Test basiert auf Schritten, bei denen es sich um eine Zeitdauer handelt, in der ein Prozentsatz des Traffics auf den Variantenablauf erhöht wird. Beim automatischen Rollout wird nur ein Variantenablauf unterstützt.
Unter Rolloutregeln können Sie eine oder mehrere bedingte Regeln festlegen, um festzulegen, wie der Test die Schritte durchlaufen soll.
Wenn Sie Mindestens eine Regel abgleichen auswählen, wird der Test mit dem nächsten Schritt fortgesetzt, wenn mindestens eine Regel und die Zeitdauer für den aktuellen Schritt erfüllt sind.
Wenn Sie Alle Regeln abgleichen auswählen, wird der Test mit dem nächsten Schritt fortgesetzt, wenn alle Regeln und die Zeitdauer für den aktuellen Schritt erfüllt sind.
Wenn Sie Nur Schritte auswählen, wird der Test gemäß der Zeitdauer für jeden Schritt fortgesetzt.
Definieren Sie unter Schritte erhöhen einen Prozentsatz des Traffics, der dem Variantenablauf zugewiesen werden soll, und einer Zeitdauer für jeden Schritt. Die Standarddauer jedes Schritts beträgt 6 Stunden.
Wählen Sie Bedingungen beenden aus, um eine oder mehrere Bedingungen festzulegen, unter denen kein Traffic mehr an den Variantenablauf gesendet werden soll. Einen beendeter Test kann nicht neu gestartet werden.
Klicken Sie auf Speichern.
Test starten und stoppen
Sie können einen gespeicherten Test starten oder einen laufenden Test manuell beenden. Wenn Sie einen Test beenden, wird die Traffic-Zuordnung abgebrochen und der Traffic wird in seinen ursprünglichen Zustand zurückgesetzt.
Hinweis: Wenn Sie einen Test beenden, während er ausstehend ist, sind keine Ergebnisse verfügbar. Wenn Sie einen Test beenden, während er ausgeführt wird, sind die Ergebnisse möglicherweise nicht eindeutig oder fehlen.
So starten oder beenden Sie einen Test:
Steuerfeld für Tests öffnen.
Wählen Sie den Tab Status aus.
Klicken Sie für einen Test in der Liste auf Starten oder Beenden.
Tests verwalten
Hinweis: Sie können die Zuordnung der Variantenzugriffe während der Ausführung eines Tests ändern.
Sie können Tests jederzeit bearbeiten oder löschen:
Steuerfeld für Tests öffnen.
Wählen Sie den Tab Status aus.
Klicken Sie in der Liste auf das Dreipunkt-Menü more_vert für einen Test.
Klicken Sie auf Bearbeiten oder Löschen.
Status von Tests überwachen
Alle Tests finden unabhängig vom Status im Bereich „Tests“. Tests können vier verschiedene Status haben:
Entwurf: Der Test wurde erstellt, aber noch nicht ausgeführt.
Ausstehend: Der Test wurde kürzlich gestartet, es sind jedoch noch keine Ergebnisse verfügbar.
Wird ausgeführt: Der Test wird ausgeführt und Zwischenergebnisse sind verfügbar.
Abgeschlossen: Der Test wurde abgeschlossen, da er automatisch oder manuell beendet wurde.
Testergebnisse ansehen
So rufen Sie die Testergebnisse auf:
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Projekt aus, um die Agent-Auswahl zu öffnen.
Wählen Sie den Agent aus, um den Agent-Builder zu öffnen.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Tests, um das Steuerfeld „Tests“ zu öffnen.
Wählen Sie den Tab Ergebnisse aus.
Wählen Sie eine Umgebung aus und testen Sie die Ergebnisse.
Grüne farbige Ergebnisse deuten auf ein gutes Ergebnis hin, rot hingegen auf ein weniger vorteilhaftes Ergebnis. Beachten Sie, dass in einigen Fällen höhere/niedrigere Zahlen nicht unbedingt besser sind (hohe Ausstiegsrate / niedrige Ausstiegsrate).
Hinweis: Es wird die Meldung „Kein Testergebnis“ angezeigt, wenn nicht genügend Unterhaltungen über die einzelnen Varianten des Tests stattgefunden haben.
Beschränkungen
Es gelten folgende Einschränkungen:
Die Agent-Einstellung Interaktions-Logging aktivieren muss aktiviert sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Git-Export/-Wiederherstellung
bookmark_border
Versionshinweise
Hinweis :Im Februar 2025 wurde eine neue Version dieser Integration veröffentlicht. Nutzer der alten Version können Tokens ohne Verwendung von Secrets bereitstellen. Die folgende Dokumentation bezieht sich hauptsächlich auf die neue Version.
Konversations-Agents (Dialogflow CX) können mit mehreren Git-Anbietern (z. B. GitHub, GitLab und Bitbucket) integriert werden. Mit dieser Integration können Sie Ihren Bot ganz einfach in JSON exportieren, um ihn bei einem Git-Anbieter bereitzustellen, und ihn von einem Git-Anbieter abrufen, um ihn wiederherzustellen. Das JSON-Exportformat, das an einen Git-Anbieter gepusht wird, ist der entpackte Inhalt der ZIP-Datei des exportierten Agents.
Mit dieser Funktion können Sie die Funktionen zur Quellcodeverwaltung eines Git-Anbieters nutzen, z. B.:
Überprüfung von Änderungen an Kundenservicemitarbeitern mithilfe von Code-Review-Tools
Mit Differenztools Agenten-Differenzen prüfen
Zusammenführungen
Beschränkungen
Es gelten folgende Einschränkungen:
[Nur alte Integrationsversion] Die GitHub APIs haben eine Beschränkung für die Anzahl der Dateien, die in einem einzelnen Commit aktualisiert werden können. Wenn die Anzahl der Dateien 500 übersteigt, können Sie möglicherweise nicht von Conversational Agents (Dialogflow CX) aus auf GitHub pushen. In solchen Fällen können Sie den Agenten als ZIP-Datei exportieren und die Agentendateien mit der Git-Befehlszeile auf Ihrem Computer auf GitHub pushen. Diese Einschränkung wird in einer späteren Version für Konversations-Agenten (Dialogflow CX) behoben.
Selbst gehostete Repositories mit privatem Zugriff auf GitHub werden nicht unterstützt, da Conversational Agents (Dialogflow CX) nicht auf diese Repositories zugreifen können.
Das Git-Repository darf keine anderen Dateien als die vom Agentenexport exportierten Agentendateien enthalten. Alle anderen Dateien im Repository werden bei jedem Push entfernt.
Konfiguration
Wenn Sie diese Funktion konfigurieren möchten, müssen Sie ein Zugriffstoken von Ihrem Git-Anbieter abrufen, es in Secret Manager speichern und die Secret-Ressource für Conversational Agents (Dialogflow CX) bereitstellen:
Zugriffstoken
So rufen Sie ein Zugriffstoken von Ihrem Git-Anbieter ab:
GitHub
GitLab
Bitbucket
Sie benötigen ein persönliches GitHub-Token. Wenn Sie ein detailliertes persönliches Zugriffstoken verwenden, benötigen Sie die folgenden Berechtigungen:
Repository-Berechtigungen > Inhalte: Lesen und Schreiben
Repository-Berechtigungen > Metadaten: Nur-Lesen (sollte automatisch ausgewählt werden, nachdem die Berechtigung „Inhalte“ ausgewählt wurde)
Secret Manager
Nachdem Sie ein Zugriffstoken haben, müssen Sie ein Secret für Ihr Token erstellen:
Aktivieren Sie die Secret Manager API.
Erstellen Sie ein Secret.
Konfiguration von Conversational Agents (Dialogflow CX)
So konfigurieren Sie diese Integration für Conversational Agents (Dialogflow CX):
Gewähren Sie dem Dialogflow-Dienst-Agent Zugriff auf Secret Manager. Weisen Sie dem Dienstkonto gcp-sa-dialogflow.iam.gserviceaccount.com in Ihrem Kundenservicemitarbeiterprojekt die Rolle Secret Manager Secret Accessor zu. Weitere Informationen finden Sie unter IAM-Rolle erteilen.
Öffnen Sie die Konfiguration der Git-Integration:
Konversations-Agenten-Konsole
Öffnen Sie die Einstellungen, indem Sie rechts oben auf das Einstellungssymbol klicken.
Scrollen Sie nach unten und klicken Sie auf Git-Integration hinzufügen.
Dialogflow CX-Konsole
Klicke auf den Tab Verwalten.
Klicken Sie im Abschnitt Testing & Deployment (Testen und Bereitstellen) auf Git.
Klicken Sie auf Neu erstellen.
Geben Sie die Konfigurationsdetails an:
Geben Sie Folgendes ein:
Anzeigename für die GitHub-Verbindung.
Git-Repository-URL (z. B. https://github.com/.git).
Fügen Sie Git-Branches hinzu, mit denen Ihr Kundenservicemitarbeiter interagieren wird. Sie können einen Branch als Standard-Branch festlegen, indem Sie neben ihm auf das Sternsymbol klicken.
Das Secret für das Zugriffstoken, also die Secret-Version, die Sie im Format projects//secrets//versions/* für eine bestimmte Version oder projects//secrets//versions/latest für die neueste Version erstellt haben.
Klicken Sie auf Verbinden.
Es kann eine Minute dauern, bis der Git-Dienst bereit ist. In der Console werden Benachrichtigungen angezeigt.
Push- und Wiederherstellung
Nach der Konfiguration können Sie Ihren Agenten zu/von Git pushen/pullen.
Über die Schaltfläche Push können Sie Ihren Agenten exportieren und einen Commit für den im Drop-down-Menü „Git-Branch“ ausgewählten Git-Branch ausführen. Dieser Commit besteht aus dem gesamten Agenten und nicht aus bestimmten Änderungen. Außerdem werden alle vorhandenen Dateien im Repository gelöscht.
Nutzer mit der Rolle Dialogflow Reader können Push-Vorgänge zu Git-Repositories ausführen. Um unerwünschte Push-Benachrichtigungen zu verhindern, konfigurieren Sie diese Kundenservicemitarbeiter mit schreibgeschützten persönlichen Zugriffstokens.
Über die Schaltfläche Wiederherstellen können Sie die Agent-Daten aus dem im Drop-down-Menü „Git-Branch“ ausgewählten Git-Branch abrufen und Ihren Conversational Agent (Dialogflow CX) anhand dieser Daten wiederherstellen. Dadurch wird Ihr Agent auf die gleiche Weise überschrieben wie bei jeder Agentwiederherstellung.
Anwendungsbeispiel
Im folgenden Beispiel wird gezeigt, wie diese Funktion von mehreren Personen verwendet werden kann, um einem Produktionsmitarbeiter verschiedene Änderungen vorzuschlagen.
Angenommen, Ihr Agent verwendet die folgenden Git-Zweigstellen:
Prod: Branch für deinen Produktions-Agenten
Dev1: Branch für die Entwicklung von Kundenservicemitarbeitern
Dev2: ein weiterer Branch für die Entwicklung von Kundenservicemitarbeitern
Nutzer 1 möchte Änderungen an einem Kundenservicemitarbeiter vorschlagen und führt dazu die folgenden Schritte aus:
Exportieren Sie den Produktions-Agenten in einen neuen Agenten.
Nehmen Sie die gewünschten Änderungen an diesem Kundenservicemitarbeiter-Text vor.
Testen Sie die Änderungen.
Übertragen Sie den geänderten Agenten auf den Dev1-Zweig.
Erstellen Sie einen Zusammenführungsantrag für den Prod-Zweig.
Nutzer 2 möchte Änderungen an einem Kundenservicemitarbeiter vorschlagen und führt dazu die folgenden Schritte aus:
Exportieren Sie den Produktions-Agenten in einen neuen Agenten.
Nehmen Sie die gewünschten Änderungen an diesem Kundenservicemitarbeiter-Text vor.
Testen Sie die Änderungen.
Übertragen Sie den geänderten Agenten per Push auf den Dev2-Zweig.
Erstellen Sie einen Zusammenführungsantrag für den Prod-Zweig.
Nutzer 3 überprüft die Zusammenführungsanfragen beider Nutzer und führt die folgenden Schritte aus:
Konflikte beheben.
Genehmigte Änderungen werden übernommen.
Der Produktions-Git-Branch wird im Produktions-Konversations-Agenten (Dialogflow CX) wiederhergestellt.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Cloud Logging
bookmark_border
Dialogflow API-Anfragen und -Antworten können optional für Cloud Logging für Ihren Agent protokolliert werden. Sie können auch die Region steuern, in der diese Logs gespeichert werden.
Cloud Logging aktivieren
Informationen zum Aktivieren oder Deaktivieren von Cloud Logging für Ihren Agent finden Sie in den Logging-Optionen in den allgemeinen Einstellungen des Agents.
Cloud-Logs aufrufen
Nachdem Sie Cloud Logging für einen Agent aktiviert haben, können Sie diese Logs mit dem Cloud Logs Explorer durchsuchen.
Logformat
Ausführliche Informationen zum Logformat finden Sie unter Logeintragsstruktur.
Im Folgenden finden Sie eine unvollständige Liste von Logeintragstiteln, die von Dialogflow verwendet werden:
Dialogflow-Anfrage
Dialogflow-Antwort
Dialogflow-Webhook-Anfrage
Dialogflow-Webhook-Antwort
Dialogflow-Webhook-Fehler
Anfrage- und Antwortlogeinträge haben das Feld jsonPayload im JSON-Format. Der Inhalt dieser Nutzlast ähnelt der Struktur ähnlicher Dialogflow API-Anfragen und -Antworten wie in der Dialogflow-Referenzdokumentation definiert.
Regionalisierung
Standardmäßig werden Dialogflow-Cloud-Logeinträge an den globalen _Default log-Bucket weitergeleitet. Wenn Sie Anforderungen an den Datenstandort für Ihr Projekt haben, können Sie Ihre Logs an einen regionsspezifischen Log-Bucket weiterleiten. Eine Anleitung dazu finden Sie unter Projektlogs mit Log-Buckets regionalisieren.
Hinweis: Beim Weiterleiten von Logsenken können Sie
LOG_ID(„dialogflow-runtime.googleapis.com/requests“) zum Filtern von Dialogflow-Cloud-Logs verwenden.
Beschränkungen
Wenn die Dialogflow-Antwort das Limit für die Größe von Cloud-Logeinträgen überschreitet, wird das Feld QueryResult.diagnosticInfo nicht in die Protokolle aufgenommen.
Pro Unterhaltung werden maximal 500 Sätze protokolliert.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Interaktionen mit einer Einbindung
bookmark_border
Mit einer Integration werden Endnutzerinteraktionen für Sie abgewickelt. Sie müssen nur einen Agent erstellen, optional einen Webhook implementieren und die Integration konfigurieren.
In dieser Anleitung erfahren Sie, wie Sie mit der Integration von Dialogflow CX Messenger eine einfache Textchat-Benutzeroberfläche für Ihren Agent bereitstellen.
Hinweise
Wenn Sie keine Integration verwenden möchten, können Sie diese Kurzanleitung überspringen.
Bevor Sie diese Anleitung lesen, sollten Sie mit Folgendem vertraut sein:
Grundlagen von Abläufen
Einrichtungsschritte ausführen
Führen Sie die Schritte in der Kurzanleitung Agent mithilfe von Flows erstellen aus. In den folgenden Schritten wird derselbe Agent weiterverwendet. Wenn Sie diesen Agent nicht mehr haben, können Sie ihn herunterladen und wiederherstellen.
Einrichtung
Hinweis: Mit den folgenden Schritten wird eine Integration erstellt, die nicht authentifizierten Kundenservicemitarbeitern den Zugriff auf Abfragen ermöglicht. Eine Anleitung zum Erstellen einer authentifizierten Integration finden Sie in der Dialogflow CX Messenger-Dokumentation.
Hinweis: Achten Sie darauf, dass die Abrechnung für Ihr Projekt aktiviert ist, bevor Sie die Integration testen.
So richten Sie den nicht authentifizierten Zugriff auf Ihren Dialogflow CX Messenger-Agenten ein:
Rufen Sie die Dialogflow CX Console auf.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie im linken Seitenleistenmenü auf Integrations.
Klicken Sie unter Dialogflow CX Messenger auf Verbinden.
Ein Konfigurationsdialogfeld wird geöffnet.
Wenn die Integration für diesen Kundenservicemitarbeiter bereits eingerichtet wurde, wird ein einbetzbarer HTML-Code angezeigt. Unabhängig davon, ob Sie eine Authentifizierung wünschen oder nicht, klicken Sie unten im Dialogfeld auf die Schaltfläche Deaktivieren, damit Sie die Einstellungen im nächsten Schritt neu konfigurieren können.
Wählen Sie eine Umgebung aus
Wählen Sie Unauthenticated API (Nicht authentifizierte API) aus.
Wählen Sie einen Stil aus.
Optional: Domaineinschränkung
Klicken Sie auf Unauthentifizierte API aktivieren.
Im Dialogfeld wird der HTML-Code angezeigt, der in Ihre Website eingebettet werden kann. Kopieren Sie diesen Code.
Klicken Sie auf Fertig.
Einbetten
Fügen Sie den oben kopierten Einbettungscode in eine Webseite auf Ihrer Website ein. Die HTML-Elemente

Weitere Informationen finden Sie unter setQueryParameters.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Messenger von Meta
bookmark_border
Preview
This product or feature is subject to the „Pre-GA Offerings Terms“ in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available „as is“ and might have limited support. For more information, see the launch stage descriptions.
Mit der Meta Messenger-Integration können Sie einen Meta Messenger-Bot erstellen, der mit Ihren Endnutzern interagiert.
Hinweis: Wenn Sie eine Drittanbieterintegration verwenden, werden Anfragen und Endnutzerdaten sowohl an Google als auch an den Drittanbieter gesendet. Für das Bearbeiten dieser Anfragen durch Google gelten die Nutzungsbedingungen, das SLA, die Preise und die Kontingente für Ihre Agent-Edition. Für das Bearbeiten dieser Anfragen durch den Drittanbieter gelten die Nutzungsbedingungen, das SLA, die Preise und die Kontingente des Drittanbieters.
Funktionsweise
Hinweis: Diese Integration unterstützt Workplace von Meta nicht.
So funktioniert die Integration:
Sie erstellen eine Meta-App, die die Meta Messenger Platform verwendet.
Sie konfigurieren die Integration für Konversations-Agenten (Dialogflow CX) und die Meta App so, dass sie miteinander kommunizieren.
Die Integration für Konversations-Agenten (Dialogflow CX) sendet Nachrichten mithilfe der Meta Messenger API an den Endnutzer.
Die Conversational Agents-Integration (Dialogflow CX) empfängt Nachrichten vom Endnutzer und fungiert so als Meta-Webhooks für die Messenger-Plattform.
Einrichtung
Hinweis: Achten Sie darauf, dass die Abrechnung für Ihr Projekt aktiviert ist, bevor Sie die Integration testen.
So richten Sie die Integration ein:
Folgen Sie der Anleitung zum Erstellen einer Meta-App: Meta App Development.
Richten Sie die Meta App für die Verwendung der Meta Messenger Platform ein. Führen Sie die Schritte in der Dokumentation zu Meta Webhooks für die Messenger-Plattform aus. Dadurch wird Folgendes möglich:
Fügen Sie Ihrer Meta-App die Messenger Platform hinzu.
Ihre App für eine Meta-Seite abonnieren. Achten Sie darauf, dass messages und messaging_postbacks im Seitenabo aktiviert sind.
In diesem Schritt erhalten Sie ein Zugriffstoken. Kopieren Sie diesen Wert. Dieses Token wird verwendet, um die Integration über die Konsole für Conversational Agents (Dialogflow CX) zu konfigurieren.
Warten Sie aber mit dem Konfigurieren des Webhooks und dem Testen Ihrer Integration.
Konfigurieren Sie die Integration über die Konsole für konversationelle Agents (Dialogflow CX):
Rufen Sie die Dialogflow CX Console auf.
Klicken Sie im linken Bereich auf den Tab Verwalten.
Klicken Sie im linken Seitenleistenmenü auf Integrations.
Klicken Sie auf die Schaltfläche Verbinden in der Kachel Meta Messenger.
Ein Konfigurationsdialogfeld wird geöffnet:
App-Secret: Geben Sie das App-Secret aus den grundlegenden Einstellungen für das App-Dashboard ein.
Bestätigungstoken: Sie können jedes beliebige private Token eingeben. Kopieren Sie diesen Wert. Damit wird der Meta Messenger-Webhook konfiguriert.
Page access token (Seitenzugriffstoken): Geben Sie das Zugriffstoken ein, das Sie während der obigen Einrichtung der Meta-App kopiert haben.
Schaltfläche „Jetzt starten“ aktivieren: Weitere Informationen finden Sie im Abschnitt Schaltfläche „Jetzt starten“.
Webhook URL (Webhook-URL): Kopieren Sie diesen Wert. Damit wird der Meta Messenger-Webhook konfiguriert.
Start: Klicken Sie auf diese Option, um den Integrationsdienst für Ihren Agent zu starten.
Schließen Sie die Einrichtung der Meta App ab und testen Sie sie. Führen Sie die Schritte in der Dokumentation zu Meta Webhooks für die Messenger-Plattform aus, um Folgendes zu tun:
Konfigurieren Sie den Meta-Webhook für Ihre App. Verwenden Sie die Werte Webhook-URL und Bestätigungstoken, die Sie oben kopiert haben. Aktivieren Sie messages und messaging_postbacks im Seitenabo.
Testen der Anwendung
Ereignisse
Die folgenden Ereignisse werden durch diese Integration aufgerufen: Sie können benutzerdefinierte Event-Handler erstellen, um festzulegen, was passiert, wenn die Ereignisse ausgelöst werden.
Termin
Beschreibung
FACEBOOK_WELCOME
Wird ausgelöst, wenn ein Endnutzer auf die Schaltfläche Erste Schritte mit Meta Messenger klickt.
FACEBOOK_MEDIA
Wird ausgelöst, wenn die Nachricht eines Endnutzers Anhänge enthält (z. B. Audio, Bild, Video usw.).

Schaltfläche „Jetzt starten“
So richten Sie die Meta Messenger-Startschaltfläche ein:
Aktivieren Sie die Schaltfläche Jetzt starten, wenn Sie diesen Integrationsdienst aktivieren.
Dieser Integrationsdienst aktiviert die Schaltfläche für Sie durch Aufrufen der Messenger Profile API.
curl -X POST \
-H „Content-Type: application/json“ \
-d ‚{„get_started“: {„payload“: „FACEBOOK_WELCOME“}}‘ \
„https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}“

Erstellen Sie einen benutzerdefinierten Event-Handler für das FACEBOOK_WELCOME-Ereignis.
So testen Sie sie:
Löschen Sie die vorherige Unterhaltung mit Ihrer Meta-Seite (falls zutreffend).
Die Schaltfläche Jetzt starten wird nur für neue Unterhaltungen angezeigt.
Starten Sie eine neue Unterhaltung mit Ihrer Meta-Seite.
Klicken Sie auf Jetzt starten und prüfen Sie die Antwort des benutzerdefinierten Ereignis-Handlers.
Sie können jederzeit die Messenger Profile API aufrufen, um die Schaltfläche Jetzt starten zu verwalten. Dies kann zum Testen hilfreich sein.
Die folgende Anfrage prüft beispielsweise den Status der Schaltfläche Get started (Jetzt starten):
curl -X GET \
„https://graph.facebook.com/v10.0/me/messenger_profile?fields=get_started&access_token=${PAGE_ACCESS_TOKEN}“

Die folgende Anfrage deaktiviert die Schaltfläche Jetzt starten:
curl -X DELETE \
-H „Content-Type: application/json“ \
-d ‚{„fields“: [„get_started“]}‘ \
„https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}“

Rich-Media-Antworten
Rich-Media-Antworten werden unterstützt überBenutzerdefinierte Nutzlast inAuftragsausführung finden Sie weitere Informationen. Informationen zum Nachrichtenformat finden Sie unter Send API Parameters Message Object.
Die folgende benutzerdefinierte Nutzlast stellt beispielsweise eine einfache Textnachricht bereit:
{
„text“: „Hello, world“
}

Die folgende benutzerdefinierte Nutzlast stellt eine Bildnachricht bereit:
{
„attachment“: {
„type“: „image“,
„payload“: {
„url“: „https://example.com/test.jpg“
}
}
}

Kanalspezifische Antworten
Nachdem Sie die kanalspezifischen Antworten konfiguriert haben, wird der Kanal DF_CX_FB_MESSENGER automatisch verwendet, wenn der Kundenservicemitarbeiter auf Meta Messenger-Nachrichten antwortet.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Dialogflow CX Messenger
bookmark_border
Versionshinweise
Diese Integration bietet ein anpassbares Chat-Dialogfeld für Ihren Kundenservicemitarbeiter, das in Ihre Website eingebettet werden kann.

Einrichtung
Diese Integration kann entweder authentifizierten oder nicht authentifizierten Endnutzer-Agenten den Abfragezugriff ermöglichen.
Unbestätigte Einrichtung
Hinweis: Achten Sie darauf, dass die Abrechnung für Ihr Projekt aktiviert ist, bevor Sie die Integration testen.
So richten Sie den nicht authentifizierten Zugriff auf Ihren Dialogflow CX Messenger-Agenten ein:
Rufen Sie die Dialogflow CX Console auf.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie im linken Seitenleistenmenü auf Integrations.
Klicken Sie unter Dialogflow CX Messenger auf Verbinden.
Ein Konfigurationsdialogfeld wird geöffnet.
Wenn die Integration für diesen Kundenservicemitarbeiter bereits eingerichtet wurde, wird ein einbetzbarer HTML-Code angezeigt. Unabhängig davon, ob Sie eine Authentifizierung wünschen oder nicht, klicken Sie unten im Dialogfeld auf die Schaltfläche Deaktivieren, damit Sie die Einstellungen im nächsten Schritt neu konfigurieren können.
Wählen Sie eine Umgebung aus
Wählen Sie Unauthenticated API (Nicht authentifizierte API) aus.
Wählen Sie einen Stil aus.
Optional: Domaineinschränkung
Klicken Sie auf Unauthentifizierte API aktivieren.
Im Dialogfeld wird der HTML-Code angezeigt, der in Ihre Website eingebettet werden kann. Kopieren Sie diesen Code.
Klicken Sie auf Fertig.
Authentifizierte Einrichtung
So richten Sie den authentifizierten Zugriff auf Ihren Dialogflow CX Messenger-Agenten ein:
Rufen Sie die Dialogflow CX Console auf.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie im linken Seitenleistenmenü auf Integrations.
Klicken Sie unter Dialogflow CX Messenger auf Verbinden.
Ein Konfigurationsdialogfeld wird geöffnet.
Wenn die Integration für diesen Kundenservicemitarbeiter bereits eingerichtet wurde, wird ein einbetzbarer HTML-Code angezeigt. Unabhängig davon, ob Sie eine Authentifizierung wünschen oder nicht, klicken Sie unten im Dialogfeld auf die Schaltfläche Deaktivieren, damit Sie die Einstellungen im nächsten Schritt neu konfigurieren können.
Wählen Sie eine Umgebung aus
Wählen Sie Authorized API (Autorisierte API) aus.
Wählen Sie einen Stil aus.
Optional: Domaineinschränkung
Klicken Sie auf Autorisierte API aktivieren.
Im Dialogfeld wird der HTML-Code angezeigt, der in Ihre Website eingebettet werden kann. Kopieren Sie diesen Code.
Klicken Sie auf Fertig.
Richten Sie den OAuth-Client ein:
Erstellen Sie einen OAuth-Zustimmungsbildschirm für Ihre Organisation. Fügen Sie https://www.googleapis.com/auth/cloud-platform als erforderlichen Bereich hinzu.
Erstellen Sie eine OAuth 2.0-Client-ID. Geben Sie unter Autorisierte JavaScript-Quellen die HTTP-Quellen an, die Ihren Agenten hosten und abfragen dürfen. Beispiel: https://your-company.com
Geben Sie Endnutzern die Berechtigung, Ihren Bot zu fragen. Fügen Sie jeden Ihrer Endnutzer oder eine Gruppe als Principal mit den Rollen Dialogflow API Client und Service Usage Consumer hinzu.
Hinweis :Wenn ein Endnutzer die authentifizierte Integration zum ersten Mal verwendet, wird er aufgefordert, auszuwählen, welche Bereiche zulässig sind. Sie müssen die Cloud API zulassen.
Einbetten
Fügen Sie den oben kopierten Einbettungscode in eine Webseite auf Ihrer Website ein. Die HTML-Elemente

project-id=“my-project-id“
agent-id=“my-agent-id“
language-code=“en“
>

Auftragsausführung
Es gibt viele Arten von Antwortvorlagen für die Auftragsausführung, die Sie für die Antworten von Kundenservicemitarbeitern verwenden können.
Feedback zu Antworten
Wenn Feedback zu Antworten aktiviert ist, werden dem Chatdialog standardmäßig die Schaltflächen „Mag ich“ thumb_up und „Mag ich nicht“ thumb_down hinzugefügt. Während der Unterhaltung kann ein Endnutzer auf diese Schaltflächen klicken, um Feedback zu den Antworten des Kundenservicemitarbeiters zu geben. Wenn der Nutzer „Mag ich nicht“ auswählt, kann er optional einen Grund für das negative Feedback angeben.
Benutzerdefinierte Feedbackkomponente
Wenn Sie ein benutzerdefiniertes Feedbackelement angeben möchten, muss auf der Website ein neues benutzerdefiniertes Element definiert werden. Damit das Feedback gesendet werden kann, muss das Element ein df-custom-submit-feedback-clicked-Ereignis ausgeben. Das enthaltene detail-Feld muss ein String sein.
class CustomFeedbackElement extends HTMLElement {
constructor() {
super();
// It is not strictly required but recommended to contain the custom
// element in a shadow root.
this.renderRoot = this.attachShadow({mode: ‚open‘});
}

// Web component Lifecycle method.
connectedCallback() {
const wrapper = document.createElement(‚div‘);

// Build the component as required.
const button = document.createElement('button');
button.innerText = 'Submit';
button.addEventListener('click', () => {
  this._onSubmitClick();
});
wrapper.appendChild(button);

this.renderRoot.appendChild(wrapper);

}

// Called when Submit button is clicked.
_onSubmitClick() {
const event = new CustomEvent(„df-custom-submit-feedback-clicked“, {
// detail may be any string,
// this will be sent to the backend to be stored.
detail: JSON.stringify({
„usefulness“: 2,
„accuracy“: 3,
}),
// Required to propagate up the DOM tree
// https://developer.mozilla.org/en-US/docs/Web/API/Event/bubbles
bubbles: true,
// Required to propagate across ShadowDOM
// https://developer.mozilla.org/en-US/docs/Web/API/Event/composed
composed: true,
});
this.dispatchEvent(event);
}
}

(function() {
// Registers the element. This name must be „df-external-custom-feedback“.
customElements.define(‚df-external-custom-feedback‘, CustomFeedbackElement);
})();
Debugging
So testen Sie den Agent lokal mit Dialogflow CX Messenger:
Betten Sie das Dialogflow CX Messenger-Element wie oben beschrieben in eine Seite ein.
Starten Sie einen lokalen HTTP-Server für diese Seite mit einem bestimmten Port.
Greifen Sie unter http://localhost:port_number auf diese Seite zu.

Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Best Practices für das Design von Voice-Agents
bookmark_border
Dieser Leitfaden enthält Best Practices speziell für das Entwerfen von Sprach-Agenten. Wenn Sie einen Sprach-Agent entwerfen, besteht das Ziel darin, Nutzer (Endnutzer) bei der Erledigung einer Aufgabe zu unterstützen, ohne an einen menschlichen Mitarbeiter zu eskalieren. Die Nutzer sollten das Gefühl haben, dass sie eine natürliche, interaktive und kooperative Unterhaltung mit dem Sprach-Agent haben.
Sehen Sie sich auch den allgemeinen Leitfaden zum allgemeinen Agent-Design für alle Agenttypen und den Leitfaden zu den Best Practices für die Verwendung des Dialogflow-Dienstes an.
Qualität des Agents messen
Erfassen Sie die folgenden Messwerte, um die Qualität der Nutzerfreundlichkeit Ihres Agents zu messen:
Misroute: wie viele Anrufer an der falschen Stelle landen
Lösung für den ersten Anruf: Anzahl der Aufrufe, die beim ersten Anruf oder Kontakt gelöst werden.
Durchschnittliche Bearbeitungszeit: Gibt an, wie lange es dauert, das Problem des Nutzers zu lösen.
Kundenzufriedenheit: Wie hoch Ihr Sprach-Agent bei einer Nutzerbefragung bewertet.
Anzahl der Runden: Die Anzahl der Austausche, die erforderlich sind, um die Aufgabe des Nutzers zu erreichen.
Nutzerabwanderung: Gibt an, wie oft Nutzer die Unterhaltung beenden.
Spracherkennung
Die folgenden Tipps können Ihrem Agent helfen, Endnutzersprache zu erkennen:
Der Agent sollte den Endnutzer dazu auffordern, lange Wortgruppen oder vollständige Sätze zu verwenden. Dies verbessert die Erkennungsqualität.
Erwägen Sie die Verwendung eines Webhooks, um Endnutzereingaben zu überprüfen, die möglicherweise nicht erkannt werden oder validiert werden müssen.
Verwenden Sie No-Match-Ereignisse, um den Endnutzer aufzufordern, langsamer und klarer zu sprechen.
Unterhaltungsstruktur
Eine Unterhaltung mit einem Sprach-Agent ist im Allgemeinen in folgender Reihenfolge organisiert:
Aktivität
Beispiel
Hinweise
Eröffnungsaktivität
Der Nutzer meldet sich an oder ruft Ihr Callcenter an.
Sprach-Agent: Hallo, hier ist Reise Inc. Wie kann ich Ihnen helfen?
Der Voice-Agent startet die Unterhaltung mit einer Begrüßungsnachricht.
Hauptsequenz
Nutzer: Ich möchte ein Flugticket buchen.
Sprach-Agent: OK, wo ist es?
Nutzer: Guatemala am 19. Mai, 21:00 Uhr.
Sprach-Agent: OK, wir haben Ihnen ein Ticket für Guatemala am 19. Mai, 21:00 Uhr, gebucht.
Die Aufgabe wird vom Nutzer definiert und vom Sprach-Agent abgeschlossen. Es kann mehrere Runden dauern, bis der Sprach-Agent alle erforderlichen Informationen erfasst hat.
Aktivität schließen
Sprach-Agent: Gibt es noch etwas, bei dem ich Ihnen helfen kann?
Nutzer: Nein
Sprach-Agent: OK, danke für Ihr Gespräch.
Der Nutzer ist bereit, die Unterhaltung zu beenden, wenn seine Anfrage ausgeführt wurde.

Willkommensnachricht
Überlegen Sie sich, wie Sie die erste Nachricht für den Nutzer erstellen und überlegen, wie Sie so schnell wie möglich zum ersten Thema gelangen. Die Begrüßung sollte kurz und eindeutig sein. Einige Vorschläge:
Beantworten Sie den Anruf mit Formulierungen wie „Hallo“.
Ermitteln Sie den Sprach-Agent mit Formulierungen wie „Das ist der Sprach-Agent/Assistent von Unternehmen XYZ“.
Formulierungen wie „Wie kann ich Ihnen helfen?“ anzeigen
Zusätzliche Informationen können Nutzer frustrieren und dazu führen, dass sie an einen menschlichen Mitarbeiter eskalieren. Möglicherweise müssen Sie die Begrüßungsnachricht jedoch aus rechtlichen Gründen erweitern, um den Nutzer beispielsweise darüber zu informieren, dass die Unterhaltung aufgezeichnet werden kann.
Vermeiden Sie Informationen, die die Unterhaltung unnatürlich oder unausgeglichen machen. Beispiel:
Was Sie tun sollten:
Was Sie nicht tun sollten:
Modellieren Sie die Sprache, die Ihre Nutzer verwenden sollen. Beispiel: Wenn der Nutzer etwas in einem oder zwei Sätzen erklären soll, beschränken Sie Ihren Sprach-Agent auf einen oder zwei Sätze pro Runde.
Sagen Sie Nutzern nicht, wie sie mit Formulierungen wie „in einem oder zwei Sätzen sprechen, sagen Sie…“ oder „Sie können etwas sagen wie…“ sagen.
Konzentrieren Sie sich auf die Aufgabe, die der Nutzer ausführen möchte, und entwickeln Sie Strategien zur Fehlerbehandlung für den Fall, dass die Unterhaltung fehlschlägt.
Sagen Sie den Nutzern mit Formulierungen wie „Ich kann Ihnen bei der Lösung komplexer Probleme helfen“ nicht, was der Sprach-Agent kann.

Unterhaltungsrundenpaare
Eine typische Unterhaltung besteht aus Rotationspaaren wie den folgenden Austauschtypen:
Frage-Antwort, die am häufigsten für einen Sprach-Agent verwendet wird
Einladung annehmen/ablehnen
Hallo-Hallo
Manchmal kann ein Rundenpaar zusätzliche Informationen enthalten, z. B. warum wir eine Frage stellen müssen, Hintergrundinformationen zu der Frage, die wir stellen möchten, oder eine Reaktion auf die Antwort des Nutzers. Sehen Sie sich zum Beispiel das folgende Frage-Antwort-Paar an:
Sprach-Agent: Dies kostet 10 $/Tag. (Hintergrundinformationen/Erklärung) Möchten Sie diesen Vorteil weiterhin hinzufügen? (Frage)
Nutzer: Ja. (Antwort)
Sprach-Agent: Sehr gut! (Reaktion)
Im Abschnitt Auftragsausführung des Leitfadens zu Best Practices für das allgemeine Agent-Design finden Sie Richtlinien zur Platzierung der Auftragsausführung.
Dialogkorrektur
Bei der Reparierung von Konversationen werden Fehlverständnisse, Missverständnisse und Fehlartefakte zur Fortsetzung einer Unterhaltung behoben. Wenn Sie eine Unterhaltung reparieren, können Sie das Vertrauen eines Nutzers herstellen. Dies zeigt, dass der Sprach-Agent seine Anfrage überwacht.
Hier einige Best Practices:
Seien Sie spezifisch und verwenden Sie den Kontext, den der Nutzer bereits in vorherigen Runden angeboten hat. Stellen Sie keine offensichtlichen und redundanten Fragen wie „Ich habe das nicht verstanden“, „Ich verstehe nicht“ oder „Ich habe Probleme“.
Geben Sie dem Nutzer die Möglichkeit zur Selbstreparatur. Dies bedeutet, dass der Nutzer seine Unterhaltungsrunde so reparieren kann, wie er es am besten braucht, um sicherzustellen, dass er Selbstbeteiligung hat. Vermeiden Sie Formulierungen wie „Wiederholungsformulierung“ oder „Sie können x, y oder z sagen.“
Verwenden Sie die Nachricht „Ihnen X?“ Struktur, die auf das Verständnis überprüft werden soll.
In der folgenden Tabelle werden mehrere Beispiele für Best Practices und Empfehlungen beschrieben:
Was Sie tun sollten:
Was Sie nicht tun sollten:
Nutzer: Ich reise nach Italien.
Sprach-Agent: Welches Land?
Nutzer: Ich reise nach Italien.
Sprach-Agent: Ich habe Probleme. Können Sie umformulieren? Wohin möchten Sie?
Nutzer: Ich möchte 80 $ bezahlen.
Sprach-Agent: Sie meinen 80 $? (Wiederholung nur die Informationen, die bestätigt werden müssen)
Nutzer: Ich möchte 80 $ bezahlen.
Sprach-Agent: Möchten Sie 80 $ bezahlen? Gibt die redundanten Informationen aus, die bezahlt werden sollen.

Fehlerbehandlung
Im folgenden Abschnitt wird beschrieben, wie Situationen behandelt werden, in denen eine Unterhaltung fehlschlägt.
Keine Übereinstimmung
Ein No-Match-Ereignis wird aufgerufen, wenn der Sprach-Agent keinen Intent finden kann, der dem entspricht, was der Nutzer sagte.
Versuchen Sie bei der ersten Instanz des No-Match-Ereignisses Folgendes:
Wiederholen Sie die Frage an den Nutzer, formulieren Sie ihn jedoch kurz um, um die fehlenden Informationen anzugeben. Da sich der Sprach-Agent nur auf fehlende Informationen konzentriert, wird er implizit ausgedrückt, dass er den Rest der Nutzeraussage gehört hat.
Sie können vor der neu gestellten Frage „traurig“ einfügen, um anzugeben, dass auf Ihrer Seite ein Fehler aufgetreten ist.
Zeigen Sie bei der zweiten Instanz des No-Match-Ereignisses, dass der Sprach-Agent versucht, zu überwachen. Betrachten Sie beispielsweise den folgenden Austausch:
Nutzer: Ich reise nach Italien
Sprach-Agent: Welches Land?
Nutzer: Italien
Sprach-Agent: Ihr Ziel ist es, in welches Land zu springen?
Keine Eingabe
Wenn Ihr Sprach-Agent keine mündliche Antwort vom Nutzer erhalten hat, wiederholen Sie die Frage wie beim ersten Mal. Bei der zweiten Instanz des No-Input-Ereignisses können Sie die ursprüngliche Frage umformulieren. Achten Sie jedoch darauf, dass alle ursprünglichen Komponenten der Frage vorhanden sind.
Nicht-Übereinstimmungen und Nicht-Eingabewiederholungen begrenzen
Implementieren Sie ein Maximum von 3 für jede No-Match-/No-Input-Datei, um zu verhindern, dass Nutzer in einer Schleife von Fehlerbehandlungsereignissen ausgeschlossen werden. Eskalieren Sie Nutzer nach dem dritten No-Match- oder No-Input-Ereignis an einen menschlichen Kundenservicemitarbeiter.
Kein Zeitlimit für Sprache
In Fällen, in denen Nutzer Informationen prüfen oder Entscheidungen treffen müssen, bevor sie fortfahren, erhöhen Sie die Einstellung no-speech-timeout, um Nutzern genügend Zeit zum Antworten zu geben.
Im folgenden Beispiel ist die Einstellung für kein Zeitlimit von 2 Sekunden zu kurz, damit der Nutzer eine SMS lesen und eine Entscheidung treffen kann:
Sprach-Agent: Ich habe eine SMS an Ihr Gerät gesendet. Klicken Sie auf den Link, um mehr über den Reisepass zu erfahren. Ich höre Musik, damit ich Ihnen den Text lesen und mich zurücksenden kann. <2 Sekunden Pause> Möchten Sie fortfahren?
Nutzer: Ich lesen noch.
Sprach-Agent: Möchten Sie den Reisepass zu Ihrem Plan hinzufügen?
Konversationstechniken
In diesem Abschnitt werden Techniken beschrieben, mit denen der Sprach-Agent Vertrauen aufbauen kann und Unterhaltungen reibungsloser verläuft.
Umsetzbare Fragen entwerfen
Erstellen Sie explizite und umsetzbare Fragen für Ihren Sprach-Agent, um Nutzer zu fragen. Berücksichtigen Sie beispielsweise Folgendes:
Was Sie tun sollten:
Was Sie nicht tun sollten:
Stellen Sie offene Fragen wie „Wann reisen Sie?“ Dadurch wird der Nutzer aufgefordert, Datumsangaben anzugeben, sofern er sie kennt. Andernfalls sagt er „Ich weiß nicht“.
Fragen Sie nicht: „Kennen Sie Ihre Reisedaten?“ Dadurch wird nur eine „Ja“- oder „Nein“-Antwort angefordert und sie sind weniger umsetzbar.
Fragen Sie „Möchten Sie den Bestellstatus eines anderen Pakets prüfen?“.
Fragen Sie nicht: „Möchten Sie mit dem Bestellstatus eines anderen Pakets fortfahren?“

Sie sollten Ihren Sprach-Agent auch auf Situationen vorbereiten, in denen der Nutzer eine Frage implizit beantworten kann, wie es bei normalen Unterhaltungen oft der Fall ist. Betrachten Sie beispielsweise die folgende Interaktion:
Sprach-Agent: Wechseln Sie zu Konto, klicken Sie auf Nutzung und dann auf Nutzung nach Zeile. Bitte geben Sie mir Bescheid, wann Sie dort ankommen.
Nutzer: Es wird angezeigt, dass keine Daten von vor drei Monaten oder älter angezeigt werden können.
Die Antwort des Nutzers impliziert, dass er erfolgreich den Zielbildschirm erreicht hat, aber noch mehr Hilfe benötigt hat. Ihr Sprach-Agent sollte solche Auswirkungen voraussehen, anstatt zu erwarten, dass der Nutzer nur „Ich habe“ oder „Ich habe nichts getan“ sagt.
Das Vertrauen von Nutzern gewinnen
Sprach-Agenten können Nutzern mithilfe von Bestätigungen und spezifischen Details zeigen, dass sie ihre Aktivitäten überwachen. Wenn der Sprach-Agent generische Antworten bereitstellt, haben Nutzer möglicherweise das Gefühl, dass der Sprach-Agent unnatürlich klingt.
Verwenden Sie Bestätigungen. Betrachten Sie beispielsweise den folgenden Austausch, in dem „Kein Problem“ als Bestätigung verwendet wird:
Nutzer: Ich möchte eine Zahlungsvereinbarung für Montag festlegen.
Sprach-Agent: Kein Problem. Wie möchten Sie am Montag bezahlen?
Fügen Sie spezifische Details hinzu, um zu zeigen, dass der Sprach-Agent den Nutzer aktiv überwacht. Im obigen Austausch ist die Formulierung „am Montag“ beispielsweise ein bestimmtes Detail, das angibt, dass der Sprach-Agent gehört hat, was der Nutzer gesagt hat.
Beantworten Sie die Anfrage des Nutzers so schnell wie möglich und schließen Sie unnötige Schritte aus. Im folgenden Beispiel kann die überflüssigen Informationen zu Frustration beim Nutzer führen:
Nutzer: Gibt es in meiner Region einen Ausfall?
Sprach-Agent: Wir wissen, wie wichtig es für Sie ist, in Verbindung zu bleiben. Lassen Sie uns herausfinden, was das Problem verursacht. Nennen Sie uns die letzten vier Ziffern der Leitung, bei der Probleme auftreten. Wenn das Problem mehrere Zeilen umfasst, geben Sie einfach eine an.
Nutzer: 1234
Sprach-Agent: Danke. Sehen wir uns die nächsten Schritte für diese Zeile an. Fangen wir also an! Das vorübergehende Deaktivieren und anschließende Aktivieren von HD Voice ist möglich… Funktioniert es?“
Sorgen Sie dafür, dass die Unterhaltung zwischen dem Nutzer und dem Sprach-Agent ausgeglichen ist. Nutzer haben möglicherweise das Gefühl, dass sich die Unterhaltung in einer Unterhaltung nicht lohnt, wenn der Sprach-Agent die Unterhaltung dominiert. Priorisieren Sie, wer/Wo/Was/Wann/Wie Fragen gegenüber Ja/Nein-Fragen hat.
Sorgen Sie dafür, dass die Unterhaltung des Nutzers reibungslos verläuft, wenn er an Kundenservicemitarbeiter eskalieren möchte.
Weitere Informationen
Weitere Informationen finden Sie im Leitfaden zur Dialoggestaltung des Actions on Google-Teams.
Weitere Informationen finden Sie im Voice Playbook für die nächste Milliarden Nutzer.
SSML-Anleitung zu Cloud Text-to-Speech
Weitere Informationen zur Erstellung von umsetzbaren Fragen finden Sie unter Sprachaktionen.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Bedingte Aktionen
bookmark_border
Versionshinweise
Preview
This product or feature is subject to the „Pre-GA Offerings Terms“ in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available „as is“ and might have limited support. For more information, see the launch stage descriptions.
Standardmäßig werden in Playbooks LLMs verwendet, um die Unterhaltung zu steuern, Aktionen auszuführen und auf Endnutzer zu reagieren. Wenn Sie das Verhalten des Kundenservicemitarbeiters genauer steuern möchten, können Sie Abläufe oder bedingte Aktionen verwenden, die in diesem Leitfaden beschrieben werden.
Bedingte Aktionen sind eine optionale Konfiguration für Playbooks. Sie können Unterhaltungstrigger und -bedingungen festlegen, die bestimmte Aktionen auslösen, z. B. das Beantworten mit einer bestimmten Nachricht, das Aufrufen eines externen Tools, das Aufrufen eines anderen Playbooks oder die Ausführung einer anderen angegebenen Aktion.
Trigger
Sie können Auslöser definieren, die als erster Schritt bei der Bestimmung dienen, ob eine bedingte Aktion zutrifft. Im Folgenden werden Triggertypen und die jeweiligen Trigger für jeden Typ beschrieben:
Lebenszyklusphase
Playbook-Start: Wird ausgelöst, wenn ein Playbook zum ersten Mal gestartet wird.
Bevor der LLM seine nächste Aktion festlegt: Wird jedes Mal ausgelöst, bevor der LLM die nächste Aktion vorhersagt.
Bevor der LLM seine nächste Aktion ausführt: Wird jedes Mal ausgelöst, bevor der LLM eine Aktion ausführt.
Ereignis
Benutzerdefiniertes Ereignis
Keine Eingaben von Nutzern
Bedingungen
Sobald ein Trigger auftritt, werden im zweiten Schritt alle optional angegebenen Bedingungen ausgewertet. Bedingungen werden mit derselben Syntax für Bedingungen angegeben, die auch für Ablaufrouten verwendet wird.
Wenn keine Bedingungen angegeben werden, wird nur der Trigger verwendet, um Aktionen auszulösen.
Mit der folgenden Syntax können Sie auf Parameter und die letzte/nächste Aktion verweisen:
Sitzungsparameter
$session.params.PARAMETER_NAME
Playbook-Eingabeparameter
$playbook.input.INPUT_FIELD_NAME
Letzte Aktion (zuvor ausgeführte Aktion)
$last-action.name
$last-action.input.INPUT_FIELD_NAME
$last-action.output.OUTPUT_FIELD_NAME
$last-action.status
Nächste Aktion (von LLM vorhergesagte nächste Aktion)
$next-action.name
$next-action.input.INPUT_FIELD_NAME
Sie können auch Systemfunktionen verwenden.
Beispiele:
$session.params.current_user = null
$last-action.name = „query_order“
$last-action.name = „query_order“ AND $last-action.status != SUCCESS
$last-action.name = „query_order“ AND $last-action.output.orders = null
Aktionen
Nachdem ein Trigger und eine optionale Bedingung ausgewertet wurden, können Sie die folgenden Aktionen konfigurieren:
Eine Antwort für den Endnutzer bereitstellen: Text, bedingte Antwort, Kundennutzlast
Nächste LLM-Aktion überschreiben: Toolnutzung, Playbook-Aufruf, Playbook-Abschluss, Ablaufaufruf, Playbook-Übergang, Ablaufübergang
Spracheinstellungen ändern: Modellname, keine Zeitüberschreitung für Spracheingaben, Empfindlichkeit des Endpunkts, Anpassung
Unterbrechungen aktivieren
Abbruch der Wiedergabe einer teilweisen Antwort zulassen
SMS an Call Companion senden
DTMF aktivieren: DTMF für Telefonieintegrationen

Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Dialogflow CX-Messenger-Auftragsausführung
bookmark_border
Beim Erstellen einer Auftragsausführung für eine benutzerdefinierte Karte können Sie Textantworten und benutzerdefinierte Nutzdaten erstellen. Die Textantworten werden für nur Text und Markdown-Agentantworten verwendet und die benutzerdefinierten Nutzlasten für Rich-Antworten. Das benutzerdefinierte Nutzlastformat für alle Antworttypen hat die folgende Grundstruktur:
{
„richContent“: [
[
{
„type“: „type-id“,
…
},
{
„type“: „type-id“,
…
}
],
[
{
„type“: „type-id“,
…
},
{
„type“: „type-id“,
…
}
]
]
}
Beachten Sie, dass der Wert richContent ein äußeres und mehrere innere Arrays zulässt. Antworten innerhalb eines inneren Arrays werden in einer einzelnen visuellen Karte zusammengefasst. Wenn das äußere Array mehrere interne Arrays enthält, werden mehrere Karten angezeigt. Eine für jedes interne Array.
Hinweis: Benutzerdefinierte Nutzlast-JSON-Dateien dürfen maximal 24 Ebenen haben.
In den verbleibenden Unterabschnitten werden die verschiedenen Antworttypen beschrieben, die Sie für eine benutzerdefinierte Nutzlast konfigurieren können.
Textantwort

Hinweis: Für Textantworten ist keine Nutzlast erforderlich. Sie können direkt als Kundenservicemitarbeiterantwort eingegeben werden.
Die Textantwort unterstützt Nur-Text und Markdown. Hier einige Markdown-Beispiele:
Italic
Bold

Title

[Link text](Link URL)
Hinweis: Wenn Sie Bilder in Markdown aktivieren möchten, muss das Attribut url-allowlist entsprechend angegeben werden.
Tabellen:

Header 1	Header 2
Cell 1	Cell 2
Antworttyp „info“

Der Antworttyp „info“ ist eine einfache Titelkarte, auf die Nutzer klicken oder tippen können.
Hinweis :Wenn Sie für die Auftragsausführung einen Data Store-Agenten verwenden, muss der Wert Link maximum (Link-Maximum) in den Data Store-Antwortoptionen auf „0“ gesetzt oder auf „1“ festgelegt sein, damit dieser Antworttyp verwendet werden kann.
In der folgenden Tabelle werden die Felder beschrieben:
Name
Typ
Beschreibung
type
string
Antworttyp: „info“
title
string
Titel der Karte
subtitle
string
Kartenuntertitel
image
object
Bild
image.rawUrl
string
Öffentliche URL des Bilds
anchor
object
Anchor, dem beim Klicken auf das Element zu folgen ist
anchor.href
string
URL des Ankers
anchor.target
string
Ziel des Ankers, standardmäßig _blank

Beispiel:
{
„richContent“: [
[
{
„type“: „info“,
„title“: „Info item title“,
„subtitle“: „Info item subtitle“,
„image“: {
„rawUrl“: „https://example.com/images/logo.png“
},
„anchor“: {
„href“: „https://example.com“
}
}
]
]
}
Antworttyp „description“

Der Antworttyp „description“ ist eine Informationskarte, die mehrere Textzeilen enthalten kann.
In der folgenden Tabelle werden die Felder beschrieben:
Name
Typ
Beschreibung
type
string
Antworttyp: „description“
title
string
Titel der Karte
text
array
Array von Strings, wobei jeder String in einer neuen Zeile gerendert wird

Beispiel:
{
„richContent“: [
[
{
„type“: „description“,
„title“: „Description title“,
„text“: [
„This is text line 1.“,
„This is text line 2.“
]
}
]
]
}
Antworttyp „image“

Der Antworttyp „image“ ist eine Bildkarte, auf die Nutzer klicken oder tippen können. Der Antworttyp unterstützt einen Referenzchip, mit dem die Quelle des Bildes als Ankerlink zusammen mit einem kurzen beschreibenden Text und einem Symbol hinzugefügt werden kann.
In der folgenden Tabelle werden die Felder beschrieben:
Name
Typ
Beschreibung
type
string
Antworttyp: „image“
rawUrl
string
Öffentliche URL des Bilds
accessibilityText
string
Alternativer Text für das Bild
reference.text
string
Text, der im Referenzchip angezeigt werden soll
reference.anchor.href
string
URL des Referenzchips
reference.anchor.target
string
Ziel des Ankers im Referenz-Chip, standardmäßig _blank
reference.image.rawUrl
string
Bild, das im Referenzchip angezeigt werden soll

Beispiel:
{
„richContent“: [
[
{
„type“: „image“,
„rawUrl“: „https://example.com/images/logo.png“,
„accessibilityText“: „Example logo“,
„reference“: {
„text“: „Logo“,
„anchor“: {
„href“: „https://example.com/images/logo.png“
},
„image“: {
„rawUrl“: „https://example.com/images/logo_small.png“
}
}
}
]
]
}
Die folgenden CSS-Variablen können bereitgestellt werden:
Eigenschaften
Eingaberichtlinie
Standardwert
Beschreibung
df-messenger-image-border-radius
Optional
8 Pixel
Rahmenradius des Bildes

Antworttyp „video“

Der Videoantworttyp rendert ein Videoelement, das entweder ein direktes Video von einer URL sein kann, das direkt im Messenger wiedergegeben wird, oder ein Link zu einem Video.
Name
Typ
Beschreibung
type
string
Antworttyp: „video“
title
string
Optionaler Videotitel
source
object
Die Quelle des Videos
source.type
string
Der Typ der Videoquelle, entweder link oder raw
source.anchor
object
Anchor, dem beim Klicken auf das Element zu folgen ist
source.embeddedPlayer
string
Ein Video vom Typ link kann eingebettet werden, anstatt einen Link zur Webseite des Players zu enthalten. Diese Funktion ist nur für eine bestimmte Gruppe von Playern implementiert und unterstützt youtube.
source.thumbnail
object
Miniaturansicht für anchor
source.thumbnail.rawUrl
string
Die URL der Miniaturansicht
source.rawUrl
string
URL für ein Video vom Typ raw

Beispiel:
{
„richContent“: [
[
{
„type“: „video“,
„source“: {
„type“: „link“,
„anchor“: {
„href“: „https://www.youtube.com/watch?v=cNfINi5CNbY“
}
}
}
]
]
}
Die folgenden CSS-Variablen können bereitgestellt werden:
Eigenschaften
Eingaberichtlinie
Standardwert
Beschreibung
df-messenger-video-width
Optional
automatisch
Breite eines Videos (begrenzt auf max-width\: 100%)
df-messenger-video-height
Optional
automatisch
Höhe eines Videos
df-messenger-video-embed-width
Optional
560 Pixel
Breite eines eingebetteten Videos (begrenzt auf max-width\: 100%)
df-messenger-video-embed-height
Optional
315 px
Höhe eines eingebetteten Videos
df-messenger-video-border
Optional
1px solid #e0e0e0
Rand des Videos
df-messenger-video-border-radius
Optional
8 Pixel
Rahmenradius des Videos

Antworttyp „button“

Der Antworttyp „button“ ist eine kleine Schaltfläche mit einem Symbol, auf das Nutzer klicken oder tippen können.
In der folgenden Tabelle werden die Felder beschrieben:
Name
Typ
Beschreibung
type
string
Antworttyp: „button“
icon
object
Symbol für die Schaltfläche
icon.type
string
Symbol aus der Materialsymbol-Bibliothek Das Standardsymbol ist ein Pfeil
icon.color
string
Farb-Hexcode
image
object
Bild für die Schaltfläche, hat Vorrang vor icon
image.rawUrl
string
Öffentliche URL des Bilds
mode
string
Optional. Wenn „blockieren“ festgelegt ist, ist die Nutzereingabe deaktiviert, bis der Nutzer auf die Schaltfläche klickt.
text
string
Schaltflächentext
anchor
object
Anchor, dem beim Klicken auf das Element zu folgen ist
anchor.href
string
URL des Ankers
anchor.target
string
Ziel des Ankers, standardmäßig _blank
event
object
Dialogflow-Ereignis, das ausgelöst wird, wenn auf die Schaltfläche geklickt wird

Beispiel:
{
„richContent“: [
[
{
„type“: „button“,
„icon“: {
„type“: „chevron_right“,
„color“: „#FF9800“
},
„mode“: „blocking“,
„text“: „Button text“,
„anchor“: {
„href“: „https://example.com“
},
„event“: {
„event“: „“
}
}
]
]
}
Die folgenden CSS-Variablen können bereitgestellt werden:
Eigenschaften
Eingaberichtlinie
Standardwert
Beschreibung
df-messenger-button-border
Optional
keine
Rahmen einer Schaltfläche
df-messenger-button-border-radius
Optional
8 Pixel
Rahmenradius einer Schaltfläche
df-messenger-button-font-color
Optional

1f1f1f

Schriftfarbe einer Schaltfläche
df-messenger-button-font-family
Optional
„Google Sans“, „Helvetica Neue“, serifenlos
Schriftfamilie einer Schaltfläche
df-messenger-button-font-size
Optional
14 Pixel
Schriftgröße einer Schaltfläche
df-messenger-button-padding
Optional
12 Pixel
Abstand einer Schaltfläche
df-messenger-button-icon-spacing
Optional
12 Pixel
Abstand zwischen Schaltflächensymbol und Text
df-messenger-button-icon-font-size
Optional
24 Pixel
Größe des Schaltflächensymbols
df-messenger-button-image-size
Optional
24 Pixel
Größe des Schaltflächenbilds
df-messenger-button-image-offset
Optional
0
Offset des Schaltflächenbilds. Negative Werte ermöglichen einen Abstand zum Text.
df-messenger-button-text-align
Optional
center
Textausrichtung einer Schaltfläche
df-messenger-button-text-wrap
Optional
normal
Mit nowrap können Sie mehrzeilige Schaltflächen deaktivieren.

Antworttyp „list“

Der Antworttyp „list“ ist eine Karte mit mehreren Optionen, aus denen Nutzer auswählen können.
Die Antwort enthält ein Array mit den Antworttypen list und divider. In der folgenden Tabelle wird der Typ list beschrieben:
Name
Typ
Beschreibung
type
string
Antworttyp: „list“
title
string
Titel der Option
subtitle
string
Untertitel der Option
event
object
Dialogflow-Ereignis, das ausgelöst wird, wenn auf die Schaltfläche geklickt wird
anchor
object
Anchor, dem beim Klicken auf das Element zu folgen ist
anchor.href
string
URL des Ankers
anchor.target
string
Ziel des Ankers, standardmäßig _blank
image
object
Bild
image.rawUrl
string
Öffentliche URL des Bilds

In der folgenden Tabelle wird der Typ divider beschrieben:
Name
Typ
Beschreibung
type
string
Antworttyp: „divider“

Beispiel:
{
„richContent“: [
[
{
„type“: „list“,
„title“: „List item 1 title“,
„subtitle“: „List item 1 subtitle“,
„event“: {
„event“: „“
}
},
{
„type“: „list“,
„title“: „List item 2 title“,
„subtitle“: „List item 2 subtitle“,
„event“: {
„event“: „“
}
}
]
]
}
Die folgenden CSS-Variablen können bereitgestellt werden:
Eigenschaften
Eingaberichtlinie
Standardwert
Beschreibung
df-messenger-list-padding
Optional
16 Pixel
Ränder eines Listenelements
df-messenger-list-inset
Optional
0
Zusätzlicher horizontaler „Einzug“ des Listenelements (zusätzlich zum Abstand), um die Ausdehnung des Rahmens zwischen den Elementen zu steuern
df-messenger-list-spacing
Optional
10 Pixel
Vertikale Abstände zwischen Listenelementen
df-messenger-list-border-bottom
Optional
1px solid #e0e0e0
Rahmen zwischen Listenelementen

Antworttyp „accordion“

Der Antworttyp „accordion“ ist eine kleine Karte, auf die ein Nutzer klicken oder tippen kann, um mehr Text einzublenden und anzuzeigen.
In der folgenden Tabelle werden die Felder beschrieben:
Name
Typ
Beschreibung
type
string
Antworttyp: „accordion“
title
string
Titel des „Akkordeons“
subtitle
string
Untertitel des „Akkordeons“
image
object
Bild
image.rawUrl
string
Öffentliche URL des Bilds
text
string
Text für das „Akkordeon“

Beispiel:
{
„richContent“: [
[
{
„type“: „accordion“,
„title“: „Accordion title“,
„subtitle“: „Accordion subtitle“,
„image“: {
„rawUrl“: „https://example.com/images/logo.png“
},
„text“: „Accordion text“
}
]
]
}
Antworttyp „chips“

Der Antworttyp „chips“ bietet dem Endnutzer eine Liste anklickbarer Chips mit Vorschlägen.
In der folgenden Tabelle werden die Felder beschrieben:
Name
Typ
Beschreibung
type
string
Antworttyp: „chips“
options
array

[param_name]

user_provided_address Webhook prebuilt_components[component_name]:[webhook_action]
prebuilt_components_address_collection:address_validation

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 Ablaufebene müssen wie unten beschrieben auf der Startseite der Komponente festgelegt werden. Parameter auf Sitzungsebene können entweder über einen Aufrufablauf oder auf der Startseite dieser Komponente festgelegt werden.
Sie können konfigurieren, welche Adresselemente für diese Komponente erforderlich sind, indem Sie die Parametervorgaben auf der Startseite des Workflows ändern.
Diese vordefinierte Komponente akzeptiert die folgenden Eingabeparameter:
Parametername
Beschreibung
Eingabeformat
$flow.zip_code
Wenn das Postleitzahlelement erforderlich ist, legen Sie true fest, andernfalls false.
boolean
$flow.city
Wenn das Ortselement erforderlich ist, legen Sie true fest, andernfalls false.
boolean
$flow.admin_area
Wenn das Adresselement für den Verwaltungsbezirk erforderlich ist, geben Sie true an, andernfalls false.
boolean
$flow.street_number
Wenn das Adresselement „Hausnummer“ erforderlich ist, legen Sie true fest, andernfalls false.
boolean
$flow.route
Wenn das Routenadressenelement erforderlich ist, legen Sie es als true fest, andernfalls als false.
boolean
$flow.country
Wenn das Element „Adresse des Landes“ erforderlich ist, legen Sie true fest. Andernfalls false.
boolean
$flow.island
Wenn das Element „island_address“ erforderlich ist, legen Sie es als true fest, andernfalls als false.
boolean
$flow.retry_num
Legt das maximale Limit für Wiederholungsversuche für Webhook-Aufrufe der Maps Address Validation API fest
integer

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.
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
address_collection_address
Dieser Parameter gibt das Adressobjekt zurück, wenn eine Adresse von der Komponente erfasst wurde.
{
„admin-area“: string,
„city“: string,
„country“: string,
„island“: string,
„route“: string,
„zip-code“: string,
„street-number“: string
}
address_collection_status
Dieser Parameter gibt den Status der erfassten Adresse zurück. Der zurückgegebene Wert kann einer der folgenden sein:

VALID_ADDRESS: Die Adresse wurde von der Address Validation API erfasst und validiert.

INVALID_ADDRESS: Die Adresse wurde vom Endnutzer bestätigt, aber mindestens eines der Elemente wurde nicht validiert oder von der Address Validation API als UNCONFIRMED_BUT_PLAUSIBLE (NICHT BEStätigt, ABER WAHRSCHEINLICH) gekennzeichnet.

MAPS_API_ERROR: Die Adresse wurde aufgrund eines Fehlers der Address Validation API nicht erfasst.

COUNTRY_NOT_SUPPORTED: Die Adresse wurde nicht erfasst, da die Region von der Address Validation API nicht unterstützt wird.

NO_USER_CONFIRMATION: Die Adresse wurde nicht bestätigt, da der Endnutzer keine Adresse bestätigt hat.
string

Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
Aktivieren Sie die Address Validation API.
Konfigurieren Sie den bereitgestellten flexiblen Webhook mit Ihrem Maps API-Schlüssel. Weitere Informationen finden Sie unten unter „Webhook einrichten“.
Webhook-Einrichtung
Damit Sie die Address Validation API zum Validieren von Adressen verwenden können, müssen Sie den bereitgestellten flexiblen Webhook mit den richtigen Anmeldedaten konfigurieren.
Webhook für die Adressbestätigung
Dieser Webhook führt die folgenden Aktionen aus:
Verarbeitet erfasste Parameter von Conversational Agents (Dialogflow CX), stellt eine Anfrage und überprüft die Adresse mithilfe der Address Validation API.
Hiermit werden bestätigte, nicht bestätigte, fehlende und abgeleitete Adresselemente aus der Antwort der Google Address Validation API extrahiert.
Wenn Sie den Webhook für diese Komponente konfigurieren möchten, müssen Sie die Webhook-Einstellungen mit Ihrem Maps API-Schlüssel aktualisieren.
So rufen Sie Ihren API-Schlüssel ab: Rufen Sie Google Cloud Platform Console > APIs & Services > Credentials auf, wählen Sie Ihren Maps API-Schlüssel aus und kopieren Sie das Feld „API-Schlüssel“.
So konfigurieren Sie den Webhook:
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Verwalten.
Klicken Sie auf Webhooks.
Wählen Sie den Webhook „prebuilt_components_address_collection:address_validation“ aus.
Ersetzen Sie die URL im Feld Webhook-URL für Konversations-Agents (Dialogflow CX) durch die URL mit Ihrem Maps API-Schlüssel: https://addressvalidation.googleapis.com/v1:validateAddress?key=MAPS_API_KEY
Geben Sie in den Authentifizierungseinstellungen den Nutzernamen als key und das Passwort als Ihren Maps API-Schlüssel ein.
Klicken Sie auf Speichern.
Abgeschlossen
Ihr Agent und sein Webhook sollten jetzt eingerichtet und bereit für den Test sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vordefinierte Sammlungskomponente benennen
bookmark_border
Versionshinweise
Diese vordefinierte Komponente erfasst den Vor-, Nach- und optional den zweiten Vornamen sowie alle Leerzeichen, Bindezeichen oder Apostrophe.
Beschränkungen
Zusätzlich zu den allgemeinen Einschränkungen für vordefinierte Komponenten gelten für diese vordefinierte Komponente die folgenden Einschränkungen:
Namen mit Sonderzeichen, die keine Leerzeichen, Apostrophe oder Bindestriche sind, werden von dieser Komponente nicht unterstützt.
Zusätzliche Funktionen
Diese vorgefertigte Komponente bietet die folgenden zusätzlichen Funktionen:
Wartezimmer
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.
Vollständiger Name
Der Endnutzer gibt in der ersten Runde einen vollständigen Namen an, den der Kundenservicemitarbeiter akzeptiert.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Wie lautet Ihr vollständiger Name? Nennen Sie mir bitte Ihren Vor-, Nach- und gegebenenfalls Ihren zweiten Vornamen.
Sundar Pichai

Zur Bestätigung: Ihr Vorname ist Sundar und Ihr Nachname ist Pichai. Habe ich Ihren vollständigen Namen richtig geschrieben?
Ja

Haben Sie einen zweiten Vornamen?
no

Vielen Dank, Sundar.

Vollständiger Name in Teilen
Der Endnutzer kann beim ersten Versuch keinen vollständigen Namen angeben. Der Endnutzer gibt dann seinen Vornamen, seinen Nachnamen und seinen Zweitnamen in separaten Sequenzen an. Der Kundenservicemitarbeiter akzeptiert die Angaben.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Wie lautet Ihr vollständiger Name? Nennen Sie mir bitte Ihren Vor-, Nach- und gegebenenfalls Ihren zweiten Vornamen.
nett

Tut mir leid, das habe ich nicht richtig verstanden. Versuchen wir es noch einmal.
Bevor Sie Ihren Namen eingeben, können Sie mir bitte sagen, ob Ihr Name Bindestriche, zusätzliche Leerzeichen oder Apostrophe enthält?
Nein

Geben Sie zuerst Ihren Vornamen ein.
Wie lautet Ihr Vorname?
Lawrence

Lawrence. Habe ich Ihren Vornamen richtig geschrieben?
Ja

Wie lautet Ihr Nachname?
Seite

Seite. Habe ich Ihren Nachnamen richtig geschrieben?
Ja

Haben Sie einen zweiten Vornamen?
Ja

Wie lautet Ihr zweiter Vorname?
Eduard

Edward. Habe ich Ihren zweiten Vornamen richtig geschrieben?
Ja

Vielen Dank, Lawrence.

Sonderzeichen
Der Endnutzer kann beim ersten Versuch keinen vollständigen Namen angeben. Der Endnutzer gibt dann seinen Vornamen, seinen Nachnamen und seinen Zweitnamen in separaten Sprachwechseln mit Sonderzeichen an. Der Kundenservicemitarbeiter akzeptiert die Angaben.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Wie lautet Ihr vollständiger Name? Nennen Sie mir bitte Ihren Vor-, Nach- und gegebenenfalls Ihren zweiten Vornamen.
nett

Tut mir leid, das habe ich nicht richtig verstanden. Versuchen wir es noch einmal.
Bevor Sie Ihren Namen eingeben, können Sie mir bitte sagen, ob Ihr Name Bindestriche, zusätzliche Leerzeichen oder Apostrophe enthält?
Ja, habe ich.

Alles klar. Enthalten Ihr Vorname, Ihr zweiter Vorname oder Ihr Nachname diese Sonderzeichen?
Vorname

Nennen Sie mir bitte den ersten Teil Ihres Vornamens vor den Sonderzeichen.
Elias

Evan. Habe ich den ersten Teil richtig geschrieben?
Ja

Sagen Sie mir, was als Nächstes kommt: ein Leerzeichen, ein Apostroph oder ein Bindestrich.
Bindestrich

„Bindestriche“. Habe ich das Trennzeichen nach dem ersten Teil Ihres Vornamens richtig erfasst?
Ja

Bitte buchstabieren Sie den nächsten Teil Ihres Vornamens nach dem Bindestrich. Sagen Sie nur die Buchstaben, z. B. J-O-H-N.
James

James. Sagen Sie mir, ob das falsch ist, ob das das Ende ist oder was als Nächstes kommt: ein Leerzeichen, ein Apostroph oder ein Bindestrich.
Ich bin fertig

Wie lautet Ihr Nachname?
Mady

Mady. Habe ich Ihren Nachnamen richtig geschrieben?
Ja

Haben Sie einen zweiten Vornamen?
no

Vielen Dank, Evan-James.

Keine Eingabe
Die Komponente beendet den Ablauf, nachdem der Endnutzer dreimal keine Eingabe gemacht hat.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Wie lautet Ihr vollständiger Name? Nennen Sie mir bitte Ihren Vor-, Nach- und gegebenenfalls Ihren zweiten Vornamen.
[No-input]

Ich konnte Sie leider nicht hören. Wie lautet Ihr vollständiger Name?
[No-input]

Hm, ich kann Sie immer noch nicht hören. Versuchen Sie, lauter zu sprechen oder an einen ruhigeren Ort zu gehen.
[No-input]

Ich habe Ihre Antwort leider nicht verstanden.

Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Sammlung benennen
Komponentenspezifischer Intent
prebuilt_components_[component_name][intent_name] prebuilt_components_name_collection_special_characters_decider Entitätstyp prebuilt_components[component_name]_[entity_type_name]
prebuilt_components_name_collection_first_name
Parameter
[param_name]
user_provided_first_name

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
name_collection_first_name
Dieser Parameter gibt den vom Nutzer angegebenen Vornamen zurück, der von der Komponente erfasst wird.
String
name_collection_last_name
Dieser Parameter gibt den vom Nutzer angegebenen Nachnamen zurück, der von der Komponente erfasst wird.
String
name_collection_middle_name
Dieser Parameter gibt den vom Nutzer angegebenen Mittelnamen zurück, der von der Komponente erfasst wird. Wenn kein zweiter Vorname erfasst wird, ist der Parameter ein leerer String.
String

Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
Abgeschlossen
Ihr Agent sollte jetzt eingerichtet und bereit zum Testen sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vorkonfigurierte Komponente „Konto öffnen“
bookmark_border
Versionshinweise
Mit der vorgefertigten Komponente „Konto erstellen“ können neue und bestehende Nutzer ein neues Konto erstellen oder den Status vorhandener Anwendungen prüfen. In dieser Komponente werden die vordefinierten Komponenten Geburtsdatumssammlung, Namenssammlung und Telefonnummernsammlung verwendet, um Nutzerinformationen zur Registrierung eines neuen Kontos zu erfassen.
Kontotypen
Diese Komponente unterstützt standardmäßig die folgenden Kontotypen:
Sparkonten
Girokonten
Depotkonten
Gehaltskonten
Unterstützte Kontotypen können durch Ändern des benutzerdefinierten Elements prebuilt_components_open_account_account_type hinzugefügt oder entfernt werden.
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.
Neuer Nutzer
Der Kundenservicemitarbeiter erfasst die Telefonnummer des Nutzers und stellt fest, dass er nicht für ein Konto registriert ist. Der Kundenservicemitarbeiter erfasst dann Details wie den vollständigen Namen und das Geburtsdatum des Nutzers und generiert einen Antrag, der an die angegebene Telefonnummer des Nutzers gesendet wird.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Bitte geben Sie uns zur Bestätigung die Telefonnummer an.

Kundenservicemitarbeiter erfasst die Telefonnummer des Nutzers mithilfe der vorgefertigten Komponente Telefonnummernerfassung

Sehr gut. Wir haben jetzt die Telefonnummer erfasst.
Wir freuen uns, dass Sie ein Konto bei uns eröffnen möchten.

Der Kundenservicemitarbeiter erfasst den vollständigen Namen des Nutzers mithilfe der vorgefertigten Komponente Namenerhebung.

Vielen Dank, Max Mustermann.

Der Kundenservicemitarbeiter erhebt die Telefonnummer des Nutzers mithilfe der vorgefertigten Komponente Date of birth collection.

Sehr gut. Wir haben Ihr Geburtsdatum erfasst.

Welche Art von Konto möchten Sie eröffnen? Sie können „Sparkonto“, „Girokonto“, „Lohnkonto“ oder „Depot“ sagen.
Girokonto

Zur Bestätigung: Sie möchten ein neues Girokonto eröffnen, ist das richtig?
Ja

Vielen Dank für die Informationen. Bitte warten Sie, während wir Ihren Antrag generieren.

Ihre Antrags-ID lautet 81037. Bitte klicken Sie auf den Link, der an Ihre registrierte Mobiltelefonnummer gesendet wurde, um Ihre Bewerbung abzuschließen.

Vorhandener Nutzer
Der Kundenservicemitarbeiter stellt fest, dass der Nutzer bereits authentifiziert wurde, und fragt, welche Art von Konto er eröffnen möchte. Der Kundenservicemitarbeiter erstellt einen Antrag für den Nutzer und sendet eine Anleitung an die registrierte Telefonnummer des Nutzers.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Wir freuen uns, dass Sie ein neues Konto bei uns eröffnen möchten.

Welche Art von Konto möchten Sie eröffnen? Sie können „Sparkonto“, „Girokonto“, „Lohnkonto“ oder „Depot“ sagen.
Sparkonto bitte

Sie möchten ein neues Sparkonto eröffnen, ist das richtig?
Ja, das ist richtig.

Vielen Dank für die Informationen. Bitte warten Sie, während wir Ihre Anwendung generieren.

Ihre Anwendungs-ID lautet 21430. Bitte klicken Sie auf den Link, der an Ihre registrierte Mobiltelefonnummer gesendet wurde, um Ihre Bewerbung abzuschließen.

Vorhandene Anwendung
Der Kundenservicemitarbeiter erkennt, dass der Nutzer zuvor eine einzelne Anwendung geöffnet hat, und zeigt ihm den aktuellen Status an. Der Nutzer lehnt es ab, einen weiteren Antrag auf ein neues Konto zu stellen.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Bitte geben Sie uns die Telefonnummer zur Bestätigung an.

Kundenservicemitarbeiter erfasst die Telefonnummer des Nutzers mithilfe der vorgefertigten Komponente Telefonnummernerfassung

Sehr gut. Wir haben die Telefonnummer erfasst.

Ihr Antrag mit der ID 12234 zur Eröffnung eines Sparkontos wird bearbeitet. Möchten Sie ein anderes Konto erstellen?
Nein

Okay, vielen Dank für Ihren Anruf.

Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Konto erstellen
Komponentenspezifischer Intent
prebuilt_components_[component_name][intent_name] prebuilt_components_open_account_account_type Entitätstyp prebuilt_components[component_name][entity_type] prebuilt_components_open_account_account_type Webhook prebuilt_components[component_name]:[webhook_action]
prebuilt_components_open_account:generate_application

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 Ablaufebene müssen wie unten beschrieben 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.auth_level
(Optional) Gibt die Authentifizierungsebene des Aufrufers an.
integer
$session.params.phone_number
(Optional) Die registrierte Telefonnummer des Kunden, die für die Authentifizierung verwendet wird.
String
$session.params.min_age_limit
Gibt das Mindestalter für Nutzer an, die ein neues Konto erstellen. Der Standardwert ist 18.
integer
$session.params.max_age_limit
Gibt das maximale Alter für Nutzer an, die ein neues Konto erstellen. Der Standardwert ist 100.
integer
$flow.max_dob_retry_count
Gibt die Anzahl der zulässigen Wiederholungsversuche beim Erfassen eines gültigen Geburtsdatums an. Der Standardwert ist 2.
integer
$flow.max_retry_account_type
Gibt die Anzahl der zulässigen Wiederholungen an, wenn der Kontotyp erfasst wird, den der Nutzer eröffnen möchte. Der Standardwert ist 2.
integer
$flow.max_retry_another_account
Gibt die Anzahl der zulässigen Wiederholungen an, wenn der Nutzer den ausgewählten Kontotyp ändern möchte. Der Standardwert ist 2.
integer

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.
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
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: Bei der Unterhaltung wurde 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: Es ist ein Webhook-Fehler 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

Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unten 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.
Telefonische Bestätigung
Über den prebuilt_components_open_account:telephone_verification-Webhook erhält die Komponente Informationen zu registrierten Konten und früheren Anwendungen, die mit der Telefonnummer des Nutzers verknüpft sind.
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

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
account_count
Die Anzahl der Konten, die mit der registrierten Telefonnummer verknüpft sind. Dazu gehören eigene Konten und Konten, für die der Nutzer eine Vollmacht hat. Wenn mit der angegebenen Telefonnummer keine Konten verknüpft sind, ist dieser Wert null.
integer
user_first_name
Der Vorname des registrierten Nutzers. Wenn die Telefonnummer nicht mit einem registrierten Konto verknüpft ist, ist dieser Wert null.
String
user_last_name
Der Nachname des registrierten Nutzers. Wenn die Telefonnummer nicht mit einem registrierten Konto verknüpft ist, ist dieser Wert null.
String
user_dob
Das Geburtsdatum des registrierten Nutzers im Format JJJJ-MM-TT. Wenn die Telefonnummer nicht mit einem registrierten Konto verknüpft ist, ist dieser Wert null.
String
application_count
Die Anzahl der Anwendungen, die mit der registrierten Telefonnummer verknüpft sind. Wenn mit der angegebenen Telefonnummer keine Anwendungen verknüpft sind, ist dieser Wert null.
integer
application_id
Liste mit der Anwendungs-ID jeder Anwendung, die mit der angegebenen Telefonnummer verknüpft ist, z. B. [„00000“, „11111“, „22222“]. Jedes Element in dieser Liste steht für dieselbe Anwendung wie das Element mit demselben Index in account_type und application_status. Wenn mit der angegebenen Telefonnummer keine Anwendungen verknüpft sind, ist dieser Wert null.
Liste (String)
account_type
Liste mit dem Kontotyp jeder Anwendung, die mit der angegebenen Telefonnummer verknüpft ist, z. B. [„savings“, „checking“, „demat“]. Jedes Element in dieser Liste steht für dieselbe Anwendung wie das Element mit demselben Index in application_id und application_status. Wenn mit der angegebenen Telefonnummer keine Anwendungen verknüpft sind, ist dieser Wert null.
Liste (String)
application_status
Liste mit dem Status jeder Anwendung, die mit der angegebenen Telefonnummer verknüpft ist, z. B. [„in progress“, „on hold“, „completed“]. Jedes Element in dieser Liste steht für dieselbe Anwendung wie das Element mit demselben Index in application_id und account_type. Wenn mit der angegebenen Telefonnummer keine Anwendungen verknüpft sind, ist dieser Wert null.
Liste (String)

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks für die Telefonbestätigung für diese Komponente aufzurufen.
Anwendung generieren
Der prebuilt_components_open_account:generate_application-Webhook wird von der Komponente verwendet, um eine Anwendung für ein neues Konto zu generieren.
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
user_first_name
Den Vornamen des Nutzers
String
user_last_name
Der Nachname des Nutzers.
String
user_dob
Das Geburtsdatum des Nutzers im Format JJJJ-MM-TT.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
application_id
Die Anwendungs-ID, die für die neue Kontoanfrage generiert wurde.
String

Wenn Sie den Webhook „Generate application“ für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt, um die Anleitung zu sehen.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Bestellung für vorgefertigte Komponente stornieren
bookmark_border
Versionshinweise
Die vorgefertigte Komponente für die Stornierung einer Bestellung prüft die Authentifizierungsstufe eines Nutzers. Nach der Authentifizierung des Nutzers liefert die Komponente Informationen zu seinen letzten oder früheren Bestellungen. Der Nutzer kann dann eine ganze Bestellung oder bestimmte Artikel in einer Bestellung stornieren. Diese Komponente verwendet die vorgefertigte Komponente Einzelhandel – Authentifizierung, um Nutzer zu authentifizieren. Die Komponente verwendet auch Generatoren für die Zusammenfassung nach dem Anruf.
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.
Einzelnes Produkt in letzter Bestellung stornieren
Der Endnutzer wurde bereits authentifiziert. Der Kundenservicemitarbeiter bestätigt, welche Artikel aus der letzten Bestellung storniert werden sollen. Der Kundenservicemitarbeiter prüft die ursprüngliche Zahlungsmethode und bestätigt die Details zur Stornierung mit dem Nutzer.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Geht es um Ihre letzte Bestellung mit der Bestellnummer, die auf 12978 endet, die am 09.11.2023 um 20:00 Uhr aufgegeben wurde und 5 Wasserflaschen und 1 T-Shirt enthält?
Ja

Wir haben in Ihrer Bestellung einige infrage kommende Produkte gefunden. Nennen Sie uns bitte, welches Produkt Sie stornieren möchten.
Produkt 1: Google-Wasserflasche, Produkt 2: Google-T-Shirt.

Nennen oder geben Sie die Produktnummer des Artikels ein, den Sie auswählen möchten, oder sagen Sie „Nächster“, um weitere Produkte zu sehen.
Weiter

In unseren Daten wurden keine weiteren Artikel gefunden. Bitte wählen Sie aus der geteilten Liste aus.
Produkt 1: Google-Wasserflasche, Produkt 2: Google-T-Shirt.

Bitte sprechen 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-Wasserflasche kündigen. Ist das richtig?
Ja

Die verfügbare Menge des von Ihnen ausgewählten Produkts beträgt 5. Geben Sie die Anzahl der Produkte an, die Sie stornieren möchten.
4

Geben Sie bitte den Grund für die Kündigung an. Sie können beispielsweise sagen: „Ich habe meine Meinung geändert“, „Ich benötige den Artikel nicht mehr“, „Ich möchte einen anderen Artikel kaufen“, „Die Lieferung hat sich verzögert“, „Ich habe den Artikel versehentlich gekauft“ oder „Ich möchte die Zahlungsmethode ändern“.
Ich möchte einen weiteren Artikel kaufen

Vielen Dank für die Information.

Möchten Sie ein weiteres Produkt kündigen?
no

Bei Käufen, die über Ihr Wallet getätigt wurden, werden Erstattungen dem Wallet- oder Store-Guthabenkonto gutgeschrieben. Es kann drei bis fünf Arbeitstage dauern, bis die Erstattung auf Ihrem Konto angezeigt wird. Versand- und Bearbeitungsgebühren werden nicht erstattet.

Gesamte Bestellung stornieren
Der Endnutzer wurde bereits authentifiziert. Der Kundenservicemitarbeiter bestätigt, dass der Nutzer eine bestimmte Bestellung stornieren möchte, und erfragt dann den Grund für die Stornierung. Der Kundenservicemitarbeiter prüft die ursprüngliche Zahlungsmethode und bestätigt die Details zur Stornierung mit dem Nutzer.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Geht es um Ihre letzte Bestellung mit der Bestellnummer, die auf 12345 endet und ein Hemd enthält, die Sie am 10. November 2023 um 18:00 Uhr aufgegeben haben?
no

Möchten Sie eine weitere Bestellung stornieren?
Ja

Nennen Sie mir bitte die letzten fünf Ziffern Ihrer Bestell-ID, die Sie verfolgen möchten.
12346

Die letzten fünf Ziffern der Bestell-ID, die wir erhalten haben, lauten 12346. Ist das richtig?
Ja

Sehr gut. Wir haben die Bestell-ID erfasst.

Möchten Sie die gesamte Bestellung stornieren?
Ja

Geben Sie bitte den Grund für die Kündigung an. Sie können beispielsweise sagen: „Ich habe meine Meinung geändert“, „Ich benötige den Artikel nicht mehr“, „Ich möchte einen anderen Artikel kaufen“, „Die Lieferung hat sich verzögert“, „Ich habe den Artikel versehentlich gekauft“ oder „Ich möchte die Zahlungsmethode ändern“.
nicht mehr benötigt

Vielen Dank für Ihre Mitteilung.

Ihre Kündigungsanfrage wurde erstellt.

Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Bestellung stornieren
Entitätstyp
prebuilt_components_[component_name][entity_type] prebuilt_components_product_cancel_reason Webhook prebuilt_components[component_name]:[webhook_action]
prebuilt_components_cancel_order:post_cancellation_details

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_counter
Gibt die Anzahl der zulässigen Wiederholungen an, wenn Sie auswählen, ob Sie mit einem alternativen Konto fortfahren möchten. Der Standardwert ist 2.
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 2.
integer
$flow.max_retry_another_order
Gibt an, wie oft die Auswahl einer anderen Bestellung wiederholt werden darf, wenn die Bestell-ID nicht gefunden wird oder die Bestellung nicht storniert werden kann. 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, in Fällen, in denen mehrere Bestellungen dieselben letzten fünf Ziffern haben. Der Standardwert ist 2.
integer
$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_retry_product_number_counter
Gibt die maximale Anzahl der zulässigen Wiederholungen an, wenn ein Produkt zum Kündigen ausgewählt wird. Der Standardwert ist 2.
integer
$flow.max_product_cancel_confirm_counter
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_select_quantity
Gibt die maximale Anzahl der zulässigen Wiederholungen an, wenn die Menge des zu stornierenden Produkts ausgewählt wird. Der Standardwert ist 2.
integer
$flow.order_product_cancel_reason_others
Gibt den Wert der Entität prebuilt_components_product_cancel_reason an, der angibt, dass der Nutzer „Sonstiges“ als Kündigungsgrund ausgewählt hat. Der Standardwert ist „others“.
String
$flow.max_retry_cancel_reason
Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn der Grund für die Stornierung bestätigt wird. 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

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.
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: Bei der Unterhaltung wurde 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: Es ist ein Webhook-Fehler 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.
Zusammenfassung
Mit dem Summarization-Generator wird eine Zusammenfassung nach dem Anruf generiert, die die von der Komponente verarbeitete Unterhaltung beschreibt.
Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
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_cancel_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_time
Die Uhrzeit, zu der die Bestellung aufgegeben wurde, im Format HH:MM.
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
cancelable_product_id
Liste der Produkt-IDs für stornierbare Produkte in der Bestellung.
Liste (String)
cancelable_product_name
Liste der Produktnamen für stornierbare Produkte in der Bestellung.
Liste (String)
cancelable_product_brand_name
Liste der Markennamen für stornierbare Produkte in der Bestellung.
Liste (String)
cancelable_product_quantity
Liste der Stückzahlen für stornierbare 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.
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.
Details zur Kündigung nach der Kündigung
Über den prebuilt_components_cancel_order:post_cancellation_details-Webhook sendet die Komponente einen Kündigungsantrag.
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.cancel_product_id_list
Liste der Produkt-IDs, die der Nutzer stornieren möchte.
Liste (String)
$flow.cancel_product_quantity_list
Liste der Produktmengen, die der Nutzer stornieren möchte, entsprechend den einzelnen Elementen in $flow.cancel_product_id_list.
Liste (String)
$flow.cancel_reason_list
Liste der Stornierungsgründe für jedes stornierte Produkt, die den einzelnen Elementen in $flow.cancel_product_id_list entspricht.
Liste (String)
$flow.order_refund_mode
Die Zahlungsart für die Erstattung. Gültige Werte werden durch das prebuilt_components_cancel_mode_of_refund-Element definiert.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
order_cancellation_ticket_id
Ticket-ID für die eingereichte Stornierung.
String

Maximieren Sie die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Post cancellation details“ für diese Komponente aufzurufen.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vordefinierte Wartebereichskomponente
bookmark_border
Mit der vordefinierten Warteraumkomponente können Sie Ihren Agenten so konfigurieren, dass Endnutzer ihn bitten können, in der Leitung zu bleiben, z. B. in Fällen, in denen der Endnutzer etwas Zeit benötigt, um die angeforderten Informationen abzurufen. Die Funktion für Warteräume ist in mehreren vordefinierten Komponenten implementiert und kann auch nicht vordefinierten Kundenservicemitarbeitern und ‑komponenten hinzugefügt werden.
Beschränkungen
Zusätzlich zu den allgemeinen Einschränkungen für vordefinierte Komponenten gelten für diese vordefinierte Komponente die folgenden Einschränkungen:
Der Warteraum verlängert nicht die Zeitüberschreitung der Sitzung. Das Standardverhalten findest du unter Sitzungen.
Standardmäßig wird die Warteraumkomponente nach drei nicht übereinstimmenden oder drei eingebauten Ereignissen ohne Eingabe beendet. Dabei wird das Zeitlimit für den Fall, dass keine Sprache erkannt wird, gemäß den in den erweiterten Spracheinstellungen konfigurierten Einstellungen berechnet. Wenn Sie dieses Limit erhöhen möchten, konfigurieren Sie die Ereignis-Handler für „Kein Abgleich“ und „Kein Input“ auf der Seite Main.
Der Wartebereich wird geschlossen, wenn die Sitzung abgelaufen ist oder die Ereignishandler auf der Seite Main erschöpft sind, je nachdem, was zuerst eintritt.
Beispieldialoge
Die folgenden Beispieldialogfelder veranschaulichen gängige Szenarien, die von dieser vorgefertigten Komponente verarbeitet werden.
Erfolgreiche Vorautorisierung
Der Endnutzer bittet den Kundenservicemitarbeiter, kurz zu warten. Sobald der Nutzer „Ich bin bereit“ sagt, kehrt der Kundenservicemitarbeiter zur Unterhaltung zurück.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Nennen oder geben Sie den ersten Teil Ihrer Kreditkartennummer ein. Sie können jederzeit „Abspielen“ sagen, um die aktuell erfassten Nummern zu hören.
Ich brauche eine Minute.

Kein Problem! Lassen Sie mich wissen, wenn Sie bereit sind.
Okay, ich bin jetzt bereit.

Ich helfe Ihnen gerne weiter.

Nennen oder geben Sie bitte den ersten Teil Ihrer Kreditkartennummer ein. Sie können jederzeit „Abspielen“ sagen, um die aktuell erfassten Nummern zu hören.

Unbekannte Eingabe
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Nennen oder geben Sie den ersten Teil Ihrer Kreditkartennummer ein. Sie können jederzeit „Abspielen“ sagen, um die aktuell erfassten Nummern zu hören.
Ich brauche eine Minute.

Kein Problem! Lassen Sie mich wissen, wenn Sie bereit sind.
Sehr gut

Das habe ich nicht verstanden. Ich warte, bis Sie bereit sind, fortzufahren. Sie können sagen: „Ich bin bereit“, und wir fahren dort fort, wo wir aufgehört haben.
Kein Problem.

Hm, das habe ich immer noch nicht verstanden. Achten Sie darauf, dass Sie „Bereit“ sagen.
Nicht sicher

Ich habe Ihre Antwort leider nicht verstanden.

Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Wartezimmer
Komponentenspezifischer Intent
prebuilt_components_[component_name]_[intent_name]
prebuilt_components_waiting_room

Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
Öffnen Sie die Dialogflow CX Console.
Wählen Sie Ihr Google Cloud-Projekt aus.
Wählen Sie den Agent aus.
Wählen Sie den Tab Erstellen aus.
Klicken Sie im Bereich Seiten auf die Startseite.
Fügen Sie eine neue Route mit dem prebuilt_components_waiting_room-Intent hinzu. Dadurch ist dieser Intent von jeder Seite im Navigationsfluss aus zugänglich. Weitere Informationen finden Sie unter Routen auf Flussebene.
Klicken Sie auf Speichern.
Fügen Sie auf den Seiten, auf denen Sie den Warteraum aktivieren möchten, zwei neue Routen hinzu.
Mit der ersten Route kann die Unterhaltung zu der Seite zurückkehren, auf der der Endnutzer den Kundenservicemitarbeiter ursprünglich gebeten hat, in der Leitung zu bleiben:
Condition (Bedingung): $session.params.from_waiting_room_reusable_flow = true
Parametervorgaben:
Parameter: from_waiting_room_reusable_flow
Wert: false
Übergangsseite: Aktuelle Seite
Mit dem zweiten Pfad wird festgelegt, was passiert, nachdem ein Endnutzer das Limit für die Anzahl der Wiederholungen bei „No-Match“ oder „No-Input“ im Wartebereich überschritten hat:
Condition (Bedingung): $session.params.waiting_room_event_handler = true
Parametervorgaben:
Parameter: waiting_room_event_handler
Wert: null
Übergangsseite: Sie sollte so festgelegt werden, dass klar ist, was passieren soll, nachdem der Endnutzer alle Wiederholungsversuche für den Warteraum-Vorgang genutzt hat. Beispielsweise kann er zu einer anderen Seite weitergeleitet oder der Ablauf oder die Sitzung beendet werden.
Abgeschlossen
Ihr Agent sollte jetzt eingerichtet und bereit zum Testen sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vordefinierter Shopping Assistant-Agent mit Vertex AI Search for Retail
bookmark_border
Preview
This product or feature is subject to the „Pre-GA Offerings Terms“ in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available „as is“ and might have limited support. For more information, see the launch stage descriptions.
Der Playbook-basierte vorkonfigurierte Kundenservicemitarbeiter für den Shopping Assistant beantwortet Fragen zu Einzelhandelsprodukten, zur Bestellung, zum Bestellstatus und zur Bestellstornierung. Dabei werden Vertex AI Search for Retail und benutzerdefinierte Fulfillment-Nutzlast verwendet, um eine ansprechende visuelle Darstellung zu ermöglichen.
Beispieldialoge
Die folgenden Beispieldialoge veranschaulichen gängige Szenarien, die von diesem vordefinierten Agenten verarbeitet werden.
Produkt- und Rezensionsvergleich
Der Nutzer möchte sich traditionelle Saris ansehen. Der Kundenservicemitarbeiter präsentiert einige beliebte Optionen und der Nutzer wählt die erste aus. Der Nutzer fragt nach passenden Schuhen. Der Kundenservicemitarbeiter präsentiert beliebte Optionen. Der Nutzer bittet um einen Vergleich der Rezensionen und wählt die Option mit der höchsten Bewertung aus. Der Kundenservicemitarbeiter fragt nach der Größe und bestätigt, dass die Schuhe in den Einkaufswagen gelegt wurden.
Nutzereingabe
Antwort des Kundenservicemitarbeiters
zeige mir traditionelle Saris

[Produkte präsentieren] Haben Sie Interesse an einem dieser Produkte oder suchen Sie nach anderen Optionen?
Der erste sieht gut aus.

Gute Wahl. Das indische Schönheits-Selbstdesign, gedruckte Mode Georgette Sari ist ein schönes Stück. Da Saris in der Regel in einer Einheitsgröße erhältlich sind, passt er perfekt. Möchten Sie ihn in Ihren Einkaufswagen legen?
Haben Sie dazu passende Pumps?

[Produkte präsentieren] Haben Sie Interesse an einem dieser Produkte oder suchen Sie nach anderen Optionen?
Ja, aber können Sie sich die Kundenrezensionen ansehen und die beste davon auswählen?

Die Damenschuhe von Flat n Heels haben eine durchschnittliche Bewertung von 4 von 5 Sternen, während die Damenschuhe von Glitzy Galz eine durchschnittliche Bewertung von 4,5 von 5 Sternen haben. Kunden, die die Flat n Heels Women Heels gekauft haben, haben gemischte Rezensionen abgegeben. Einige fanden sie zuerst bequem, nach einigen Stunden aber unbequem, während andere ihren Komfort lobten. Die Glitzy Galz Women Heels hingegen erhielten überwiegend positive Rezensionen. Die Kunden lobten die Passform, Qualität und das Design. Welchen möchten Sie in Ihren Einkaufswagen legen?
diejenige mit den besten Rezensionen und Bewertungen

Die Glitzy Galz Women Heels haben die höchste Bewertung von 4,5 von 5 Sternen. Welche Größe möchten Sie für die Glitzy Galz-Stilettos wählen? Wir haben Größen von 36 bis 46.
6

Perfekt! Die Glitzy Galz-Stilettos in Größe 6 wurden Ihrem Einkaufswagen mit einer Stückzahl von 1 hinzugefügt. Möchten Sie noch etwas in den Einkaufswagen legen?

End-to-End-Einkaufserlebnis
Der Nutzer sieht sich den Produktkatalog an. Der Kundenservicemitarbeiter unterbreitet Empfehlungen basierend auf der Anfrage des Nutzers. Nach einigen Suchanfragen findet der Nutzer einen Artikel, den er kaufen möchte. Der Kundenservicemitarbeiter bestätigt die Größe und Stückzahl des zu kaufenden Artikels sowie das voraussichtliche Lieferdatum. Der Nutzer fordert ein anderes Lieferdatum an, das nicht verfügbar ist, und stimmt dem ursprünglichen Lieferdatum zu. Der Kundenservicemitarbeiter bestätigt die hinterlegten Liefer-, Zahlungs- und Kontaktdaten. Der Nutzer aktualisiert die Lieferinformationen und bestätigt sie. Der Kundenservicemitarbeiter gibt die Bestellung auf und nennt dem Nutzer die Bestellnummer.
Nutzereingabe
Antwort des Kundenservicemitarbeiters
Es wird kalt. Haben Sie gute Pullover?

[Presents products] Haben Sie Interesse an einem dieser Produkte oder suchen Sie nach anderen Optionen?
Der Damenpullover gefällt mir für meine Frau, aber ich suche einen Jungenpullover.

[Presents products] Haben Sie Interesse an einem dieser Produkte oder suchen Sie nach anderen Optionen?
den ersten Damenpullover in den Einkaufswagen legen

Welche Größe möchten Sie für den Nineteen Solid Round Neck Casual Women’s Sweater wählen? Wir haben Größen von XS bis XXL.
Mittel

Perfekt! Der Nineteen Solid Round Neck Casual Women’s Sweater in Größe M wurde Ihrem Einkaufswagen mit einer Stückzahl von 1 hinzugefügt. Möchten Sie noch etwas in den Einkaufswagen legen?
no

Der Nineteen Solid Round Neck Casual Women’s Sweater kann frühestens am 29. April 2024 geliefert werden. Wären Sie daran interessiert?
Können Sie es am 28. April liefern?

Leider können wir den Damenpullover „Nineteen Solid Round Neck Casual“ nicht am 28. April 2024 liefern. Die früheste Lieferung ist der 29. April 2024.
Ok, lassen Sie den Liefertermin unverändert.

Alles klar. Ihr Nineteen Solid Round Neck Casual Women’s Sweater wird am 29. April 2024 geliefert. Prüfen wir jetzt Ihre Profildetails, um sicherzugehen, dass alles auf dem neuesten Stand ist:\
Lieferadresse: 638 Maple Street, Apt 11, Cupertino, CA 95014\

Zahlungsinformationen: Visa-Karte mit der Endung 4111
Kontaktnummer: 416-555-5555
E-Mail-Adresse: email@beispiel.de
Bitte prüfen Sie diese Angaben. Wenn alles korrekt ist, bestätigen Sie einfach. Wenn Sie Änderungen vornehmen möchten, lassen Sie es mich wissen.
Meine Adresse lautet jetzt 371 Talbot Street Carmichael, CA 95608.

Ihre Lieferadresse wurde auf 371 Talbot Street, Carmichael, CA 95608 aktualisiert. Möchten Sie sonst noch etwas ändern?
no

Ihre Bestellung für den Nineteen Solid Round Neck Casual Women’s Sweater mit der Bestell-ID ee6b4cc7 wurde erfolgreich aufgegeben. Die Lieferung ist für den 29. April 2024 geplant.
Viele Grüße

Ihre Bestellung wurde aufgegeben. Kann ich Ihnen noch bei weiteren Fragen helfen?
Nein danke

Schön, dass ich Ihnen weiterhelfen konnte. Wenn Sie etwas von Cymbal Apparel benötigen, bin ich nur einen Klick entfernt.\

Status einer Bestellung prüfen
Der Nutzer möchte den Status einer Bestellung prüfen. Der Kundenservicemitarbeiter erfragt die Bestellnummer und ruft die Bestellinformationen ab. Der Kundenservicemitarbeiter gibt Details zu den Artikeln in der Bestellung sowie den aktuellen Status und das voraussichtliche Lieferdatum an.
Nutzereingabe
Antwort des Kundenservicemitarbeiters
Hallo

Du kannst eine der Optionen oben auswählen oder einfach eingeben, wonach du suchst. Ich helfe dir dann gerne weiter.
Ich möchte den Status meiner Bestellung prüfen.

Dabei kann ich Ihnen gern helfen. Nennen Sie mir bitte zuerst Ihre Bestell-ID.
ee6b4cc7

Ihre Bestellung wurde bestätigt. Die Bestellung wird derzeit bearbeitet.
Sie haben Folgendes bestellt:
Nineteen Solid Round Neck Casual Women’s Sweater
Größe: Medium
Menge: 1
Geschätzte Lieferung: 29. April 2024
Kann ich sonst noch etwas für Sie tun?
Nein danke

Schön, dass ich Ihnen weiterhelfen konnte. Wenn du etwas von Cymbal Apparel benötigst, kannst du dich jederzeit gern an mich wenden.

Bestellung zurückgeben
Der Nutzer möchte eine Bestellung zurückgeben. Der Kundenservicemitarbeiter erfragt die Bestellnummer, ruft die Bestelldetails ab und bestätigt den Artikel, der zurückgegeben werden soll. Der Kundenservicemitarbeiter leitet dann die Rückgabe ein und stellt dem Nutzer ein Rücksendelabel zur Verfügung, das er ausdrucken und auf das Paket kleben kann.
Nutzereingabe
Antwort des Kundenservicemitarbeiters
Hallo

Du kannst eine der Optionen oben auswählen oder einfach eingeben, wonach du suchst. Ich helfe dir dann weiter.
Ich möchte meine Bestellung zurückgeben

Ich helfe Ihnen gern bei Ihrer Rücksendung. Nennen Sie mir bitte zuerst Ihre Bestellnummer.
0fc77d64

Vielen Dank, dass Sie Ihre Bestellnummer angegeben haben. Ich habe Ihre Bestellung vom 12. April 2024 gefunden. Die Bestellung enthält ein dunkelblaues YK-T-Shirt mit Rundhalsausschnitt für Jungen in Größe S. Ist das der Artikel, den Sie zurückgeben möchten?
Ja

In Ordnung, ich habe die Rückgabe initiiert. Das Rücksendelabel finden Sie unten im Anhang. Bitte drucken Sie ihn aus und kleben Sie ihn auf das Paket, bevor Sie es zurücksenden. Kann ich Ihnen noch bei weiteren Fragen helfen?
Nein danke

Schön, dass ich Ihnen weiterhelfen konnte. Wenn du etwas von Cymbal Apparel benötigst, kannst du dich jederzeit gern an mich wenden.

Grundlegende Einrichtung
So richten Sie diesen vordefinierten Agent ein:
Importieren Sie den vordefinierten Agenten.
Konfigurieren Sie die bereitgestellten Tools mit Ihren externen Diensten. Weitere Informationen finden Sie unter Tool-Einrichtung.
Tool-Einrichtung
Dieser Agent enthält Tools, die für die Einbindung in externe Dienste verwendet werden. So konfigurieren Sie diese Tools:
Erstellen Sie eine Firestore-Datenbank mit dem Namen apparel-db.
Erstellen Sie einen Firestore-Integrations-Connector.
Laden Sie die Anwendungsintegration für den Shopping Assistant herunter.
Ersetzen Sie alle Verweise auf projects/customermod-genai-sa/locations/us-central1/connections/firestore durch die Kennung des in Schritt 2 erstellten Connectors.
Laden Sie die Integration hoch und veröffentlichen Sie sie.
Weisen Sie Ihrem Dialogflow-Dienst-Agent die Rolle Application Integration Invoker zu.
Aktualisieren Sie die Property paths, damit sie in den OpenAPI-Spezifikationen der folgenden Tools auf die Integration verweist, die Sie in Schritt 5 erstellt haben: get-order-status, order-lookup, place-order und return-order.
Google Produktsuche
Das search-products-Tool ruft die am besten übereinstimmenden Produkte basierend auf der Suchanfrage und dem Offsetwert aus dem Produktkatalog ab. Das Tool gibt eine benutzerdefinierte Nutzlastantwort zurück, die Produktdetails enthält. Diese benutzerdefinierte Nutzlast wird von der Benutzeroberfläche verwendet, um die Produkte in Form von Rich Content anzuzeigen.
Produktdetails
Das get-product-details-Tool ruft Produktdetails mithilfe der Retail API aus dem Produktkatalog ab. Die abgerufenen Produktdetails werden dann in ein vereinfachtes Format umgewandelt und zurückgegeben. Der Kundenservicemitarbeiter kann damit Fragen zu Produkten beantworten, die er dem Nutzer angezeigt hat.
Rezensionen
Mit dem get-reviews-Tool können Rezensionen für Produkte abgerufen werden. Es wird eine Liste der angezeigten Produkte erwartet und es werden Rezensionen für jedes Produkt abgerufen. Die generierten Rezensionen werden in ein benutzerdefiniertes Vorlagenformat (review_template) umgewandelt, das sich in einer umfassenden Benutzeroberfläche anzeigen lässt.
Ähnliche Produkte
Mit dem similar-products-Tool können Sie mithilfe der Retail Recommendation API Produkte finden, die einem bestimmten Produkt ähneln. Sie akzeptiert eine Produkt-ID und nutzt die Retail Recommendation API, um ähnliche Produkte aus dem Produktkatalog vorherzusagen.
Lieferdatum
Das store-delivery-date-Tool ist für das Speichern des bevorzugten Liefertermins des Nutzers für Artikel im Einkaufswagen verantwortlich. Dieser sollte mit dem frühesten geschätzten Liefertermin verglichen werden.
Das get-delivery-date-Tool ist für die Schätzung des Liefertermins für Artikel im Einkaufswagen verantwortlich.
Nutzerdaten
Das Tool get-user-info ruft die personenbezogenen Daten des Nutzers ab, einschließlich Versandadresse, Zahlungsinformationen, Telefonnummer und E-Mail-Adresse. Das Tool „update-user-info“ ist für die Aktualisierung der Nutzerinformationen verantwortlich.
Bestellverwaltung
Das place-order-Tool übernimmt die Bestellung der Artikel im Einkaufswagen. Die Bestellung wird in Firestore mit den Bestelldaten gespeichert, einschließlich Bestell-ID, Status, Erstellungszeitstempel und Liste der Produkte. Die Bestellnummer wird an den Kundenservicemitarbeiter zurückgegeben.
Das order-lookup-Tool ruft Bestelldaten anhand der angegebenen Bestell-ID aus einer Firestore-Datenbank ab.
Das return-order-Tool aktualisiert den Status einer Bestellung in der Firestore-Datenbank zu „return_pending“, was bedeutet, dass die Rücksendung vom Kunden initiiert wurde und die Bestellung noch aussteht.
Das get-order-status-Tool ist für das Abrufen des Status einer Bestellung und, falls die Bestellung versandt wurde, für die Sendungsverfolgung über die DHL API verantwortlich. Je nach Status der Bestellung werden entsprechende Nachrichten angezeigt.
Abgeschlossen
Ihr Agent und seine Integrationen sollten jetzt eingerichtet und bereit für den Test sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vordefinierte Komponente „Kontoguthaben“
bookmark_border
Versionshinweise
Die vordefinierte Komponente für das Kontoguthaben prüft die Authentifizierungsebene eines Kunden und stellt einem authentifizierten Kunden dann Informationen zum Kontoguthaben zur Verfügung. Wenn der Kunde mehrere Konten hat, bestätigt die Komponente das Konto, für das der Kunde das Guthaben abrufen möchte. Diese Komponente verwendet die vordefinierte Komponente Authentifizierung, um Nutzer zu authentifizieren.
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.
Einzelkonto
Der Endnutzer hat ein einzelnes Konto und erhält das Kontoguthaben.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Der Kundenservicemitarbeiter authentifiziert den Nutzer mit der vordefinierten Komponente Authentication

Vielen Dank. Sie wurden erfolgreich authentifiziert.

Bitte warten Sie, während wir Ihre Kontodetails abrufen.

Das Guthaben des Kontos, das auf 4567 endet, beträgt 50,00 $.

Mehrere Konten
Der Endnutzer hat mehrere Konten. Der Kundenservicemitarbeiter fordert und bestätigt die letzten vier Ziffern der Kontonummer und gibt das Kontoguthaben für dieses Konto an.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Der Kundenservicemitarbeiter authentifiziert den Nutzer mit der vordefinierten Komponente Authentication

Vielen Dank. Sie wurden erfolgreich authentifiziert.

Bitte warten Sie, während wir Ihre Kontodetails abrufen.

Wir haben festgestellt, dass mit Ihrer Nummer zwei Konten verknüpft sind.

Können Sie uns bitte die letzten vier Ziffern des Kontos nennen, auf das Sie sich beziehen?
2002

Die letzten vier Ziffern der Kontonummer, die wir erhalten haben, lauten 2002. Ist das richtig?
Ja

Ihr Guthaben auf dem Konto mit der Endung 2002 beträgt 5.000 $.

Mehrere Konten mit Kontext
Der Endnutzer hat mehrere Konten. Die angegebene Kontonummer wird aus der vorherigen Absicht übernommen und das Kontoguthaben wird angegeben.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Bitte warten Sie, während wir Ihre Kontodetails abrufen.

Wir haben festgestellt, dass mit Ihrer Nummer drei Konten verknüpft sind.

Suchen Sie die Kontonummer, die auf 4567 endet?
Ja

Ihr Guthaben auf dem Konto mit der Endziffer 4567 beträgt 50 $.

Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Kontostand
Komponentenspezifischer Intent
prebuilt_components_[component_name][intent_name] prebuilt_components_account_number_collection_four_digit_account_number Webhook prebuilt_components[component_name]:[webhook_action]
prebuilt_components_account_balance:get_account_balance

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 Ablaufebene müssen wie unten beschrieben 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.auth_level
(Optional) Gibt die Authentifizierungsebene des Aufrufers an.
integer
$session.params.auth_level_req
Gibt die Authentifizierungsstufe an, die erforderlich ist, damit ein Nutzer auf sein Guthaben zugreifen kann. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert 1.
integer
$session.params.account_auth_enabled
Gibt an, ob der Nutzer wie unter Authentifizierungstypen beschrieben als Kontoinhaber authentifiziert werden soll. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert true.
boolean
$session.params.card_auth_enabled
Gibt an, ob der Nutzer wie unter Authentifizierungstypen beschrieben als Karteninhaber authentifiziert werden soll. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert false.
boolean
$session.params.phone_number
(Optional) Die registrierte Telefonnummer des Kunden, die für die Authentifizierung verwendet wird.
String
$session.params.account_count
(Optional) Anzahl der Konten, die mit dem authentifizierten Nutzer verknüpft sind.
integer
$session.params.last_four_digit_of_account_number
(Optional) Die letzten vier Ziffern der Kundenkontonummer, für die das Guthaben angegeben werden muss. Wenn der Kunde nur ein Konto hat, werden diese Informationen nach der Authentifizierung automatisch abgerufen. Wenn der Kunde mehrere Konten hat, wird die jeweilige Kontonummer vom Kunden erfasst.
String
$flow.max_retry_acc_number
Gibt die zulässige Anzahl von Wiederholungsversuchen an, wenn die letzten vier Ziffern der Kontonummer des Endnutzers erfasst werden. Der Standardwert ist 3.
integer

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.
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
auth_level
Gibt die Authentifizierungsstufe des Anrufers an.
integer
phone_number
Die Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.
String
account_count
Die Anzahl der Konten, die mit der registrierten Telefonnummer verknüpft sind. Dazu gehören eigene Konten und Konten, für die der Nutzer eine Vollmacht hat.
integer
last_four_digit_of_account_number
Wenn ein Nutzer nur ein Konto hat, werden die letzten vier Ziffern der Kontonummer zurückgegeben. Wenn ein Nutzer mehrere Konten hat, ist der Wert dieses Parameters die letzten vier Ziffern der Kontonummer, für die der Nutzer Informationen zum Kontostand erhalten möchte.
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: Bei der Unterhaltung wurde 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: Es ist ein Webhook-Fehler 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

Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unten 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 findest du unter Authentifizierungs-Webhook einrichten.
Konto bestätigen
Mit dem prebuilt_components_account_services:validate_account-Webhook wird anhand der registrierten Telefonnummer des Nutzers und der letzten vier Ziffern der angegebenen Kontonummer überprüft, ob ein Konto vorhanden ist. Der Webhook gibt auch das Kontoguthaben zurück, falls ein Konto vorhanden 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
$session.params.last_four_digit_of_account_number
Die letzten vier Ziffern der Kontonummer, für die der Nutzer Informationen zum Kontostand ausgewählt und bestätigt hat.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
account_found
Gibt an, ob für das registrierte Konto des Nutzers ein Konto mit den angegebenen letzten vier Ziffern vorhanden ist.
boolean
Kontostand
Der Betrag des aktuellen Kontostands, falls vorhanden.
Zahl

Wenn Sie den Webhook „Konto bestätigen“ für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vorgefertigte Komponente „Karte sperren“
bookmark_border
Versionshinweise
Die vordefinierte Komponente zum Sperren von Karten authentifiziert den Nutzer, ruft Karten ab, die auf den Nutzer registriert sind, und ermöglicht es ihm, eine Karte vorübergehend oder dauerhaft zu sperren oder wieder zu aktivieren. Nachdem der Nutzer eine gesperrte Karte bestätigt hat, kann er über die Komponente eine neue Karte anfordern. Bei dieser Komponente wird eine benutzerdefinierte Version der vordefinierten Komponente Authentifizierung verwendet, um Karteninhaber zu authentifizieren.
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.
Nicht authentifizierter Nutzer mit mehreren Karten
Der Kundenservicemitarbeiter stellt fest, dass der Nutzer noch nicht authentifiziert wurde, und erhebt Informationen, um zu bestätigen, dass der Nutzer ein registrierter Karteninhaber ist. Nachdem sich der Nutzer authentifiziert hat, ruft der Kundenservicemitarbeiter Informationen zu den Karten ab, die auf den Nutzer registriert sind. Der Nutzer bestätigt, dass er eine ausgewählte Karte vorübergehend sperren möchte, und der Kundenservicemitarbeiter generiert die Anfrage zum Sperren der Karte.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Der Kundenservicemitarbeiter authentifiziert den Nutzer mit der vordefinierten Komponente Authentication

Vielen Dank. Sie wurden erfolgreich authentifiziert.

Bitte warten Sie, während wir Ihre Kartendetails abrufen.

Wir haben mehrere Karten mit Ihrer Nummer gefunden. Wir haben eine Visa-Karte, die auf 5555 endet, eine Visa-Karte, die auf 6666 endet, eine MasterCard, die auf 4444 endet, und eine MasterCard, die auf 4449 endet.

Bitte teilen Sie uns die letzten vier Ziffern der Karte mit, die Sie sperren oder reaktivieren möchten.
4444

Die letzten vier Ziffern der Kartennummer, die wir erhalten haben, lauten 4444. Ist das richtig?
Ja

Möchten Sie Ihre Karte vorübergehend oder dauerhaft sperren?
Ich möchte es vorübergehend sperren

Bitte teilen Sie uns mit, warum Sie Ihre Karte sperren möchten. Sie können Optionen wie „Beschädigt“, „Geklüngelt“ oder „Verloren“ auswählen.
Es wurde beschädigt.

Das tut mir leid. Aus Sicherheitsgründen müssen wir Ihre Identität bestätigen. Dazu senden wir Ihnen einen Code. Möchten Sie den Code lieber per Telefon oder per E-Mail erhalten?
An mein Smartphone senden

Okay. Bevor wir fortfahren, senden wir einen Code an Ihre registrierte Mobiltelefonnummer. Können Sie bitte Ihren Code bestätigen, um die Anfrage zu validieren?
123456

Ihre Karte mit den Endziffern 4444 wird vorübergehend gesperrt. Danach können Sie mit dieser Karte keine Transaktionen mehr online oder an Kassen durchführen. Bestätigen Sie diese Aktion?
Ja

Ihre Karte wurde gesperrt. Ihre Anfragenummer lautet 9711485 und wurde an Ihre registrierte Mobiltelefonnummer gesendet.

Authentifizierter Nutzer mit einer einzelnen Karte
Der Kundenservicemitarbeiter erkennt, dass der Nutzer bereits authentifiziert wurde, und ruft Informationen zur für den Nutzer registrierten Karte ab. Der Nutzer wählt aus, dass die Karte dauerhaft gesperrt werden soll, und der Kundenservicemitarbeiter generiert die entsprechende Anfrage. Der Kundenservicemitarbeiter fragt den Nutzer dann, ob er eine neue Karte für die dauerhaft gesperrte Karte ausstellen lassen möchte, und erstellt einen Antrag auf Neuausstellung der Karte.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Bitte warten Sie, während wir Ihre Kartendetails abrufen.

Wir haben Ihre MasterCard mit der Endung 4444 gefunden. Möchten Sie Ihre Karte vorübergehend oder dauerhaft sperren?
Dauerhaft

Bitte teilen Sie uns mit, warum Sie Ihre Karte sperren möchten. Sie können Optionen wie „Beschädigt“, „Geklödert“ oder „Verloren“ auswählen.
Es war beschädigt

Das tut mir leid. Keine Sorge, wir sperren Ihre Karte dauerhaft. Können Sie bestätigen, dass die Karte auf 4444 endet?
Ja

Okay. Bevor wir fortfahren, senden wir einen Code an Ihre registrierte Mobiltelefonnummer. Können Sie bitte Ihren Code bestätigen, um die Anfrage zu validieren?
123456

Ihre Karte mit den Endziffern 4444 wird vorübergehend gesperrt. Danach können Sie mit dieser Karte keine Transaktionen mehr online oder an Kassen durchführen. Bestätigen Sie diese Aktion?
Ja

Ihre Karte wurde gesperrt. Ihre Anfragenummer lautet 6108410 und wurde an Ihre registrierte Mobiltelefonnummer gesendet.

Möchten Sie eine neue Karte ausstellen lassen?
Ja

Wir liefern die Karte an Ihre registrierte Adresse. Können Sie bitte die Postleitzahl Ihrer Lieferadresse bestätigen, 12345?
Das ist richtig.

Okay, bitte warten Sie einen Moment, während wir die Neuausstellung einer neuen Karte beantragen.

Der Antrag auf Neuausstellung der neuen Karte war erfolgreich. Ihre Anfragenummer lautet 3808109 und wurde an Ihre registrierte Mobiltelefonnummer gesendet.

Die Karte wird innerhalb von 3 Arbeitstagen an Ihre registrierte Adresse geliefert. Folgen Sie der Anleitung, die Sie mit der Karte erhalten haben, um sie zu verwenden.

Karte reaktivieren
Der Kundenservicemitarbeiter erkennt, dass für den Nutzer eine zusätzliche Authentifizierung erforderlich ist, und sendet ein Einmalpasswort, um die Identität des Nutzers zu bestätigen. Der Nutzer möchte eine Karte reaktivieren und der Kundenservicemitarbeiter leitet ihn an einen Kundenservicemitarbeiter weiter.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Aus Sicherheitsgründen müssen wir Ihre Identität bestätigen. Dazu senden wir Ihnen einen Code. Möchten Sie den Code lieber per Telefon erhalten?
Ja

Wir haben einen Code an Ihre registrierte Telefonnummer mit der Endung 5041 gesendet. Das kann einige Sekunden dauern. Können Sie bitte den Code bestätigen?
123456

Vielen Dank. Ihre Angaben wurden bestätigt.

Bitte warten Sie, während wir Ihre Kartendetails abrufen.

Wir haben mehrere Karten mit Ihrer Nummer gefunden. Wir haben eine Visa-Karte mit der Endung 1456, eine MasterCard mit der Endung 1457, eine American Express-Karte mit der Endung 1345 und eine Visa-Karte mit der Endung 3456.

Nennen Sie uns die letzten vier Ziffern der Karte, die Sie sperren oder reaktivieren möchten.
1456

Die letzten vier Ziffern der Kartennummer, die wir erhalten haben, lauten 1456. Ist das richtig?
Ja

Die angeforderte Karte ist bereits vorübergehend gesperrt. Möchten Sie die Karte reaktivieren oder dauerhaft sperren?
Reaktivieren

Bitte haben Sie einen Moment Geduld, während wir Sie weiterleiten, damit wir Ihnen besser helfen können.

Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Karte sperren
Entitätstyp
prebuilt_components_[component_name][entity_type] prebuilt_components_lock_card_locked_reason Webhook prebuilt_components[component_name]:[webhook_action]
prebuilt_components_lock_card:lock_card_ticket_number

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 Ablaufebene müssen wie unten beschrieben 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.auth_level
(Optional) Gibt die Authentifizierungsebene des Aufrufers an.
integer
$session.params.auth_level_req
Gibt die Authentifizierungsebene an, die erforderlich ist, damit ein Nutzer auf seinen Transaktionsverlauf zugreifen kann. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert 1.
integer
$session.params.account_auth_enabled
Gibt an, ob der Nutzer wie unter Authentifizierungstypen beschrieben als Kontoinhaber authentifiziert werden soll. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert false.
boolean
$session.params.card_auth_enabled
Gibt an, ob der Nutzer wie unter Authentifizierungstypen beschrieben als Karteninhaber authentifiziert werden soll. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert true.
boolean
$session.params.phone_number
(Optional) Die registrierte Telefonnummer des Kunden, die für die Authentifizierung verwendet wird.
String
$session.params.card_count
(Optional) Anzahl der Kreditkarten, die mit dem authentifizierten Nutzer verknüpft sind.
integer
$flow.card_status_active
Gibt den Wert des Parameters an, der vom Webhook „Validate card“ zurückgegeben wird, um anzugeben, dass die ausgewählte Karte derzeit aktiv ist. Der Standardwert ist „active“.
String
$flow.card_status_lock_temp
Gibt den Wert des Parameters an, der vom Webhook „Validate card“ zurückgegeben wird, um anzugeben, dass die ausgewählte Karte vorübergehend gesperrt ist. Der Standardwert ist „inactive“.
String
$flow.card_status_lock_permanent
Gibt den Wert des Parameters an, der vom Webhook „Validate card“ zurückgegeben wird, um anzugeben, dass die ausgewählte Karte dauerhaft gesperrt ist. Der Standardwert ist „blocked“.
String
$flow.card_status_reactivate
Gibt den Wert des Parameters an, der vom Webhook „Validate card“ zurückgegeben wird, um anzugeben, dass die ausgewählte Karte reaktiviert wurde. Der Standardwert ist „reactivate“.
String
$flow.max_retry_card_number
Gibt die zulässige Anzahl von Wiederholungsversuchen an, wenn die letzten vier Ziffern der Kreditkarte erfasst werden. Der Standardwert ist 3.
integer
$flow.max_otp_retry_count
Gibt die Anzahl der zulässigen Wiederholungen an, wenn das Einmalpasswort (OTP) vom Nutzer erfasst wird. Der Standardwert ist 3.
integer

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.
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
auth_level
Gibt die Authentifizierungsstufe des Anrufers an.
integer
phone_number
Die Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.
String
card_count
Die Anzahl der Karten, die mit der registrierten Telefonnummer verknüpft sind.
integer
last_four_digit_of_card_number
Wenn ein Nutzer nur eine Karte hat, werden die letzten vier Ziffern der Kartennummer zurückgegeben. Wenn ein Nutzer mehr als eine Karte hat, entspricht der Wert dieses Parameters den letzten vier Ziffern der Karte, die der Nutzer zum Sperren oder Neuausstellen ausgewählt hat.
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: Bei der Unterhaltung wurde 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: Es ist ein Webhook-Fehler 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

Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unten 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 findest du unter Authentifizierungs-Webhook einrichten.
Kartendetails abrufen
Über den prebuilt_components_account_services:get_card_details-Webhook erhält die Komponente Informationen zu den Karten, die für einen Nutzer registriert sind.
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

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
last_four_digit_of_all_cards
Liste mit den letzten vier Ziffern jeder Karte, die für den Nutzer registriert ist, z. B. [„0000“, „1111“, „2222“]. Jedes Element in dieser Liste entspricht derselben Karte wie das Element mit demselben Index in card_vendor_all.
Liste (String)
card_vendor_all
Liste mit dem Kreditkartenanbieter für jede Karte, die für den Nutzer registriert ist, z. B. [„Visa“, „Mastercard“, „Discover“]. Jedes Element in dieser Liste entspricht derselben Karte wie das Element mit demselben Index in last_four_digit_of_all_cards.
Liste (String)
card_count
Anzahl der Karten, die mit dem authentifizierten Nutzer verknüpft sind.
integer

Maximiere die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Kartendetails abrufen“ für diese Komponente aufzurufen.
Karte bestätigen
Über den prebuilt_components_lock_card:validate_card-Webhook erhält die Komponente Informationen zu einer bestimmten Karte, die im Konto eines Nutzers registriert 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
$session.params.last_four_digit_of_card_number
Die letzten vier Ziffern der Kartennummer, die der Nutzer sperren lassen möchte.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
zip_code
Die Postleitzahl, die mit dem Konto des Nutzers verknüpft ist.
String
card_vendor
Der Kreditkartenanbieter der ausgewählten Karte.
String
card_status
Gibt den aktuellen Status der Karte an. Gültige Werte sind standardmäßig „aktiv“, „vorübergehend blockiert“ oder „dauerhaft blockiert“. Diese Status werden durch die Parameter $flow.card_status_active, $flow.card_status_lock_temp und $flow.card_status_lock_permanent angegeben. Siehe Eingabeparameter.
String

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Karten prüfen“ für diese Komponente aufzurufen.
Karte sperren
Der prebuilt_components_lock_card:lock_card_ticket_number-Webhook wird von der Komponente verwendet, um eine Anfrage zum Sperren einer ausgewählten Karte zu erstellen.
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
$session.params.last_four_digit_of_card_number
Die letzten vier Ziffern der Kartennummer, die der Nutzer sperren lassen möchte.
String
$flow.lock_type
Gibt an, welche Sperre auf die Karte des Nutzers angewendet werden soll. Gültige Werte werden durch das benutzerdefinierte Element prebuilt_components_lock_card_lock_type_active definiert. Standardmäßig werden „blocked“ (dauerhafte Sperre) und „inactive (temporäre Sperre) unterstützt.
String
$flow.lock_reason
Gibt an, warum der Nutzer die Sperrung der Karte beantragt hat. Gültige Werte werden durch das benutzerdefinierte Element prebuilt_components_lock_card_locked_reason definiert. Standardmäßig werden „damaged“, „stolen“, „lost“ und „others“ unterstützt.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
ticket_number
Die Ticketnummer für die erstellte Anfrage zur Sperrung einer Karte.
integer

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks für die Sperrung von Karten für diese Komponente aufzurufen.
Karte neu ausstellen
Mit dem prebuilt_components_lock_card:reissue_card_number-Webhook wird von der Komponente eine Anfrage zum Neuausstellen einer neuen oder aktualisierten Karte erstellt.
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
$session.params.last_four_digit_of_card_number
Die letzten vier Ziffern der Kartennummer, die der Nutzer sperren lassen möchte.
String
zip_code
Die Postleitzahl, die mit dem Konto des Nutzers verknüpft ist.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
acknowledgement_number
Die Ticketnummer für die erstellte Anfrage zur Neuausstellung einer Karte.
integer

Wenn Sie den Webhook „Karte neu ausstellen“ für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt und folgen Sie der Anleitung.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vordefinierte Komponente für Kontoabrechnungen
bookmark_border
Versionshinweise
Die vorgefertigte Komponente für Kontoabrechnungen prüft die Authentifizierungsebene eines Kunden und sendet die Kontoabrechnung dann für einen bestimmten Zeitraum an einen authentifizierten Kunden. Wenn der Kunde mehrere Konten hat, bestätigt die Komponente das Konto, für das der Kunde einen Kontoauszug abrufen möchte. Diese Komponente verwendet die vordefinierte Komponente Authentifizierung, um Nutzer zu authentifizieren, und eine benutzerdefinierte Version der Datensatzsammlung „Geburtsdatum“, um Start- und Enddatum für den Abrechnungszeitraum zu erfassen.
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.
Einzelkonto
Der Endnutzer hat ein einzelnes Konto. Der Kundenservicemitarbeiter erfasst das Start- und Enddatum der Kontoabrechnung, ob der Nutzer die Kontoabrechnung verschlüsseln möchte, und sendet die Kontoabrechnung an den Nutzer.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Der Kundenservicemitarbeiter authentifiziert den Nutzer mit der vordefinierten Komponente Authentication

Vielen Dank. Sie wurden erfolgreich authentifiziert.

Bitte warten Sie, während wir Ihre Kontodetails abrufen.

Wir haben eine Kontonummer gefunden, die auf 1001 endet und mit Ihrer Nummer verknüpft ist.

Geben Sie das Startdatum des Kontoauszugs an, beginnend mit dem Monat, gefolgt vom Tag und dann dem Jahr. Die Kontoabrechnung umfasst nur die letzten 90 Tage.

Kundenservicemitarbeiter erfasst das Startdatum der Abrechnung mithilfe der vorgefertigten Komponente Geburtsdatum

Sehr gut. Wir haben das Startdatum Ihres Kontoauszugs erfasst.

Geben Sie das Enddatum des Kontoauszugs an, beginnend mit dem Monat, gefolgt vom Tag und dann dem Jahr. Die Kontoabrechnung umfasst nur die letzten 90 Tage.

Kundenservicemitarbeiter erfasst das Enddatum der Abrechnung mithilfe der vordefinierten Komponente Geburtsdatum

Vielen Dank. Geht es um den Kontobericht vom 12.07.2023 bis zum 24.07.2023?
Ja

Bitte warten Sie, während wir Ihre Kontoabrechnung abrufen.

Wir haben Transaktionen vom 12.07.2023 bis zum 24.07.2023 gefunden. Möchten Sie es per E-Mail, SMS oder WhatsApp erhalten?
SMS

Möchten Sie das Dokument verschlüsseln, bevor wir es für Sie freigeben?
Nein danke

Sie erhalten den Kontoauszug innerhalb von 15 Minuten auf Ihrem registrierten Mobiltelefon.

Mehrere Konten
Der Endnutzer hat mehrere Konten. Der Kundenservicemitarbeiter bestätigt, für welches Konto der Nutzer eine Kontoabrechnung anfordert. Der Kundenservicemitarbeiter erfasst das Start- und Enddatum der Kontoabrechnung, ob der Nutzer die Kontoabrechnung verschlüsseln möchte, und sendet die Kontoabrechnung an den Nutzer.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Der Kundenservicemitarbeiter authentifiziert den Nutzer mit der vordefinierten Komponente Authentication

Vielen Dank. Sie wurden erfolgreich authentifiziert.

Bitte warten Sie, während wir Ihre Kontodetails abrufen.

Wir haben festgestellt, dass mit Ihrer Nummer zwei Konten verknüpft sind.

Können Sie uns bitte die letzten vier Ziffern des Kontos nennen, auf das Sie sich beziehen?
2002

Die letzten vier Ziffern der Kontonummer, die wir erhalten haben, lauten 2002. Ist das richtig?
Ja

Geben Sie das Startdatum des Kontoauszugs an, beginnend mit dem Monat, gefolgt vom Tag und dann dem Jahr. Die Kontoabrechnung umfasst nur die letzten 90 Tage.

Kundenservicemitarbeiter erfasst das Startdatum der Abrechnung mithilfe der vorgefertigten Komponente Geburtsdatum

Sehr gut. Wir haben das Startdatum Ihres Kontoauszugs erfasst.

Geben Sie das Enddatum des Kontoauszugs an, beginnend mit dem Monat, gefolgt vom Tag und dann dem Jahr. Die Kontoabrechnung umfasst nur die letzten 90 Tage.

Kundenservicemitarbeiter erfasst das Enddatum der Abrechnung mithilfe der vordefinierten Komponente Geburtsdatum

Vielen Dank. Geht es um die Kontoabrechnung vom 18.07.2023 bis zum 22.07.2023?
Ja

Bitte warten Sie, während wir Ihre Kontoabrechnung abrufen.

Wir haben Transaktionen vom 18.07.2023 bis zum 22.07.2023 gefunden. Möchten Sie sie per E-Mail, SMS oder WhatsApp erhalten?
WhatsApp

Möchten Sie das Dokument verschlüsseln, bevor wir es für Sie freigeben?
Ja

Die Passwortdetails werden an Ihre registrierte WhatsApp-Nummer gesendet.

Sie erhalten die Kontoabrechnung innerhalb von 15 Minuten auf Ihrer registrierten WhatsApp-Nummer.

Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Kontobericht
Komponentenspezifischer Intent
prebuilt_components_[component_name][intent_name] prebuilt_components_account_number_collection_four_digit_account_number Entitätstyp prebuilt_components[component_name][entity_type] prebuilt_components_account_statement_channelall Webhook prebuilt_components[component_name]:[webhook_action]
prebuilt_components_account_statement:request_statement

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 Ablaufebene müssen wie unten beschrieben 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.auth_level
(Optional) Gibt die Authentifizierungsebene des Aufrufers an.
integer
$session.params.auth_level_req
Gibt die Authentifizierungsebene an, die erforderlich ist, damit ein Nutzer auf seine Kontoabrechnung zugreifen kann. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert 1.
integer
$session.params.account_auth_enabled
Gibt an, ob der Nutzer wie unter Authentifizierungstypen beschrieben als Kontoinhaber authentifiziert werden soll. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert true.
boolean
$session.params.card_auth_enabled
Gibt an, ob der Nutzer wie unter Authentifizierungstypen beschrieben als Karteninhaber authentifiziert werden soll. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert false.
boolean
$session.params.phone_number
(Optional) Die registrierte Telefonnummer des Kunden, die für die Authentifizierung verwendet wird.
String
$session.params.account_count
(Optional) Anzahl der Konten, die mit dem authentifizierten Nutzer verknüpft sind.
integer
$session.params.last_four_digit_of_account_number
(Optional) Die letzten vier Ziffern der Kundenkontonummer, für die der Kontoauszug eingereicht werden muss. Wenn der Kunde nur ein Konto hat, werden diese Informationen nach der Authentifizierung automatisch abgerufen. Wenn der Kunde mehrere Konten hat, wird die jeweilige Kontonummer vom Kunden erfasst.
String
$session.params.account_statement_max_days
Gibt die maximale Anzahl von Tagen vor dem aktuellen Datum an, die für ein Startdatum der Abrechnung zulässig ist. Standardmäßig ist dieser Wert auf -90 gesetzt. Das bedeutet, dass das Startdatum der Abrechnung maximal 90 Tage vor dem aktuellen Datum liegen darf. Dieser Parameter wird in der Startseitenroute true konfiguriert.
integer
$flow.max_retry_count
Gibt an, wie oft der Endnutzer aufgefordert werden darf, ein gültiges Enddatum für die Kontoabrechnung anzugeben. Der Standardwert ist 3.
integer
$flow.max_retry_confirm_period_counter
Gibt die Anzahl der zulässigen Wiederholungen an, wenn der Abrechnungszeitraum mit dem Endnutzer bestätigt wird. Der Standardwert ist 3.
integer
$flow.max_retry_statement_counter
Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn für den angegebenen Abrechnungszeitraum keine Transaktionen abgerufen werden. Der Standardwert ist 3.
integer

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.
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
auth_level
Gibt die Authentifizierungsstufe des Anrufers an.
integer
phone_number
Die Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.
String
account_count
Die Anzahl der Konten, die mit der registrierten Telefonnummer verknüpft sind. Dazu gehören eigene Konten und Konten, für die der Nutzer eine Vollmacht hat.
integer
last_four_digit_of_account_number
Wenn ein Nutzer nur ein Konto hat, werden die letzten vier Ziffern der Kontonummer zurückgegeben. Wenn ein Nutzer mehrere Konten hat, ist der Wert dieses Parameters die letzten vier Ziffern der Kontonummer, für die der Nutzer Kontoabrechnungsinformationen erhalten möchte.
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: Bei der Unterhaltung wurde 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: Es ist ein Webhook-Fehler 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

Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unten 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 findest du unter Authentifizierungs-Webhook einrichten.
Konto bestätigen
Mit dem prebuilt_components_account_services:validate_account-Webhook wird anhand der registrierten Telefonnummer des Nutzers und der letzten vier Ziffern der angegebenen Kontonummer überprüft, ob ein Konto vorhanden ist. Der Webhook gibt auch das Kontoguthaben zurück, falls ein Konto vorhanden 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
$session.params.last_four_digit_of_account_number
Die letzten vier Ziffern der Kontonummer, für die der Nutzer Informationen zur Kontoabrechnung ausgewählt und bestätigt hat.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
account_found
Gibt an, ob für das registrierte Konto des Nutzers ein Konto mit den angegebenen letzten vier Ziffern vorhanden ist.
boolean
Kontostand
Der Betrag des aktuellen Kontostands, falls vorhanden.
Zahl

Wenn Sie den Webhook „Konto bestätigen“ für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt.
Transaktionen abrufen
Die Komponente verwendet den prebuilt_components_account_statement:get_transactions-Webhook, um die Transaktionen für ein Konto anhand der registrierten Telefonnummer des Nutzers, der letzten vier Ziffern der Kontonummer und des Abrechnungszeitraums 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
Die Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.
String
$session.params.last_four_digit_of_account_number
Die letzten vier Ziffern der Kontonummer, für die der Nutzer Informationen zur Kontoabrechnung ausgewählt und bestätigt hat.
String
$flow.statement_start_date
Das Startdatum der angeforderten Abrechnung im Format JJJJ-MM-TT.
String
$flow.statement_end_date
Optional: Das Startdatum der angeforderten Abrechnung im Format JJJJ-MM-TT. Wenn der Nutzer keinen Wert angibt oder das Ende nicht angibt, wird standardmäßig das aktuelle Datum verwendet.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
transactions_count
Die Anzahl der Transaktionen, die für das angegebene Konto im angegebenen Abrechnungszeitraum gefunden wurden.
integer

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Transaktionen abrufen“ für diese Komponente aufzurufen.
Kontoabrechnung anfordern
Über den prebuilt_components_account_statement:request_statement-Webhook sendet die Komponente eine Kontoabrechnung an einen ausgewählten Kanal, sofern die registrierte Telefonnummer des Nutzers, die letzten vier Ziffern der Kontonummer und der Abrechnungszeitraum angegeben sind.
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
$session.params.last_four_digit_of_account_number
Die letzten vier Ziffern der Kontonummer, für die der Nutzer Informationen zur Kontoabrechnung ausgewählt und bestätigt hat.
String
$flow.statement_start_date
Das Startdatum der angeforderten Abrechnung im Format JJJJ-MM-TT.
String
$flow.statement_end_date
Optional: Das Startdatum der angeforderten Abrechnung im Format JJJJ-MM-TT. Wenn der Nutzer keinen Wert angibt oder das Ende nicht angibt, wird standardmäßig das aktuelle Datum verwendet.
String
$flow.channel_medium
Der Kanal, über den der Nutzer die Nachricht erhalten möchte. Gültige Werte werden von den benutzerdefinierten Entitäten prebuilt_components_account_statement_channelphn und prebuilt_components_account_statement_channelall definiert, je nachdem, ob der Nutzer eine registrierte E-Mail-Adresse hat. Standardmäßig werden email, mobile und WhatsApp unterstützt.
String
$flow.encryption_status
Gibt an, ob das Dokument vor dem Senden an den angegebenen Kanal verschlüsselt werden soll. Wenn der Nutzer keinen Wert angibt oder das Ende nicht angeben möchte, wird standardmäßig true verwendet.
boolean

Wenn Sie den Webhook für die Erklärungsanfrage für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vordefinierte Komponente für die Authentifizierung im Einzelhandel
bookmark_border
Versionshinweise
Die vorgefertigte Komponente für die Authentifizierung im Einzelhandel erfasst Informationen vom Nutzer, um ihn auf der erforderlichen Authentifizierungsebene zu authentifizieren. Diese Komponente deckt Authentifizierungsanforderungen ab, die zwar häufig, aber nicht ausschließlich für den Einzelhandel gelten. In dieser Komponente wird die vordefinierte Komponente Telefonnummernerfassung verwendet, um Nutzerdetails zu erfassen und zu validieren.
Authentifizierungsebenen
Für verschiedene vorgefertigte Komponenten sind mehrere Authentifizierungsebenen erforderlich. Je höher die Ebene, desto mehr Nutzerinformationen sind für die Authentifizierung erforderlich. Mit der Authentifizierungskomponente für den Einzelhandel können sich Nutzer wie in der Tabelle „Authentifizierungsebene“ beschrieben auf Ebene 0 (ANI-Abgleich) oder Ebene 1 (einfach) authentifizieren.
Authentifizierungsebene
Voraussetzungen
Stufe 0: ANI-Abgleich
Der Nutzer wird authentifiziert, indem er von einer Telefonnummer aus anruft oder eine Telefonnummer angibt, die einem registrierten Konto entspricht.

Ein Nutzer kann mit der vordefinierten Komponente „Hallo“ auf Stufe 0 authentifiziert werden.
Stufe 1: Einfach
Der Nutzer wird durch Bestätigung eines Einmalpasswort-Codes authentifiziert, der an seine E-Mail-Adresse oder Telefonnummer gesendet wurde.

Unterstützte Nutzertypen
Die Authentifizierungskomponente für den Einzelhandel unterstützt Nutzer mit einer registrierten Telefonnummer und E-Mail-Adresse.
Beschränkungen
Zusätzlich zu den allgemeinen Einschränkungen für vordefinierte Komponenten gelten für diese vordefinierte Komponente die folgenden Einschränkungen:
OTPs werden nur an eine Mobilnummer oder E-Mail-Adresse gesendet, die zuvor für den Nutzer registriert wurde. Die Komponente verwendet kein OTP, um Kunden zu authentifizieren, die von einer alternativen Telefonnummer anrufen, die nicht mit ihrem Konto registriert ist. Wenn ein Nutzer von einer alternativen Telefonnummer anruft, werden Sicherheitsfragen verwendet, um den Anrufer zu authentifizieren.
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.
Authentifizierung der Stufe 0 erfolgreich: ANI-Übereinstimmung
Der Nutzer ruft von einer Telefonnummer an, die mit einem bestehenden Konto verknüpft ist, bestätigt sein Konto und wird erfolgreich für Level 0 authentifiziert.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Hallo, die von Ihnen gewählte Nummer ist mit dem Konto von Max verknüpft. Haben Sie Fragen zur Bestellung einer anderen Person? Bitte antworten Sie mit „Ja“, wenn das der Fall ist, andernfalls mit „Nein“.
Nein

Vielen Dank, John. Sie wurden erfolgreich identifiziert.

Erfolgreiche Authentifizierung der Stufe 1: OTP
Der Nutzer ruft von einer unbekannten Telefonnummer an. Die Komponente erfasst die registrierte Telefonnummer des Nutzers und fordert ihn dann auf, ein OTP zu bestätigen, das an den Kanal seiner Wahl gesendet wurde. Der Nutzer kann ein gültiges OTP angeben und wird erfolgreich für Level 1 authentifiziert.
Nutzereingabe
Antwort des Kundenservicemitarbeiters
Wir konnten diese Telefonnummer nicht mit uns verknüpfen. Bitte geben Sie uns die registrierte Telefonnummer an.

Kundenservicemitarbeiter erfasst Telefonnummer mithilfe der vorgefertigten Komponente Telefonnummernerfassung

Super, wir haben die Telefonnummer erfasst.

Aus Sicherheitsgründen müssen wir Ihre Identität bestätigen. Dazu senden wir Ihnen einen Code. Möchten Sie den Code lieber per Telefon oder per E-Mail erhalten?
Telefon

Nur zur Bestätigung: Sollen wir das OTP auf Ihr Smartphone senden? Bitte sagen Sie Ja oder Nein.
Ja

Wir haben einen Code an Ihre registrierte Telefonnummer mit der Endung 0000 gesendet. Das kann einige Sekunden dauern. Können Sie bitte den Code bestätigen?
123457

Vielen Dank, John. Sie wurden erfolgreich identifiziert.

Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Authentifizierung im Einzelhandel
Komponentenspezifischer Intent
prebuilt_components_[component_name][intent_name] prebuilt_components_retail_authentication_incorrect_phone_number Entitätstyp prebuilt_components[component_name][entity_type] prebuilt_components_channel_email_phone Webhook prebuilt_components[component_name]:[webhook_action]
prebuilt_components_retail_authentication:verify_user_details

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 Ablaufebene müssen wie unten beschrieben 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.auth_level_req
Hier wird die Authentifizierungsebene definiert, mit der der Endnutzer authentifiziert wird. Gültige Werte sind 0 und 1.
integer
$session.params.auth_level
(Optional) Gibt die aktuelle Authentifizierungsebene des Endnutzers an.
integer
$session.params.phone_number
Optional: Telefonnummer des Endnutzers. Wenn dieser Parameter nicht angegeben ist, wird die Telefonnummer vom Endnutzer erfasst.
String
$flow.max_retry_phone_number
Gibt die Anzahl der zulässigen Wiederholungen an, wenn die Telefonnummer des Nutzers erfasst wird. Der Standardwert ist 3.
integer
$flow.max_retry_otp
Gibt die Anzahl der zulässigen Wiederholungsversuche beim Erfassen des Einmalpassworts (OTP) an. Der Standardwert ist 3.
integer
$flow.max_retry_otp_not_received
Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn das Einmalpasswort (OTP) nicht empfangen wird. Der Standardwert ist 1.
integer
$flow.max_retry_otp_confirm_channel
Gibt die Anzahl der zulässigen Wiederholungen an, wenn der Kanal zum Empfang des Einmalpassworts (OTP) abgerufen wird. Der Standardwert ist 3.
integer

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.
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
auth_level
Gibt die aktuelle Authentifizierungsebene des Endnutzers an.
integer
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)
phone_number
Die Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.
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: Bei der Unterhaltung wurde 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: Es ist ein Webhook-Fehler 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

Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unten 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.
Nutzerdetails bestätigen
Über den prebuilt_components_retail_authentication:verify_user_details-Webhook ruft die Komponente die Kontodetails des Nutzers anhand der angegebenen Telefonnummer ab.
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

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
E-Mail
Die mit dem Konto registrierte E-Mail-Adresse.
String
all_recent_order_id
Liste der 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)
user_first_name
Der Vorname des Nutzers, der zur Begrüßung und Bestätigung der Kontoinhaberschaft verwendet wird.
String

Maximieren Sie die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Nutzerdetails überprüfen“ für diese Komponente aufzurufen.
OTP senden
Über den prebuilt_components_retail_authentication:send_otp-Webhook sendet die Komponente ein Einmalpasswort (OTP) an einen registrierten Kanal, der vom Endnutzer ausgewählt wurde.
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.channel
Der Kanal, über den der Nutzer das OTP erhalten möchte. Gültige Werte werden durch das benutzerdefinierte Element prebuilt_components_channel_email_phone definiert. Standardmäßig werden email und phone unterstützt.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
generated_otp
Der Wert des OTP, der generiert und über den ausgewählten Kanal an den Nutzer gesendet wird.
String

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Send OTP“ für diese Komponente aufzurufen.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
HTML-Anpassungen für Dialogflow CX Messenger
bookmark_border
Es gibt viele HTML-Anpassungen, die Sie auf einen Chatdialog anwenden können.
Optionen für HTML-Chatelemente
Das untergeordnete Element des df-messenger-Elements kann Folgendes sein:
df-messenger-chat: Der Kundenservicemitarbeiter-Dialog ist immer geöffnet.
df-messenger-chat-bubble: Der Dialogfeld-Chat mit einem Kundenservicemitarbeiter kann mit einer Schaltfläche zum Öffnen oder Schließen geöffnet oder geschlossen werden.
HTML-Anpassungen für df-messenger
Das HTML-Element df-messenger hat die folgenden Attribute:
Attribut
Eingaberichtlinie
Wert
agent-id
Erforderlich
Agent-ID, die dem Dialogflow-Agent zugeordnet ist.
allow-feedback
Optional
Legen Sie all fest, damit Endnutzer Feedback zu den Antworten des Kundenservicemitarbeiters geben können.
language-code
Erforderlich
Standardmäßiger Sprachcode.
project-id
Erforderlich
Projekt-ID für den Kundenservicemitarbeiter.
location
Optional
Die Region des Agents. Der Standardwert ist global.
intent
Optional
Ein benutzerdefiniertes Ereignis, das aufgerufen wird, wenn das Chat-Dialogfeld geöffnet wird. Sie können einen Event-Handler verwenden, der für dieses Ereignis aufgerufen wird und die erste Kundenservicemitarbeiternachricht generiert.
oauth-client-id
Optional
Erforderlich für die OAuth-Authentifizierung. Der Standardwert ist „null“. Wenn der Wert nicht angegeben ist und der nicht authentifizierte Zugriff auf Dialogflow CX Messenger aktiviert ist, können nicht authentifizierte Nutzer mit dem Kundenservicemitarbeiter interagieren. Wenn der Wert angegeben ist, wird im Dialogfeld des Kundenservicemitarbeiters die Meldung „Authentifizierung anfordern“ eingeblendet (Text kann angepasst werden, siehe Benachrichtigung request-auth-text). Der Nutzer muss sich anmelden, bevor er den Kundenservicemitarbeiter verwenden kann.
storage-option
Optional
Gibt den lokalen Speicher für Konversationsnachrichten an. Verwenden Sie none, wenn Nachrichten nicht gespeichert werden sollen. Wenn Sie none verwenden, werden alle Nachrichten gelöscht, wenn die Seite aktualisiert oder neu geladen wird. Standardmäßig ist sessionStorage festgelegt.
session-ttl
Optional
Dauer in Sekunden für die Sitzungsdauer festlegen. Die Dauer darf maximal 86.400 Sekunden (1 Tag) betragen. Standardmäßig ist 1.800 Sekunden (30 Minuten) festgelegt.
url-allowlist
Optional
Ermöglicht das Laden von Bildern aus einer durch Kommas getrennten Liste von URL-Präfixen. Bild-URLs, die in HTML- oder Markdown-Antworten verwendet werden, müssen mit einem der aufgeführten Präfixe beginnen. Verwenden Sie *, um alle URLs zuzulassen.
max-query-length
Optional
Definiert die maximale Länge einer Textabfrage. Ist der Wert negativ, ist die Länge unbegrenzt. Standardmäßig ist 256 festgelegt. Zusätzliche Dokumente

HTML-Anpassungen für df-messenger-chat

Das HTML-Element df-messenger-chat hat die folgenden Attribute:
Attribut
Eingaberichtlinie
Wert
chat-title
Optional
Der Titel des Chatfelds, der darüber angezeigt wird.
chat-subtitle
Optional
Die Untertitelung des Chatfelds, die darüber unter der chat-title angezeigt wird
chat-title-icon
Optional
Das Symbol im Titel des Chatfelds, das standardmäßig über dem Feld links von der chat-title angezeigt wird
bot-writing-text
Optional
Der Text, der angezeigt wird, während der Kundenservicemitarbeiter schreibt
bot-writing-image
Optional
Das Bild, das angezeigt wird, während der Kundenservicemitarbeiter schreibt. Hat Vorrang vor bot-writing-text.
request-auth-text
Optional
Der Text der Schaltfläche, falls eine Authentifizierung erforderlich ist.
placeholder-text
Optional
Text, der im Eingabefeld angezeigt wird, wenn es leer ist. Standardmäßig ist „Stelle eine Frage…“ festgelegt.
bot-actor-image
Optional
Bildquelle für das Schauspielerbild des Kundenservicemitarbeiters. Wird für jede Gruppe von Kundenservicemitarbeiterantworten angezeigt.
user-actor-image
Optional
Bildquelle für das Schauspielerbild des Nutzers. Wird in jeder Nutzernachricht angezeigt.

HTML-Anpassungen für df-messenger-chat-bubble

Das HTML-Element df-messenger-chat-bubble hat dieselben Attribute wie df-messenger-chat und die folgenden zusätzlichen Attribute:
Attribut
Eingaberichtlinie
Wert
expanded
Optional
Boolescher Wert, der angibt, ob der Chat zu Beginn geöffnet ist. Wenn Sie diese Option nicht festlegen, wird der letzte Status des Chats gespeichert.
chat-icon
Optional
Das Symbol für die Chatbubble. Muss ein öffentlich zugänglicher URI sein.
chat-close-icon
Optional
Das Symbol „Schließen“ für die Chatbubble. Muss ein öffentlich zugänglicher URI sein.
chat-collapse-icon
Optional
Das Symbol für die Minimierungsschaltfläche in der Titelleiste. Muss ein öffentlich zugänglicher URI sein.
anchor
Optional
Hiermit wird festgelegt, wo das Chat-Dialogfeld im Verhältnis zum geöffneten oder geschlossenen Bubbles platziert wird. Der Wert besteht aus zwei Richtungswörtern (top, bottom, left, right), die durch – getrennt sind. Der Standardwert ist top-left. Die erste Richtung definiert den Ankerpunkt und die zweite Richtung die Hauptausdehnungsrichtung weg von der Blase. Beispiel: top-left wird auf die Blase gelegt und nach links und oben (von der Blase weg) erweitert.
chat-width
Optional
Definiert die Breite des Chatfensters. Numerische Werte (in Pixeln). Standardmäßig ist 320 px festgelegt.
chat-height
Optional
Definiert die Höhe des Chatfensters. Numerische Werte (in Pixeln). Die Standardeinstellung ist 480 px.
allow-fullscreen
Optional
Gibt an, ob das Chatfenster im Vollbildmodus geöffnet werden kann. Wenn always festgelegt ist, wird die Seite für alle Bildschirmgrößen im Vollbildmodus geöffnet. Wenn „small“ festgelegt ist, wird das Fenster bei Bildschirmgrößen unter 500 Pixeln im Vollbildmodus geöffnet, andernfalls in einem normalen Fenster. Kann chat-width, chat-height und anchor überschreiben, wenn festgelegt.
minimized
Optional
Bestimmt, ob der Chat anfangs minimiert geöffnet wird. Verwendet dieselbe Logik wie anchor. Führt bei der Ladung die anfängliche intent aus, sofern angegeben.

Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vordefinierte Komponente für alphanumerische Sammlungen
bookmark_border
Versionshinweise
Mit der vordefinierten Komponente für die alphanumerische Erfassung werden alphanumerische Sequenzen vom Endnutzer erfasst. Die zulässige Mindest- und Höchstlänge kann über Eingabeparameter konfiguriert werden.
Die Komponente erfasst bei jeder Unterhaltungsrunde Zeichenfolgen vom Nutzer und fügt sie zusammen, um die endgültige Sequenz zu bilden. Die minimale und maximale Länge pro Block kann über Eingabeparameter konfiguriert werden.
Die Sequenzerfassung wird fortgesetzt, bis der Endnutzer mit der Sequenz fertig ist und eine Eingabe macht, die der Intent „prebuilt_components_confirmation_done“ entspricht.
Phonetisches Alphabet
Diese Komponente unterstützt die Verwendung phonetischer Alphabete wie dem NATO-Alphabet.
Nutzereingabe
Aufgezeichnete Sequenz
Alpha Bravo Charlie 123
abc123
A B Kat. 1 2 3
ABC123
A wie Apfel, B wie Banane, C wie Chili, eins fünfzehn
ABC115

Zusätzliche Funktionen
Diese vorgefertigte Komponente bietet die folgenden zusätzlichen Funktionen:
Wiederholen
Wartezimmer
Wiedergabe
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.
Einzelner Block
Der Endnutzer gibt eine alphanumerische Sequenz in einem Block an und sagt „Fertig“. Der Kundenservicemitarbeiter akzeptiert sie.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Bitte sagen Sie zuerst die ersten 1 bis 8 Zeichen der alphanumerischen Sequenz. Wenn Sie fertig sind, sagen Sie „Ich bin fertig“, um die Aufnahme zu beenden. Sie können auch jederzeit „Wiedergabe“ sagen, um sich die aktuelle aufgezeichnete Sequenz anzusehen.
fvfd3433

Für Ich habe fvfd3433 erhalten. Ist das richtig?
Ja

Okay. Nennen Sie mir die nächsten 1 bis 8 Zeichen in der Sequenz.
Ich brauche keine weitere Hilfe

Vielen Dank für die Bestätigung. Die letzte alphanumerische Sequenz, die ich erhalten habe, lautet fvfd3433. Ist das richtig?
Ja

Super, ich habe die alphanumerische Sequenz erfasst.

Mehrere Teile
Der Endnutzer gibt die alphanumerische Sequenz in zwei Teilen an. Der Kundenservicemitarbeiter akzeptiert sie.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Bitte sagen Sie zuerst die ersten 1 bis 8 Zeichen der alphanumerischen Sequenz. Wenn Sie fertig sind, sagen Sie „Ich bin fertig“, um die Aufnahme zu beenden. Sie können auch jederzeit „Wiedergabe“ sagen, um sich die aktuelle aufgezeichnete Sequenz anzusehen.
fvfd3433

Für Ich habe fvfd3433 erhalten. Ist das richtig?
Ja

Okay. Nennen Sie mir die nächsten 1 bis 8 Zeichen in der Sequenz.
gh67

Für Ich habe gh67 erhalten. Ist das richtig?
Ja

Okay. Nennen Sie mir die nächsten 1 bis 8 Zeichen in der Sequenz.
Ich brauche keine weitere Hilfe

Vielen Dank für die Bestätigung. Die letzte alphanumerische Zeichenfolge lautet fvfd3433gh67. Ist das richtig?
Ja

Super, ich habe die alphanumerische Sequenz erfasst.

Wiederholen erfolgreich
Der Endnutzer gibt eine alphanumerische Sequenz an. Der Kundenservicemitarbeiter bittet den Endnutzer noch einmal, sie zu bestätigen. Der Endnutzer lehnt die Bestätigung ab und gibt noch einmal eine alphanumerische Zeichenfolge ein. Der Kundenservicemitarbeiter akzeptiert sie.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Bitte sagen Sie zuerst die ersten 1 bis 8 Zeichen der alphanumerischen Sequenz. Wenn Sie fertig sind, sagen Sie „Ich bin fertig“, um die Aufnahme zu beenden. Sie können auch jederzeit „Wiedergabe“ sagen, um sich die aktuelle aufgezeichnete Sequenz anzusehen.
fvfd3433

Für Ich habe fd3433 erhalten, ist das richtig?
no

Entschuldigen Sie, könnten Sie mir bitte die ersten 1 bis 8 Zeichen noch einmal nennen?
fvfd3433

Für Ich habe fvfd3433 erhalten. Ist das richtig?
Ja

Okay. Nennen Sie mir die nächsten 1 bis 8 Zeichen in der Sequenz.
Ich brauche keine weitere Hilfe

Vielen Dank für die Bestätigung. Die letzte alphanumerische Sequenz, die ich erhalten habe, lautet fvfd3433. Ist das richtig?
Ja

Super, ich habe die alphanumerische Sequenz erfasst.

Fehlgeschlagene Wiederholungsversuche
Der Endnutzer kann innerhalb von drei Versuchen keine alphanumerische Sequenz mit 1 bis 8 Zeichen angeben und die Komponente beendet den Ablauf.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Bitte sagen Sie zuerst die ersten 1 bis 8 Zeichen der alphanumerischen Sequenz. Wenn Sie fertig sind, sagen Sie „Ich bin fertig“, um die Sammlung abzuschließen. Sie können auch jederzeit „Wiedergabe“ sagen, um sich die aktuelle aufgezeichnete Sequenz anzusehen.
123N

Für Ich habe 123 Mio., ist das richtig?
no

Entschuldigen Sie, könnten Sie mir bitte die ersten 1 bis 8 Zeichen noch einmal nennen?
123N

Für Ich habe 123 Mio., ist das richtig?
no

Entschuldigen Sie die Unannehmlichkeiten. Können Sie mir bitte die ersten 1 bis 8 Zeichen noch einmal nennen?

Bitte geben Sie jeden Buchstaben Ihrer Sequenz mit einem Wort an, das mit dem jeweiligen Buchstaben beginnt. Wenn Ihre Sequenz beispielsweise AB123 lautet, sagen Sie „Apfel Baby 123“.
123 Nest

Für Ich habe 123 N erhalten, ist das richtig?
no

Es tut mir leid, ich habe zu viele Versuche unternommen und konnte die alphanumerische Sequenz nicht abrufen.

Phonetisches Alphabet
Der Endnutzer gibt eine alphanumerische Sequenz an. Der Kundenservicemitarbeiter bittet den Endnutzer noch einmal, sie zu bestätigen. Der Endnutzer lehnt die Bestätigung zweimal nacheinander ab. Die phonetische Umwandlung wird aktiviert und der Endnutzer gibt noch einmal eine alphanumerische Sequenz an. Der Kundenservicemitarbeiter akzeptiert sie.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Bitte sagen Sie zuerst die ersten 1 bis 8 Zeichen der alphanumerischen Sequenz. Wenn Sie fertig sind, sagen Sie „Ich bin fertig“, um die Sammlung abzuschließen. Sie können auch jederzeit „Wiedergabe“ sagen, um sich die aktuelle aufgezeichnete Sequenz anzusehen.
123N

Für Ich habe 123 Mio., ist das richtig?
no

Entschuldigen Sie, könnten Sie mir bitte die ersten 1 bis 8 Zeichen noch einmal nennen?
123N

Für Ich habe 123 Mio., ist das richtig?
no

Entschuldigen Sie die Unannehmlichkeiten. Nennen Sie mir bitte noch einmal die ersten 1 bis 8 Zeichen.

Bitte geben Sie jeden Buchstaben Ihrer Sequenz mit einem Wort an, das mit dem jeweiligen Buchstaben beginnt. Wenn Ihre Sequenz beispielsweise AB123 lautet, sagen Sie „Apfel Baby 123“.
123 N wie Nancy

Für Ich habe 123 N erhalten, ist das richtig?
Ja

Okay. Nennen Sie mir die nächsten 1 bis 8 Zeichen in der Sequenz.
567 v. Chr.

Für Ich habe 567 v. Chr. erhalten, ist das richtig?
das war’s

Vielen Dank für die Bestätigung. Die finale alphanumerische Sequenz lautet 123N56BC. Ist das richtig?
Ja

Super, ich habe die alphanumerische Sequenz erfasst.

Ungültige Sequenzlänge
Der Endnutzer gibt eine alphanumerische Sequenz mit einer Länge an, die außerhalb der vordefinierten Mindest- und Höchstlänge der alphanumerischen Sequenz liegt. Der Kundenservicemitarbeiter bittet den Endnutzer, noch einmal von vorn anzufangen. Der Endnutzer lehnt ab und die Komponente beendet den Ablauf.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Bitte sagen Sie zuerst die ersten 1 bis 8 Zeichen der alphanumerischen Sequenz. Wenn Sie fertig sind, sagen Sie „Ich bin fertig“, um die Sammlung abzuschließen. Sie können auch jederzeit „Wiedergabe“ sagen, um sich die aktuelle aufgezeichnete Sequenz anzusehen.
123 Mio.

Für Ich habe 123 Mio., ist das richtig?
Fertig

Die von Ihnen angegebene alphanumerische Sequenz ist zu lang. Sie muss zwischen 5 und 30 Zeichen lang sein. Möchten Sie noch einmal beginnen?
no

Es tut mir leid, aber ich habe zu viele Versuche unternommen und konnte die alphanumerische Sequenz nicht erfassen.

Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Alphanumerische Sammlung
Komponentenspezifischer Intent
prebuilt_components_[component_name]_[intent_name]
prebuilt_components_alphanumeric_collection_support_continue
Parameter
[param_name]
alphanumeric_max_length

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 Ablaufebene müssen wie unten beschrieben auf der Startseite der Komponente festgelegt werden. Parameter auf Sitzungsebene können entweder über einen Aufrufablauf oder auf der Startseite dieser Komponente festgelegt werden.
Sie können die Mindest- und Höchstlängen pro Aufnahme und für die endgültige erfasste Sequenz konfigurieren, indem Sie die Parametervorgaben auf der Startseite des Workflows ändern.
Diese vordefinierte Komponente akzeptiert die folgenden Eingabeparameter:
Parametername
Beschreibung
Eingabeformat
$flow.alphanumeric_min_length
Mindestlänge der letzten alphanumerischen Sequenz. Der Standardwert ist 1.
integer
$flow.alphanumeric_max_length
Maximale Länge der abschließenden alphanumerischen Sequenz. Der Standardwert ist 30.
integer
$flow.lower_limit
Mindestlänge des Chunks, den ein Nutzer pro Zug angeben kann. Der Standardwert ist 1.
integer
$flow.upper_limit
Die maximale Länge des Chunks, den ein Nutzer pro Zug angeben kann. Der Standardwert ist 8.
integer

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.
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
alphanumeric_collection_alphanumeric_sequence
Dieser Parameter gibt die von der Komponente erfasste alphanumerische Sequenz zurück.
String

Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
Abgeschlossen
Ihr Agent sollte jetzt eingerichtet und bereit zum Testen sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
CSS-Anpassungen für Dialogflow CX Messenger
bookmark_border
Sie können den Stil Ihres Chatdialogs anpassen. Legen Sie dazu CSS-Variablen fest.
Achtung :Die CSS-Anpassung wird in Internet Explorer 11 nicht dargestellt, da CSS-Variablen nicht unterstützt werden. Stattdessen werden Standardstile gerendert.
Allgemeines Design
Die folgenden CSS-Variablen bieten allgemeine Stiloptionen:
Eigenschaften
Eingaberichtlinie
Standardwert
Beschreibung
df-messenger-font-family
Optional
„Google Sans“, „Helvetica Neue“, serifenlos
Schriftfamilie, die im gesamten Widget verwendet werden soll
df-messenger-font-size
Optional
14 Pixel
Textgröße für das gesamte Widget
df-messenger-font-color
Optional

1f1f1f

Textfarbe für das gesamte Widget
df-messenger-primary-color
Optional

0b57d0

Primäre Farbe für Elemente im gesamten Widget (z. B. Hintergrund der Titelleiste, Hintergrund der Aktionsschaltfläche usw.)
df-messenger-focus-color
Optional

1e88e5

Farbe des Fokusrings um Elemente herum
df-messenger-focus-color-contrast
Optional
Weiß
Farbe des Fokusrings um Elemente herum, wenn sie sich in einem übergeordneten Element mit einer Hintergrundfarbe befinden (z. B. in der Titelleiste)
df-messenger-chat-border
Optional
keine
Rahmen für das Dialogfeld
df-messenger-chat-border-radius
Optional
0
Rahmenradius für das Dialogfeld

Stil für df-messenger-chat-bubble
Wenn du das df-messenger-chat-bubble-Element verwendest, kannst du die folgenden CSS-Variablen angeben:
Eigenschaften
Eingaberichtlinie
Standardwert
Beschreibung
df-messenger-chat-window-height
Optional
480 Pixel
Höhe des Chatfensters
df-messenger-chat-window-width
Optional
320 Pixel
Breite des Chatfensters
df-messenger-chat-window-offset
Optional
16 Pixel
Abstand zwischen der Chatbubble und dem Chatfenster
df-messenger-chat-window-box-shadow
Optional
keine
Schatten des Chatfensters
df-messenger-chat-collapse-icon-size
Optional
Nicht festgelegt
Größe des Symbols für die Minimierungsschaltfläche in der Titelleiste
df-messenger-chat-bubble-icon-size
Optional
36 Pixel
Größe des Symbols für die Chatbubble
df-messenger-chat-bubble-close-icon-size
Optional
24 Pixel
Größe des Symbol „Schließen“ für die Chatbubble
df-messenger-chat-bubble-close-icon-transform-rotate
Optional
-90 Grad
Drehung des Symbol „Schließen“ für die Chatbubble, dreht sich beim Schließen des Chats auf 0 Grad
df-messenger-chat-bubble-icon-color
Optional
Weiß
Farbe des Symbols und des Symbol „Schließen“ für die Chatbubble
df-messenger-chat-bubble-size
Optional
64 Pixel
Größe des Chatfelds
df-messenger-chat-bubble-background
Optional

0b57d0

Hintergrund der Chatbubble
df-messenger-chat-bubble-border-radius
Optional
32 Pixel
Rahmenradius der Chatbubble
df-messenger-chat-bubble-border
Optional
keine
Rahmen der Chatbubble
df-messenger-chat-border-minimized
Optional
keine
Rahmen des minimierten Chats
df-messenger-chat-border-radius-minimized
Optional
0
Rahmenradius des minimierten Chats

Stil für Titelleiste
Für die Titelleiste können die folgenden CSS-Variablen angegeben werden:
Eigenschaften
Eingaberichtlinie
Standardwert
Beschreibung
df-messenger-titlebar-background
Optional

0b57d0

Hintergrund der Titelleiste
df-messenger-titlebar-padding
Optional
0 15 px
Ränder der Titelleiste
df-messenger-titlebar-border
Optional
keine
Rahmen für die Titelleiste
df-messenger-titlebar-border-bottom
Optional
keine
Unterer Rahmen der Titelleiste
df-messenger-titlebar-title-align
Optional
start
Textausrichtung des Titeltexts in der Titelleiste. Zulässige Werte sind start, center oder end.
df-messenger-titlebar-font-color
Optional
Weiß
Textfarbe des Textes in der Titelleiste
df-messenger-titlebar-letter-spacing
Optional
normal
Zeichenabstand des Texts in der Titelleiste
df-messenger-titlebar-title-font-size
Optional
18 Pixel
Textgröße des Titeltexts in der Titelleiste
df-messenger-titlebar-title-font-family
Optional
„Google Sans“, „Helvetica Neue“, serifenlos
Schriftfamilie des Titeltexts in der Titelleiste
df-messenger-titlebar-title-font-weight
Optional
400
Schriftstärke des Titeltexts in der Titelleiste
df-messenger-titlebar-title-line-height
Optional
normal
Zeilenhöhe des Titeltexts in der Titelleiste
df-messenger-titlebar-title-letter-spacing
Optional
normal
Zeichenabstand des Titeltexts in der Titelleiste
df-messenger-titlebar-subtitle-font-color
Optional
Weiß
Textfarbe des Untertitels in der Titelleiste
df-messenger-titlebar-subtitle-font-size
Optional
18 Pixel
Textgröße des Untertiteltexts in der Titelleiste
df-messenger-titlebar-subtitle-font-family
Optional
„Google Sans“, „Helvetica Neue“, serifenlos
Schriftfamilie des Untertiteltexts in der Titelleiste
df-messenger-titlebar-subtitle-font-weight
Optional
400
Schriftstärke des Untertitels in der Titelleiste
df-messenger-titlebar-subtitle-line-height
Optional
normal
Zeilenhöhe des Untertiteltexts in der Titelleiste
df-messenger-titlebar-subtitle-letter-spacing
Optional
normal
Zeichenabstand des Untertiteltexts in der Titelleiste
df-messenger-titlebar-title-order
Optional
Zeile
Reihenfolge der Elemente in der Titelleiste festlegen. Zulässige Werte sind row oder row-reverse. Dieser Wert ist nur wirksam, wenn das Attribut chat-title-icon angegeben wurde.
df-messenger-titlebar-icon-width
Optional
18 Pixel
Die Breite des Symbols in der Titelleiste. Dieser Wert wird nur angewendet, wenn chat-title-icon angegeben wurde.
df-messenger-titlebar-icon-height
Optional
18 Pixel
Die Höhe des Symbols in der Titelleiste. Dieser Wert wird nur angewendet, wenn chat-title-icon angegeben wurde.
df-messenger-titlebar-icon-padding
Optional
0 12px 0 0
Der Abstand um das Symbol in der Titelleiste. Dieser Wert wird nur angewendet, wenn chat-title-icon angegeben wurde.

Stil für das Chatfenster
Für das Chatfenster können die folgenden CSS-Variablen bereitgestellt werden:
Eigenschaften
Eingaberichtlinie
Standardwert
Beschreibung
df-messenger-chat-background
Optional

fafafa

Hintergrund des Kundenservicemitarbeiter-Dialogfelds, in dem Nachrichten angezeigt werden
df-messenger-chat-padding
Optional
10 Pixel
Ränder des Kundenservicemitarbeiter-Dialogfelds, in dem Nachrichten angezeigt werden
df-messenger-messagelist-border
Optional
keine
Rahmen der Nachrichtenliste
df-messenger-message-border
Optional
keine
Rahmen der Dialognachrichten des Kundenservicemitarbeiters
df-messenger-message-font-size
Optional
14 Pixel
Textgröße der Dialognachrichten des Kundenservicemitarbeiters
df-messenger-message-font-family
Optional
„Google Sans“, „Helvetica Neue“, serifenlos
Schriftfamilie der Dialognachrichten des Kundenservicemitarbeiters
df-messenger-message-font-weight
Optional
normal
Schriftstärke der Dialognachrichten des Kundenservicemitarbeiters
df-messenger-message-bot-background
Optional

ecf3fe

Hintergrund der vom Kundenservicemitarbeiter gesendeten Nachrichten
df-messenger-message-bot-border
Optional
keine
Rahmen der vom Kundenservicemitarbeiter gesendeten Nachrichten
df-messenger-message-bot-font-color
Optional

1f1f1f

Textfarbe der vom Kundenservicemitarbeiter gesendeten Nachrichten
df-messenger-message-bot-font-weight
Optional
normal
Schriftschnitt der vom Kundenservicemitarbeiter gesendeten Nachrichten
df-messenger-message-user-background
Optional

e1e3e1

Hintergrund der vom Nutzer gesendeten Nachrichten
df-messenger-message-user-border
Optional
keine
Rahmen der vom Nutzer gesendeten Nachrichten
df-messenger-message-user-font-color
Optional

1f1f1f

Schriftfarbe der vom Nutzer gesendeten Nachrichten
df-messenger-message-user-font-weight
Optional
normal
Schriftschnitt der vom Nutzer gesendeten Nachrichten
df-messenger-message-spacing
Optional
10 Pixel
Abstand zwischen zwei Nachrichten
df-messenger-message-border-radius
Optional
8 Pixel
Umrissradius für Nachrichten, gilt für alle Ecken
df-messenger-message-bot-border-top-left-radius
Optional
8 Pixel
Rahmenradius oben links für Nachrichten von Kundenservicemitarbeitern, überschreibt den generischen Radius
df-messenger-message-bot-border-top-right-radius
Optional
8 Pixel
Randradius oben rechts für Nachrichten von Kundenservicemitarbeitern, überschreibt den generischen Radius
df-messenger-message-bot-border-bottom-left-radius
Optional
8 Pixel
Rahmenradius links unten für Nachrichten von Kundenservicemitarbeitern, überschreibt den generischen Radius
df-messenger-message-bot-border-bottom-right-radius
Optional
8 Pixel
Rahmenradius rechts unten für Agentennachrichten, überschreibt den generischen Radius
df-messenger-message-user-border-top-left-radius
Optional
8 Pixel
Rahmenradius oben links für Nutzernachrichten, überschreibt den generischen Radius
df-messenger-message-user-border-top-right-radius
Optional
8 Pixel
Rahmenradius oben rechts für Nutzernachrichten, überschreibt generischen Radius
df-messenger-message-user-border-bottom-left-radius
Optional
8 Pixel
Rahmenradius links unten für Nutzernachrichten, überschreibt den generischen Radius
df-messenger-message-user-border-bottom-right-radius
Optional
8 Pixel
Ränderdurchmesser unten rechts für Nutzernachrichten, überschreibt den generischen Durchmesser
df-messenger-message-stack-spacing
Optional
10 Pixel
Abstand zwischen zwei aufeinanderfolgenden Nachrichten
df-messenger-message-bot-stack-border-top-left-radius
Optional
8 Pixel
Rahmenradius oben links für aufeinanderfolgende Nachrichten von Kundenservicemitarbeitern, überschreibt den linken oberen Radius des Kundenservicemitarbeiters
df-messenger-message-bot-stack-border-top-right-radius
Optional
8 Pixel
Rahmenradius rechts oben für aufeinanderfolgende Nachrichten des Kundenservicemitarbeiters, überschreibt den rechten oberen Radius des Kundenservicemitarbeiters
df-messenger-message-bot-stack-border-bottom-left-radius
Optional
8 Pixel
Rahmenradius links unten für aufeinanderfolgende Agentennachrichten, überschreibt den linken unteren Radius des Agents
df-messenger-message-bot-stack-border-bottom-right-radius
Optional
8 Pixel
Ränderradius rechts unten für aufeinanderfolgende Nachrichten von Kundenservicemitarbeitern, überschreibt den Ränderradius rechts unten des Kundenservicemitarbeiters
df-messenger-message-user-stack-border-top-left-radius
Optional
8 Pixel
Grenzradius oben links für aufeinanderfolgende Nutzernachrichten, überschreibt den Nutzerradius oben links
df-messenger-message-user-stack-border-top-right-radius
Optional
8 Pixel
Ränder oben rechts für aufeinanderfolgende Nutzernachrichten, überschreibt den Ränder oben rechts des Nutzers
df-messenger-message-user-stack-border-bottom-left-radius
Optional
8 Pixel
Ränder an der unteren linken Seite für aufeinanderfolgende Nutzernachrichten, überschreibt den Ränder an der unteren linken Seite des Nutzers
df-messenger-message-user-stack-border-bottom-right-radius
Optional
8 Pixel
Ränder unten rechts für aufeinanderfolgende Nutzernachrichten, überschreibt den Ränder unten rechts des Nutzers
df-messenger-message-user-writing-image-width
Optional
24 Pixel
Breite des Bildes, das angezeigt wird, während der Kundenservicemitarbeiter schreibt. Nur aktiv, wenn bot-writing-image festgelegt ist.
df-messenger-message-bot-writing-image-height
Optional
24 Pixel
Höhe des Bildes, das angezeigt wird, während der Kundenservicemitarbeiter schreibt. Nur aktiv, wenn bot-writing-image festgelegt ist.
df-messenger-message-bot-writing-font-color
Optional

1f1f1f

Textfarbe des Textes, der angezeigt wird, während der Kundenservicemitarbeiter schreibt
df-messenger-message-bot-writing-font-weight
Optional
normal
Schriftstärke des Texts, der angezeigt wird, während der Kundenservicemitarbeiter schreibt
df-messenger-message-bot-writing-font-size
Optional
14 Pixel
Textgröße des Texts, der angezeigt wird, während der Kundenservicemitarbeiter schreibt
df-messenger-message-bot-writing-border
Optional
keine
Rahmen der Nachricht, der angezeigt wird, während der Kundenservicemitarbeiter schreibt
df-messenger-message-bot-writing-background
Optional

ecf3fe

Hintergrund der Nachricht, die angezeigt wird, während der Kundenservicemitarbeiter schreibt
df-messenger-message-bot-writing-padding
Optional
12 Pixel
Weißraum um die Nachricht, die angezeigt wird, während der Kundenservicemitarbeiter schreibt
df-messenger-message-bot-writing-spacing
Optional
10 Pixel
Abstand zwischen der Nachricht, die angezeigt wird, während der Kundenservicemitarbeiter schreibt, und der vorherigen Nachricht
df-messenger-chat-scroll-button-enabled-display
Optional
keine
Hiermit wird festgelegt, ob die Schaltfläche „Nach unten springen“ angezeigt wird. Legen Sie flex fest, um die Schaltfläche zu aktivieren.
df-messenger-chat-scroll-button-align
Optional
center
Ausrichtung der Schaltfläche „Nach unten springen“. Zulässige Werte sind flex-start, center und flex-end.
df-messenger-chat-scroll-button-container-padding
Optional
8 Pixel
Abstand des Containers um die Schaltfläche „Nach unten springen“
df-messenger-chat-scroll-button-text-display
Optional
Inline
Anzeige des Texts neben dem Symbol auf der Schaltfläche „Nach unten springen“. Mit none lässt sich der Text ausblenden.
df-messenger-chat-scroll-button-font-size
Optional
14 Pixel
Textgröße der Schaltfläche „Nach unten springen“
df-messenger-chat-scroll-button-font-color
Optional
Weiß
Schriftfarbe der Schaltfläche „Nach unten springen“
df-messenger-chat-scroll-button-background
Optional

0b57d0

Hintergrund der Schaltfläche „Nach unten springen“
df-messenger-chat-scroll-button-border-radius
Optional
999 px
Rahmenradius der Schaltfläche „Nach unten springen“
df-messenger-chat-messagelist-scroll-shadow-background
Optional
radial-gradient(farthest-side at 50% 100%, rgba(0,0,0,.2), transparent) bottom
Schatten, der unten in der Nachrichtenliste angezeigt wird, wenn die Liste nicht bis zum Ende gescrollt wird. Legen Sie none fest, um ihn zu deaktivieren.

Styling für Bilder von Schauspielern
Bilder der Akteure sind die Bilder, die neben Nachrichten des Bots oder des Aktors angezeigt werden. Für diese Schauspielerbilder können die folgenden CSS-Variablen angegeben werden:
Hinweis: Für die Flags müssen die Attribute bot-actor-image oder user-actor-image jeweils aktiv sein.
Eigenschaften
Eingaberichtlinie
Standardwert
Beschreibung
df-messenger-message-actor-spacing
Optional
16 Pixel
Abstand zwischen dem Bild des Darstellers und den Botschaften
df-messenger-message-bot-actor-order
Optional
Zeile
Reihenfolge von Bild des Schauspielers und Nachrichten. Mit row wird das Bild des Schauspielers links und die Nachrichten rechts angezeigt. Mit row-reverse wird das Bild des Schauspielers rechts und die Nachrichten links angezeigt.
df-messenger-message-user-actor-order
Optional
row-reverse
Reihenfolge von Bild des Schauspielers und Nachrichten. Mit row-reverse wird das Bild des Schauspielers rechts und die Nachrichten links angezeigt. Mit row wird das Bild des Schauspielers links und die Nachrichten rechts angezeigt.
df-messenger-message-actor-direction
Optional
Spalte
Sollte das Gegenteil von df-messenger-message-bot-actor-order und df-messenger-message-user-actor-order sein. Verwenden Sie column, wenn diese auf row basieren, oder row, wenn sie auf column basieren.
df-messenger-message-actor-align
Optional
flex-start
Ausrichtung des Aktors in Bezug auf die Nachrichten. Mit flex-start wird das Bild des Schauspielers oben, mit center zentriert und mit flex-end unten angezeigt.
df-messenger-message-actor-border-radius
Optional
999 px
Rahmenradius des Schauspielerbilds
df-messenger-message-actor-padding
Optional
8 Pixel
Ränder des Schauspielerbilds
df-messenger-message-actor-image-size
Optional
24 Pixel
Größe des Bilds des Schauspielers
df-messenger-message-bot-actor-background
Optional
Weiß
Hintergrund des Schauspielerbilds des Kundenservicemitarbeiters
df-messenger-message-bot-actor-border
Optional
keine
Rahmen des Schauspielerbilds des Kundenservicemitarbeiters
df-messenger-message-bot-actor-offset
Optional
0
Versatz, um das Schauspielerbild des Kundenservicemitarbeiters zu verschieben
df-messenger-message-user-actor-background
Optional
Weiß
Hintergrund des Schauspielerbilds des Nutzers
df-messenger-message-user-actor-border
Optional
keine
Rahmen des Nutzerbilds
df-messenger-message-user-actor-offset
Optional
0
Offset, um das Schauspielerbild des Nutzers zu verschieben

Stil für Nutzereingaben
Für die Nutzereingabe können die folgenden CSS-Variablen bereitgestellt werden:
Eigenschaften
Eingaberichtlinie
Standardwert
Beschreibung
df-messenger-send-icon-color
Optional

0b57d0

Farbe des Symbols „Senden“ in der Nutzereingabe
df-messenger-send-icon-color-hover
Optional

0b57d0

Farbe des Symbols „Senden“ in der Nutzereingabe, wenn der Mauszeiger darauf bewegt wird
df-messenger-send-icon-color-active
Optional

0b57d0

Farbe des Symbols „Senden“ in der Nutzereingabe, wenn Text gesendet werden kann
df-messenger-send-icon-offset-x
Optional
0
Vertikale Verschiebung des Sendesymbols in der Nutzereingabe
df-messenger-send-icon-offset-y
Optional
-4 px
Horizontaler Versatz des Sendesymbols in der Nutzereingabe
df-messenger-input-background
Optional
Weiß
Hintergrund der Nutzereingabe
df-messenger-input-padding
Optional
8 Pixel
Der Abstand zwischen dem Eingabefeld des Nutzers (einschließlich Schaltfläche zum Senden von Nachrichten) und dem Container.
df-messenger-input-inner-padding
Optional
0px 48px 0px 0
Innenabstand zwischen dem Eingabefeld des Nutzers (ohne Schaltfläche „Nachricht senden“) und dem Container.
df-messenger-input-border
Optional
keine
Rahmen der Nutzereingabe
df-messenger-input-border-top
Optional
1px solid #e0e0e0
Oberer Rahmen der Nutzereingabe
df-messenger-input-border-bottom
Optional
keine
Unterer Rahmen des Textfelds für die Nutzereingabe
df-messenger-input-font-family
Optional
„Google Sans“, „Helvetica Neue“, serifenlos
Schriftfamilie der Nutzereingabe
df-messenger-input-font-color
Optional

1f1f1f

Textfarbe der Nutzereingabe
df-messenger-input-font-size
Optional
14 Pixel
Textgröße der Nutzereingabe
df-messenger-input-font-weight
Optional
normal
Schriftstärke der Nutzereingabe
df-messenger-input-box-border
Optional
keine
Rahmen des Eingabefelds für Nutzer
df-messenger-input-box-focus-border
Optional
keine
Rahmen des Eingabefelds, wenn es den Fokus hat
df-messenger-input-box-border-radius
Optional
0
Rahmenradius des Eingabefelds für Nutzer
df-messenger-input-box-padding
Optional
12px 0
Ränder des Eingabefelds
df-messenger-input-box-focus-padding
Optional
12px 0
Ränder des Eingabefelds, wenn es den Fokus hat
df-messenger-input-gutter
Optional
stabil
Abstand der Bildlaufleiste der Nutzereingabe
df-messenger-input-info-font-size
Optional
14 Pixel
Textgröße von Informationsnachrichten in der Nutzereingabe
df-messenger-input-info-font-weight
Optional
normal
Schriftschnitt von Informationsnachrichten in der Nutzereingabe
df-messenger-input-info-padding
Optional
14 px 16 px
Einfügen von Leerzeichen in Informationsnachrichten in der Nutzereingabe
df-messenger-input-info-line-height
Optional
20 Pixel
Zeilenhöhe von Informationsnachrichten in der Nutzereingabe
df-messenger-input-long-text-warning-display
Optional
keine
Wenn diese Option auf block festgelegt ist, wird eine Warnmeldung angezeigt, sobald die Eingabe 256 Zeichen überschreitet. Nur aktiv, wenn das max-query-length-Attribut höher ist (z.B. deaktiviert). Zusätzliche Dokumente
df-messenger-input-warning-background
Optional

fef7e0

Hintergrund der Warnmeldung in der Nutzereingabe
df-messenger-input-warning-color
Optional

410e0b

Schriftfarbe der Warnmeldung in der Nutzereingabe
df-messenger-input-warning-icon-color
Optional

e37400

Farbe des Symbols in der Warnmeldung in der Nutzereingabe
df-messenger-input-error-background
Optional

f9dedc

Hintergrund der Fehlermeldung in der Nutzereingabe
df-messenger-input-error-color
Optional

410e0b

Schriftfarbe der Fehlermeldung in der Nutzereingabe
df-messenger-input-error-icon-color
Optional

b3261e

Farbe des Symbols in der Warnmeldung in der Nutzereingabe

Styling für Authentifizierungs-Overlay
Bei einer authentifizierten Einrichtung können die folgenden CSS-Variablen für das Overlay angegeben werden:
Eigenschaften
Eingaberichtlinie
Standardwert
Beschreibung
df-messenger-auth-background
Optional
rgba(204, 204, 204, .8)
Hintergrund des Dialogfelds für Kundenservicemitarbeiter, wenn die Authentifizierung angezeigt wird
df-messenger-auth-button-background
Optional

0b57d0

Hintergrund der Authentifizierungsschaltfläche
df-messenger-auth-button-font-family
Optional
„Google Sans“, „Helvetica Neue“, serifenlos
Schriftfamilie der Schaltfläche für die Authentifizierung
df-messenger-auth-button-font-color
Optional
Weiß
Schriftfarbe der Authentifizierungsschaltfläche
df-messenger-auth-button-font-size
Optional
14 Pixel
Textgröße der Authentifizierungsschaltfläche
df-messenger-auth-button-border
Optional
keine
Rahmen der Authentifizierungsschaltfläche
df-messenger-auth-button-border-radius
Optional
8 Pixel
Randradius der Authentifizierungsschaltfläche

Feedback-Styling
Wenn die Funktion Feedback zur Antwort aktiviert ist, können die folgenden CSS-Variablen für die Feedbacksteuerelemente angegeben werden.
Eigenschaften
Eingaberichtlinie
Standardwert
Beschreibung
df-messenger-message-feedback-icon-distance
Optional
8 Pixel
Abstand zwischen den Schaltflächen „Mag ich“ und „Mag ich nicht“
df-messenger-message-feedback-icon-font-color
Optional

444746

Farbe der Schaltflächen „Mag ich“ und „Mag ich nicht“
df-messenger-message-feedback-icon-font-color-active
Optional

444746

Farbe der Schaltflächen „Mag ich“ und „Mag ich nicht“, wenn sie aktiv sind
df-messenger-message-feedback-icon-border
Optional
keine
Rahmen der Schaltflächen „Mag ich“ und „Mag ich nicht“
df-messenger-message-feedback-icon-border-radius
Optional
0
Rahmenradius der Schaltflächen „Mag ich“ und „Mag ich nicht“
df-messenger-message-feedback-icon-background
Optional
keine
Hintergrund der Schaltflächen „Mag ich“ und „Mag ich nicht“
df-messenger-message-feedback-icon-background-hover
Optional
keine
Hintergrund der Schaltflächen „Mag ich“ und „Mag ich nicht“, wenn der Mauszeiger darauf bewegt wird
df-messenger-message-feedback-icon-padding
Optional
0
Abstand zwischen den Schaltflächen „Mag ich“ und „Mag ich nicht“
df-messenger-message-rich-feedback-spacing
Optional
10 Pixel
Abstand zwischen den Elementen im ausführlichen Feedback
df-messenger-message-rich-feedback-padding
Optional
0
Padding des Rich-Feedbacks
df-messenger-message-rich-feedback-background
Optional
keine
Hintergrund des aussagekräftigen Feedbacks
df-messenger-message-rich-feedback-border-radius
Optional
0
Rahmenradius des Rich-Feedbacks
df-messenger-message-rich-feedback-border
Optional
keine
Rand des Rich-Feedbacks
df-messenger-rich-feedback-offset-left
Optional
0
Offset auf der linken Se

Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vordefinierter Agent für Filmexperten
bookmark_border
Preview
This product or feature is subject to the „Pre-GA Offerings Terms“ in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available „as is“ and might have limited support. For more information, see the launch stage descriptions.
Der Playbook-basierte vorkonfigurierte Filmexperte kann eine Vielzahl von filmbezogenen Fragen beantworten. Der Agent verweist sowohl auf ein BigQuery-Dataset mit Metadaten zu Filmen als auch auf einen unstrukturierten Datenspeicher mit Zusammenfassungen von Filmhandlungen aus Wikipedia.
Beispieldialoge
Die folgenden Beispieldialoge veranschaulichen gängige Szenarien, die von diesem vordefinierten Agenten verarbeitet werden.
Plot-Zusammenfassung und Datenbanksuche
Der Nutzer bittet den Kundenservicemitarbeiter um eine Zusammenfassung von Avatar. Der Kundenservicemitarbeiter ruft die Filmhandlung für Avatar aus dem Datenspeicher ab und fasst sie für den Nutzer zusammen. Der Nutzer fragt, wie viel Gewinn Avatar gemacht hat. Der Kundenservicemitarbeiter sucht in der Datenbank nach dem Umsatz und dem Budget von Avatar und verwendet diese Informationen, um die Frage des Nutzers zu beantworten. Der Nutzer möchte wissen, welcher nicht englischsprachige Film im Monat der Veröffentlichung von Avatar die höchsten Einnahmen erzielt hat. Der Kundenservicemitarbeiter sucht in der Datenbank, filtert nach Datum und Sprache und beantwortet die Frage des Nutzers.
Nutzereingabe
Antwort des Kundenservicemitarbeiters
Hallo

Hallo, willkommen bei Cymbal Movies. Ich helfe Ihnen gern bei Fragen zu Filmen. Stell uns gerne Fragen!
Mehr über Avatar

Die Handlung des Films „Avatar“ ist so:

Im Jahr 2154 haben die Menschen die natürlichen Ressourcen der Erde erschöpft, was zu einer schweren Energiekrise geführt hat. Die Resources Development Administration (RDA) fördert ein wertvolles Mineral – Unobtanium – auf Pandora, einem dicht bewaldeten bewohnbaren Mond, der um den Gasriesen Polyphemus im Alpha Centauri-Sternsystem kreist. Pandora, dessen Atmosphäre für Menschen giftig ist, wird von den Na’vi bewohnt, einer Spezies drei Meter großer, blauhäutiger, intelligenter Humanoiden, die in Harmonie mit der Natur leben und eine Muttergöttin namens Eywa verehren.

Kann ich sonst noch etwas für Sie tun?
Wie hoch war der Gewinn?

Avatar hatte ein Budget von 237 Millionen $und spielte 2,79 Milliarden $ein, was einem Gewinn von 2,55 Milliarden $entspricht.
Kann ich sonst noch etwas für Sie tun?
Welcher Film in einer anderen Sprache als Englisch war im Monat der Veröffentlichung von Avatar der umsatzstärkste?

Der Film, der im Monat der Veröffentlichung von Avatar die höchsten Einnahmen erzielte, war „3 Idiots“ mit einem Umsatz von 70 Millionen $.
Kann ich sonst noch etwas für Sie tun?
Das war’s. Danke!

Gern geschehen.

Grundlegende Einrichtung
So richten Sie diesen vordefinierten Agent ein:
Importieren Sie den vordefinierten Agenten.
Konfigurieren Sie die bereitgestellten Tools mit Ihren externen Diensten. Weitere Informationen finden Sie unter Tool-Einrichtung.
Tool-Einrichtung
Dieser Agent enthält Tools, die für die Einbindung in externe Dienste verwendet werden. Mit dem Installationsprogramm für vorgefertigte Tools können Sie Beispielcode und Daten für Ihren vorgefertigten Agenten bereitstellen.
Maximieren Sie die Ansicht, um eine Anleitung zum Bereitstellen und Konfigurieren von Beispielcode und ‑daten für den vorkonfigurierten Movie Expert-Agenten aufzurufen.
Lenkung
Das cymbal-movie-plots-Tool stellt eine Verbindung zu einem Datenspeicher her, der auf einen Cloud Storage-Bucket mit Zusammenfassungen von Filmhandlungen verweist.
In der Filmdatenbank suchen
Das bq-search OpenAPI-Tool stellt eine Verbindung zur BigQuery API her, gibt die vom Kundenservicemitarbeiter generierte SQL-Abfrage ein, führt sie in der BigQuery-Tabelle mit Metadaten zu Filmen aus und gibt die Abfrageergebnisse als JSON-Objekt an den Kundenservicemitarbeiter zurück.
Abgeschlossen
Ihr Agent und seine Integrationen sollten jetzt eingerichtet und bereit für den Test sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vordefinierte Komponente „Bestellstatus“
bookmark_border
Versionshinweise
Die vorgefertigte Komponente für den Bestellstatus prüft die Authentifizierungsebene eines Kunden und stellt dann einem authentifizierten Kunden Informationen zu seinen letzten oder bisherigen Bestellungen zur Verfügung. Diese Komponente verwendet die vorgefertigte Komponente Einzelhandel – Authentifizierung, um Nutzer zu authentifizieren. Die Komponente verwendet auch Generatoren für die Zusammenfassung nach dem Anruf.
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.
Letzte Bestellung
Der Endnutzer ruft von einer nicht registrierten Nummer an. Der Kundenservicemitarbeiter authentifiziert den Nutzer und stellt ihm dann detaillierte Informationen zu den Sendungen in der Bestellung zur Verfügung. Der Nutzer bestätigt, dass er eine SMS mit weiteren Informationen an seine registrierte Telefonnummer erhalten möchte.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Kundenservicemitarbeiter authentifiziert Nutzer mit der vorgefertigten Komponente Einzelhändler-Authentifizierung

Okay, John. Geht es um Ihre letzte Bestellung für Max Mustermann mit einer Lampe, einem Hemd und 10 anderen Artikeln, die am 10. 11. 2023 um 18:00 Uhr aufgegeben wurde?
Ja

Ihre Bestellung umfasst zwei Sendungen, die bis zum 15. Januar 2024 geliefert werden.

Möchten Sie mehr über diese Sendungen erfahren?
Ja

Sendung 1 mit Jeans, Gürtel und 2 anderen Artikeln ist auf dem Weg und wird bis zum 12. 01. 2024 zugestellt.

Sendung 2 mit Lampe, Hemd und 6 anderen Artikeln wurde am 12. 11. 2023 zugestellt.

Möchten Sie eine SMS mit weiteren Details zu Ihren Artikeln erhalten?
Ja

Wir haben Ihnen eine SMS mit einem Link gesendet, über den Sie den Status aller Sendungen verfolgen können. Vielen Dank für Ihren Anruf.

Doppelte Bestellungen
Der Endnutzer wurde bereits authentifiziert. Der Nutzer fordert Informationen zu einer Bestellung an und gibt die letzten fünf Ziffern der Bestellung an. Der Kundenservicemitarbeiter stellt fest, dass mehrere Bestellungen dieses Nutzers dieselben letzten fünf Ziffern haben. Er bestätigt daher, welche Bestellung der Nutzer wissen möchte, und teilt ihm den Bestellstatus mit.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Alles klar, Amber. Geht es um Ihre letzte Bestellung für Frau Anna Muster, die am 10. November 2023 um 18:00 Uhr aufgegeben wurde und eine Lampe, ein Hemd und zwei weitere Artikel enthält?
Nein

Nennen Sie mir bitte die letzten fünf Ziffern Ihrer Bestell-ID, die Sie verfolgen möchten.
12355

Die letzten fünf Ziffern der Bestell-ID, die wir erhalten haben, lauten 12355. Ist das richtig?
Ja, das ist richtig.

Sehr gut. Wir haben die Bestell-ID erfasst.

Laut unseren Daten haben wir zwei Bestellungen gefunden, die auf dieselben fünf Ziffern enden: 12355. Welche Bestellung suchen Sie?

Bestellnummer 1, die am 10.11.2023 um 18:00 Uhr aufgegeben wurde, oder Bestellnummer 2, die am 09.11.2023 um 20:00 Uhr aufgegeben wurde?

Geben Sie „1“ für Bestellnummer 1 oder „2“ für Bestellnummer 2 ein. Andernfalls sage „Nein“.
Bestellen

Ihre Bestellung umfasst zwei Sendungen, die bis zum 15. Januar 2024 geliefert werden.

Möchten Sie mehr über diese Sendungen erfahren?
Ja

Sendung 1 mit Jeans ist auf dem Weg und wird bis zum 15. 01. 2024 geliefert.

Sendung 2 mit Lampe, Hemd und einem weiteren Artikel wurde storniert.

Möchten Sie eine SMS mit weiteren Informationen zu Ihren Artikeln erhalten?
Nein, das ist alles.

Vielen Dank für Ihren Anruf.

Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Bestellstatus
Webhook
prebuilt_components_[component_name]:[webhook_action]
prebuilt_components_order_status:get_order_details

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
$flow.max_shipment
Gibt an, wie viele Sendungen dem Nutzer gleichzeitig angezeigt werden. Der Standardwert ist 2.
integer
$flow.tracking_status_delivered
Gibt den vom Webhook zurückgegebenen Wert an, der den Status einer zugestellten Bestellung angibt. Der Standardwert ist „delivered“.
String
$flow.tracking_status_cancelled
Gibt den vom Webhook zurückgegebenen Wert an, der den Status „Stornierte Bestellung“ angibt. Der Standardwert ist „cancelled“.
String
$flow.tracking_status_returned
Gibt den vom Webhook zurückgegebenen Wert an, der den Status einer zurückgegebenen Bestellung angibt. Der Standardwert ist „returned“.
String
$flow.tracking_status_partially_returned
Gibt den vom Webhook zurückgegebenen Wert an, der den Status einer teilweise zurückgegebenen Bestellung angibt. Der Standardwert ist „partially returned“.
String
$flow.max_retry_alternate_profile
Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn der Bestellstatus von einer nicht registrierten Telefonnummer oder einem alternativen Profil angefordert wird. Der Standardwert ist 3.
integer
$flow.max_retry_order_number
Gibt die zulässige Anzahl von Wiederholungsversuchen an, wenn eine Bestellnummer angegeben wird. Der Standardwert ist 3.
integer
$flow.max_retry_another_order_id
Gibt die Anzahl der zulässigen Wiederholungsversuche an, nachdem eine ungültige Bestellnummer angegeben wurde. Der Standardwert ist 3.
integer

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.
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: Bei der Unterhaltung wurde 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: Es ist ein Webhook-Fehler 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

Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
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_order_status: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_time
Die Uhrzeit, zu der die Bestellung aufgegeben wurde, im Format HH:MM.
String
order_status
Gibt den Status der Bestellung an. Beispiele für zulässige Werte sind „pending“, „processing“, „in-transit“, „on-hold“, „cancelled“, „delivered“, „returned“, „partially returned“.
String
order_product_name
Liste der Produktnamen in der Bestellung.
Liste (String)
order_product_quantity
Die Gesamtzahl der bestellten Produkte für jedes Produkt in einer Bestellung.
integer
order_product_count
Die Anzahl der eindeutigen Produkte in einer Bestellung.
integer
order_status_notification
Gibt an, ob Benachrichtigungen für diese Bestellung aktiviert sind.
boolean
return_eligibility_date
Liste der Datumsangaben, bis zu denen jedes Produkt in der Bestellung zurückgegeben werden kann, im YYYY-MM-DD-Format.
Liste (String)
order_customer_billing_name
Vorname des Kunden für die Rechnung der Bestellung.
String
order_latest_delivery_date
Das späteste Lieferdatum aller voraussichtlichen Liefertermine für die Sendungen innerhalb der Bestellung im Format YYYY-MM-DD.
String
order_shipment_multiple
Gibt an, ob die Bestellung mehrere Lieferungen enthält.
boolean
order_shipment_count
Die Anzahl der Sendungen innerhalb der Bestellung.
integer
order_shipment_product_count
Die Gesamtzahl der Produkte in jeder Sendung innerhalb der Bestellung.
Liste (ganze Zahl)
order_shipment_product_name
Liste der Produktnamen in jeder Sendung innerhalb der Bestellung.
Liste (String)
order_estimated_delivery_date
Liste der voraussichtlichen Liefertermine für jede Lieferung innerhalb der Bestellung im YYYY-MM-DD-Format.
Liste (String)
order_shipment_status
Liste mit dem Status für jede Lieferung innerhalb der Bestellung. Beispiele für zulässige Werte: „pending“, „processing“, „in-transit“, „on-hold“, „cancelled“, „delivered“, „returned“, „partially returned“.
Liste (String)

Maximieren Sie die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Get order details“ (Bestelldetails abrufen) für diese Komponente aufzurufen.
Duplikataufträge abrufen
Der prebuilt_components_retail_services:get_duplicate_order-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.
boolean
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.
Zahl

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Get duplicate orders“ für diese Komponente aufzurufen.
SMS senden
Über den prebuilt_components_order_status:send_sms-Webhook werden die Bestelldetails per SMS an die angegebene Telefonnummer gesendet.
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
Bestell-ID, für die Bestelldetails gesendet werden sollen.
String

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „SMS senden“ für diese Komponente aufzurufen.
Benachrichtigungen aktivieren
Der prebuilt_components_order_status:enable_notification-Webhook wird von der Komponente verwendet, um Benachrichtigungen für die registrierte Telefonnummer eines Nutzers zu aktivieren.
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_notification
Gibt an, ob Benachrichtigungen für den Nutzer aktiviert werden sollen.
boolean

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Benachrichtigungen aktivieren“ für diese Komponente aufzurufen.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vordefinierte Zahlungskomponente erstellen
bookmark_border
Versionshinweise
Die vordefinierte Komponente „Zahlung vornehmen“ authentifiziert den Nutzer und ermöglicht ihm, eine Zahlung auszuführen. Diese Komponente verwendet eine benutzerdefinierte Version der vorgefertigten Komponente Authentifizierung, um Kontoinhaber und Karteninhaber zu authentifizieren. Die Komponente verwendet außerdem die vordefinierten Komponenten Namensanfrage, Ablaufdatum der Kreditkarte und CVV-Anfrage der Kreditkarte, um Informationen zu erfassen, die für Zahlungen erforderlich sind.
Zahlungsarten
Diese Komponente unterstützt Zahlungen für Kreditkartenabrechnungen und Begünstigtenkonten. Bei Kreditkartenrechnungen können Nutzer den Mindestbetrag, den Gesamtbetrag oder einen benutzerdefinierten Betrag für ihre Rechnung bezahlen. Der Nutzer kann Zahlungen über sein Bankkonto, seine Debit- oder Kreditkarte oder per mobiler Zahlung vornehmen.
Zahlungsart
Verfügbare Zahlungsmethoden
Verfügbare Zahlungsbeträge
Kreditkartenabrechnung
Bankkonto, Debitkarte, mobile Zahlung
Mindest-, Gesamt- und benutzerdefinierter Betrag
Konto des Empfängers
Bankkonto, Kreditkarte, Debitkarte, mobile Zahlung
Benutzerdefinierter Betrag

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.
Zahlung auf das Konto des Empfängers
Der Kundenservicemitarbeiter stellt fest, dass der Nutzer noch nicht authentifiziert wurde, und erhebt Informationen, um zu bestätigen, dass der Nutzer ein registrierter Nutzer ist. Der Nutzer gibt an, dass er eine Zahlung auf ein Konto eines Begünstigten vornehmen möchte. Der Kundenservicemitarbeiter erfasst die erforderlichen Informationen, einschließlich des Namens des Begünstigten, und bestätigt die Kontonummer. Schließlich entscheidet sich der Nutzer, die Zahlung mit seiner Debitkarte vorzunehmen. Der Kundenservicemitarbeiter erfasst die Debitkartennummer, das Ablaufdatum und die CVV-Prüfziffer und bestätigt die Zahlung.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Der Kundenservicemitarbeiter authentifiziert den Nutzer mit der vordefinierten Komponente Authentication

Vielen Dank. Sie wurden erfolgreich authentifiziert.

Möchten Sie Ihre registrierte Kreditkartenabrechnung bezahlen oder eine Zahlung an ein bestehendes Begünstigtenkonto vornehmen?
Begünstigter

Kundenservicemitarbeiter erfasst den Namen des Begünstigten mithilfe der vordefinierten Komponente Name collection

Vielen Dank, wir haben den Namen des Begünstigten erfasst.

Okay, unseren Unterlagen zufolge haben wir die Kontonummer, die auf 7821 endet. Bitte sagen Sie „Ja“, um die Kontonummer zu bestätigen.
Ja

Bitte bestätigen Sie den Betrag, den Sie zahlen möchten. Wenn Sie beispielsweise 100, 30 € bezahlen möchten, sagen Sie „100 Punkt 30“.
50 $

Möchten Sie per Bankkonto, Debitkarte, Kreditkarte oder mobilem Zahlungsmittel bezahlen?
Debitkarte

Wie lauten die letzten vier Ziffern der Debitkartennummer, auf die Sie sich beziehen?
1234

Die letzten vier Ziffern der Debitkartennummer, die wir erhalten haben, lauten 1234. Ist das richtig?
Ja, das ist richtig.

Kundenservicemitarbeiter erfasst das Ablaufdatum der Debitkarte mit der vorgefertigten Komponente Ablaufdatum der Kreditkarte erheben

Super, wir haben das Ablaufdatum der Debitkarte erfasst.

Kundenservicemitarbeiter erfasst die CVV der Debitkarte mithilfe der vorgefertigten Komponente CVV-Erfassung für Kreditkarten

Super, wir haben die CVV erfasst.

Okay, wir überweisen 50 $an Jane mit der Debitkartennummer, die auf 1234 endet. Bestätigen Sie diese Aktion?
Ja

Wir senden Ihnen einen Code, um fortzufahren. Möchten Sie den Code lieber per Telefon oder per E-Mail erhalten?
Bitte per E-Mail

Wir haben einen Code an die registrierte E-Mail-Adresse maxmustermann@google.com gesendet. Das kann einige Sekunden dauern. Können Sie bitte den Code bestätigen?
123456

Okay, bitte warten Sie einen Moment, während wir die Zahlung ausführen.

Die Zahlung an Ihr Empfängerkonto war erfolgreich.

Begleichung der Kreditkartenrechnung
Der Kundenservicemitarbeiter stellt fest, dass der Nutzer noch nicht authentifiziert wurde, und erhebt Informationen, um zu bestätigen, dass der Nutzer ein registrierter Nutzer ist. Der Nutzer gibt an, dass er die Zahlung seiner Kreditkartenabrechnung über sein Bankkonto vornehmen möchte. Der Kundenservicemitarbeiter bestätigt den Zahlungsbetrag und die Zahlungsdetails und führt die Zahlung aus.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Der Kundenservicemitarbeiter authentifiziert den Nutzer mit der vordefinierten Komponente Authentication

Vielen Dank. Sie wurden erfolgreich authentifiziert.

Möchten Sie Ihre registrierte Kreditkartenabrechnung bezahlen oder eine Zahlung an ein bestehendes Begünstigtenkonto vornehmen?
Kreditkartenabrechnung

Wie lauten die letzten vier Ziffern der Kreditkartennummer, auf die Sie sich beziehen?
4321

Die letzten vier Ziffern der Kreditkartennummer, die wir erhalten haben, lauten 4321. Ist das richtig?
Ja

Der Gesamtbetrag, der fällig ist, beträgt 300 $und der Mindestbetrag für eine Zahlung ist 20 $. Möchten Sie den Gesamtbetrag, den Mindestbetrag oder einen anderen Betrag bezahlen?
Gesamtbetrag

Möchten Sie per Bankkonto, Debitkarte oder mobilem Bezahlverfahren bezahlen?
Sparkonto

Wir haben festgestellt, dass mit Ihrer Nummer zwei Konten verknüpft sind. Wie lauten die letzten vier Ziffern des Kontos, auf das Sie sich beziehen?
1001

Die letzten vier Ziffern der Kontonummer, die wir erhalten haben, lauten 1001. Ist das richtig?
Ja

Okay, wir überweisen 300 $für Ihre Kreditkartenabrechnung mit der Endziffer 4321 und der Kontonummer, die auf 1001 endet. Bestätigen Sie diese Aktion?
Ja

Wir senden Ihnen einen Code, um fortzufahren. Möchten Sie den Code lieber per Telefon oder E-Mail erhalten?
An meine E-Mail-Adresse senden

Wir haben einen Code an die registrierte E-Mail-Adresse maxmustermann@google.com gesendet. Das kann einige Sekunden dauern. Können Sie bitte den Code bestätigen?
123456

Okay, bitte warten Sie einen Moment, während wir die Zahlung vornehmen.

Ihre Kreditkartenzahlung war erfolgreich.

Unzureichendes Guthaben oder Limits
Der Kundenservicemitarbeiter stellt fest, dass der Nutzer noch nicht authentifiziert wurde, und erhebt Informationen, um zu bestätigen, dass der Nutzer ein registrierter Nutzer ist. Der Nutzer versucht, seine Kreditkartenabrechnung über sein Bankkonto und seine Debitkarte zu begleichen, aber beide Zahlungen werden aufgrund von unzureichendem Guthaben oder Limits abgelehnt. Schließlich entscheidet sich der Nutzer für eine mobile Zahlung und der Kundenservicemitarbeiter sendet ihm einen Link, über den er die Zahlung per Mobilgerät abschließen kann.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Der Kundenservicemitarbeiter authentifiziert den Nutzer mit der vordefinierten Komponente Authentication

Vielen Dank. Sie wurden erfolgreich authentifiziert.

Möchten Sie Ihre registrierte Kreditkartenabrechnung bezahlen oder eine Zahlung an ein bestehendes Begünstigtenkonto vornehmen?
Kreditkarte

Wie lauten die letzten vier Ziffern der Kreditkartennummer, auf die Sie sich beziehen?
4321

Die letzten vier Ziffern der Kreditkartennummer, die wir erhalten haben, lauten 4321. Ist das richtig?
Ja

Der Gesamtbetrag, der fällig ist, beträgt 300 $und der Mindestbetrag für eine Zahlung ist 20 $. Möchten Sie den Gesamtbetrag, den Mindestbetrag oder einen anderen Betrag bezahlen?
Gesamtbetrag

Möchten Sie per Bankkonto, Debitkarte oder mobilem Bezahlverfahren bezahlen?
Sparkonto

Wir haben festgestellt, dass mit Ihrer Nummer zwei Konten verknüpft sind. Wie lauten die letzten vier Ziffern des Kontos, auf das Sie sich beziehen?
1002

Die letzten vier Ziffern der Kontonummer, die wir erhalten haben, lauten 1002. Ist das richtig?
Ja

Okay, wir überweisen 300 $auf die Kreditkartenabrechnung mit der Endziffer 4321 und der Kontonummer, die auf 1002 endet. Bestätigen Sie diese Aktion?
Ja

Wir senden Ihnen einen Code, um fortzufahren. Möchten Sie den Code lieber per Telefon oder E-Mail erhalten?
E-Mail

Wir haben einen Code an die registrierte E-Mail-Adresse maxmustermann@google.com gesendet. Das kann einige Sekunden dauern. Können Sie bitte den Code bestätigen?
123456

Okay, bitte warten Sie einen Moment, während wir die Zahlung vornehmen.

Ihre Zahlung ist aufgrund unzureichenden Guthabens auf dem Konto fehlgeschlagen. Möchten Sie die Zahlung mit einer anderen Zahlungsmethode noch einmal versuchen?
Ja

Möchten Sie per Bankkonto, Debitkarte oder mobilem Bezahlverfahren bezahlen?
Debitkarte

Wie lauten die letzten vier Ziffern der Debitkartennummer, auf die Sie sich beziehen?
2345

Die letzten vier Ziffern der Debitkartennummer, die wir erhalten haben, lauten 2345. Ist das richtig?
Ja

Kundenservicemitarbeiter erfasst das Ablaufdatum der Debitkarte mithilfe der vorgefertigten Komponente Ablaufdatum der Kreditkarte erheben

Super, wir haben das Ablaufdatum der Debitkarte erfasst.

Kundenservicemitarbeiter erfasst die CVV der Debitkarte mithilfe der vorgefertigten Komponente CVV-Erfassung für Kreditkarten

Super, wir haben jetzt die CVV.

Okay, wir leisten eine Zahlung in Höhe von 300 $für Ihre Kreditkartenabrechnung mit der Endziffer 4321 und der Debitkartennummer mit der Endziffer 2345. Bestätigen Sie diese Aktion?
Ja

Wir senden Ihnen einen Code, um fortzufahren. Möchten Sie den Code lieber per Telefon oder E-Mail erhalten?
E-Mail

Wir haben einen Code an die registrierte E-Mail-Adresse maxmustermann@google.com gesendet. Das kann einige Sekunden dauern. Können Sie bitte den Code bestätigen?
123456

Okay, bitte warten Sie einen Moment, während wir die Zahlung vornehmen.

Ihre Zahlung ist fehlgeschlagen, da das Limit der Debitkarte überschritten wurde. Möchten Sie die Zahlung mit einer anderen Zahlungsmethode noch einmal versuchen?
Ja

Möchten Sie per Bankkonto, Debitkarte oder mobilem Bezahlverfahren bezahlen?
Mobil

Okay, wir senden den Zahlungslink an Ihre registrierte Mobilnummer. Dieser Vorgang kann einige Sekunden dauern. Bitte bestätigen Sie mit „Ja“, wenn Sie sie erhalten haben.
Ja

Sehr gut. Jetzt können Sie den Link öffnen und mit der Zahlung fortfahren.

Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Zahlung ausführen
Komponentenspezifischer Intent
prebuilt_components_[component_name][intent_name] prebuilt_components_make_a_payment_payment_type Entitätstyp prebuilt_components[component_name][entity_type] prebuilt_components_make_a_payment_payment_mode Webhook prebuilt_components[component_name]:[webhook_action]
prebuilt_components_make_a_payment:process_payment_credit_card

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 Ablaufebene müssen wie unten beschrieben 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.auth_level
(Optional) Gibt die Authentifizierungsebene des Aufrufers an.
integer
$session.params.auth_level_req
Gibt die Authentifizierungsebene an, die erforderlich ist, damit ein Nutzer auf seinen Transaktionsverlauf zugreifen kann. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert 1.
integer
$session.params.account_auth_enabled
Gibt an, ob der Nutzer wie unter Authentifizierungstypen beschrieben als Kontoinhaber authentifiziert werden soll. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert true.
boolean
$session.params.card_auth_enabled
Gibt an, ob der Nutzer wie unter Authentifizierungstypen beschrieben als Karteninhaber authentifiziert werden soll. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert false.
boolean
$session.params.phone_number
(Optional) Die registrierte Telefonnummer des Kunden, die für die Authentifizierung verwendet wird.
String
$flow.payment_success_code
Gibt den Wert des Felds payment_status_code an, das von den process_payment-Webhooks zurückgegeben wird und angibt, dass die Zahlung erfolgreich war. Standardmäßig ist dieser Wert „200“.
String
$flow.insufficient_fund_code
Gibt den Wert des Felds payment_status_code an, das von den process_payment-Webhooks zurückgegeben wird und angibt, dass die Zahlung aufgrund unzureichenden Guthabens nicht abgeschlossen werden konnte. Standardmäßig ist dieser Wert „400“.
String
$flow.limit_exceed_code
Gibt den Wert des Felds payment_status_code an, das von den process_payment-Webhooks zurückgegeben wird und angibt, dass die Zahlung aufgrund des Überschreitens des Tageslimits nicht abgeschlossen werden konnte. Standardmäßig ist dieser Wert „401“.
String
$flow.max_retry_mop_counter
Gibt an, wie oft ein Nutzer seine Zahlungsmethode ändern darf. Der Standardwert ist 2.
integer
$flow.max_retry_credit_card_payment
Gibt die Anzahl der zulässigen Wiederholungen an, wenn versucht wird, eine Zahlung mit einer Kreditkarte als Zahlungsmethode auszuführen. Der Standardwert ist 3.
integer
$flow.max_retry_mobile_payment_counter
Gibt die Anzahl der zulässigen Wiederholungen an, wenn versucht wird, eine Zahlung mit mobiler Zahlung als Zahlungsmethode auszuführen. Der Standardwert ist 2.
integer
$flow.max_retry_creditcard_count
Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn eine gültige Kreditkartennummer für die Zahlung erfasst wird. Der Standardwert ist 3.
integer
$flow.max_retry_acc_number
Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn gültige Kontodetails für die Zahlung erfasst werden. Der Standardwert ist 3.
integer
$flow.max_retry_debit_card_details
Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn gültige Debitkartendetails für die Zahlung erfasst werden. Der Standardwert ist 3.
integer
$flow.max_retry_credit_card_details
Gibt die Anzahl der zulässigen Wiederholungen an, wenn gültige Kreditkartendetails für eine Zahlung erfasst werden. Der Standardwert ist 3.
integer
$flow.otp_length
Gibt die erwartete Länge des Einmalpassworts an, das an den Nutzer gesendet wird. Der Standardwert ist 6.
integer
$flow.max_retry_otp_count
Gibt die Anzahl der zulässigen Wiederholungen an, wenn ein gültiges Einmalpasswort (OTP) vom Nutzer erfasst wird. Der Standardwert ist 3.
integer
$flow.max_waiting_room_counter
Gibt an, wie oft der Nutzer den Kundenservicemitarbeiter bitten kann, zu warten, während er den Link für die mobile Zahlung erhält. Der Standardwert ist 2.
integer

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.
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
auth_level
Gibt die Authentifizierungsstufe des Anrufers an.
integer
phone_number
Die Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers 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: Bei der Unterhaltung wurde 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: Es ist ein Webhook-Fehler 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

Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unten 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 findest du unter Authentifizierungs-Webhook einrichten.
Konto bestätigen
Mit dem prebuilt_components_account_services:validate_account-Webhook wird anhand der registrierten Telefonnummer des Nutzers und der letzten vier Ziffern der angegebenen Kontonummer überprüft, ob ein Konto vorhanden ist. Der Webhook gibt auch das Kontoguthaben zurück, falls ein Konto vorhanden 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
$session.params.last_four_digit_of_account_number
Die letzten vier Ziffern der Kontonummer, die der Nutzer ausgewählt und bestätigt hat, um eine Zahlung vorzunehmen.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
account_found
Gibt an, ob für das registrierte Konto des Nutzers ein Konto mit den angegebenen letzten vier Ziffern vorhanden ist.
boolean
Kontostand
Der Betrag des aktuellen Kontostands, falls vorhanden.
Zahl

Wenn Sie den Webhook „Konto bestätigen“ für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt.
Kartendetails des Nutzers
Der prebuilt_components_make_a_payment:user_card_details-Webhook wird von der Komponente verwendet, um Details zu den Debit- und Kreditkarten eines registrierten Nutzers 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
Die Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
credit_card_count
Anzahl der Kreditkarten, die mit der registrierten Telefonnummer verknüpft sind.
integer
last_four_digit_of_credit_card_number
Die letzten vier Ziffern der Kreditkartennummer des Nutzers. Wenn der Kunde mehrere Kreditkarten hat, ist dieser Wert null.
String
debit_card_count
Anzahl der Debitkarten, die mit der registrierten Telefonnummer verknüpft sind.
integer
last_four_digit_of_debit_card_number
Die letzten vier Ziffern der Debitkarte des Nutzers. Wenn der Kunde mehrere Debitkarten hat, ist dieser Wert null.
String

Maximiere die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks für die Details der Nutzerkarte für diese Komponente aufzurufen.
Namen des Begünstigten bestätigen
Mit dem prebuilt_components_make_a_payment:verify_beneficiary_name-Webhook wird von der Komponente überprüft, ob für den vom Nutzer angegebenen Namen ein Begünstigtenkonto vorhanden 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
$session.params.name_collection_first_name
Vorname des Begünstigten.
String
$session.params.name_collection_last_name
Nachname des Begünstigten.
String
$session.params.name_collection_middle_name
Zweiter Vorname des Begünstigten.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
beneficiary_account_number
Die letzten vier Ziffern der Kontonummer des Begünstigten für den angegebenen Namen des Begünstigten. Wenn kein Konto für den angegebenen Namen gefunden wird, ist der Wert null.
String

Wenn Sie den Webhook „Name des Begünstigten bestätigen“ für diese Komponente konfigurieren möchten, maximieren Sie die Ansicht und folgen Sie der Anleitung.
Fälligen Betrag abrufen
Über den prebuilt_components_make_a_payment:get_due_amount-Webhook erhält die Komponente Informationen zum Mindest- und Gesamtbetrag der Kreditkartenabrechnung des Nutzers.
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.user_credit_card_number
Die letzten vier Ziffern der Kreditkartennummer des Nutzers.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
minimum_amount
Der fällige Mindestbetrag für die angegebene Kreditkartenabrechnung.
Zahl
total_amount
Der fällige Gesamtbetrag für die angegebene Kreditkartenabrechnung.
Zahl

Wenn Sie den Webhook „Get due amount“ (Ausstehender Betrag abrufen) für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt.
Kreditkartennummer bestätigen
Mit dem prebuilt_components_make_a_payment:verify_credit_card_number-Webhook wird von der Komponente überprüft, ob die angegebene Kreditkartennummer mit dem Konto des Nutzers verknüpft 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.user_credit_card_number
Die letzten vier Ziffern der Kreditkartennummer des Nutzers.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
card_found
Gibt an, ob die angegebene Kreditkarte gefunden wurde.
boolean

Wenn Sie den Webhook „Kreditkartennummer bestätigen“ für diese Komponente konfigurieren möchten, maximieren Sie die Ansicht und folgen Sie der Anleitung.
Kreditkartendetails bestätigen
Mit dem prebuilt_components_make_a_payment:verify_credit_card_details-Webhook wird überprüft, ob die angegebenen Details, einschließlich Ablaufdatum und CVV, für die angegebene Kreditkarte des Nutzers gültig sind.
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.credit_card_number
Die letzten vier Ziffern der Kreditkartennummer des Nutzers.
String
$flow.credit_card_exp_date
Das vom Nutzer angegebene Ablaufdatum der jeweiligen Kreditkarte.
{
„year“: integer,
„month“: integer
}
$flow.credit_card_cvv_code
Der vom Nutzer angegebene CVV-Code für die angegebene Kreditkarte.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
creditcard_verification_status
Gibt an, ob die angegebenen Kreditkartendetails bestätigt wurden.
boolean

Maximieren Sie die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Kreditkartendetails bestätigen“ für diese Komponente aufzurufen.
Debitkartendetails bestätigen
Der prebuilt_components_make_a_payment:verify_debit_card_details-Webhook wird von der Komponente verwendet, um zu überprüfen, ob die angegebenen Details, einschließlich Ablaufdatum und CVV, für die angegebene Debitkarte des Nutzers gültig sind.
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.debit_card_number
Die letzten vier Ziffern der Debitkarte des Nutzers.
String
$flow.debit_card_exp_date
Das vom Nutzer angegebene Ablaufdatum der Debitkarte.
{
„year“: integer,
„month“: integer
}
$flow.debit_card_cvv_code
Der vom Nutzer angegebene CVV-Code für die angegebene Debitkarte.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
debitcard_verification_status
Gibt an, ob die angegebenen Debitkartendetails bestätigt wurden.
boolean

Maximieren Sie die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Debitkartendetails bestätigen“ für diese Komponente aufzurufen.
Kreditkartenzahlung verarbeiten
Der prebuilt_components_make_a_payment:process_payment_credit_card-Webhook wird von der Komponente verwendet, um eine Zahlung mit den angegebenen Kreditkartendetails zu verarbeiten.
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.payee_number
Die letzten vier Ziffern der Kontonummer des Zahlungsempfängers für die Zahlung.
String
$flow.payment_type
Zahlungsart für die Zahlung. Gültige Werte werden durch das benutzerdefinierte Element prebuilt_components_make_a_payment_payment_type definiert. Diese Komponente unterstützt standardmäßig „beneficiary_pay“ und „credit_card_pay“.
String
$flow.credit_card_number
Die letzten vier Ziffern der Kreditkartennummer des Nutzers.
String
$flow.credit_card_exp_date
Das vom Nutzer angegebene Ablaufdatum der angegebenen Kreditkarte.
{
„year“: integer,
„month“: integer
}
$flow.credit_card_cvv_code
Der vom Nutzer angegebene CVV-Code für die angegebene Kreditkarte.
String
$flow.payment_amount
Der Betrag, den der Nutzer zu zahlen bereit ist.
Zahl

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
payment_status_code
Gibt an, ob die Zahlung erfolgreich war. Gültige Werte werden durch die konfigurierbaren Eingabeparameter $flow.payment_success_code, $flow.insufficient_fund_code und $flow.limit_exceed_code definiert.
String

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Kreditkartenzahlung verarbeiten“ für diese Komponente aufzurufen.
Debitkartenzahlung verarbeiten
Der prebuilt_components_make_a_payment:process_payment_debit_card-Webhook wird von der Komponente verwendet, um eine Zahlung mit den angegebenen Debitkartendetails zu verarbeiten.
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.payee_number
Die letzten vier Ziffern der Kontonummer des Zahlungsempfängers für die Zahlung.
String
$flow.payment_type
Zahlungsart für die Zahlung. Gültige Werte werden durch das benutzerdefinierte Element prebuilt_components_make_a_payment_payment_type definiert. Diese Komponente unterstützt standardmäßig „beneficiary_pay“ und „credit_card_pay“.
String
$flow.debit_card_number
Die letzten vier Ziffern der Debitkarte des Nutzers.
String
$flow.debit_card_exp_date
Das vom Nutzer angegebene Ablaufdatum der Debitkarte.
{
„year“: integer,
„month“: integer
}
$flow.debit_card_cvv_code
Der vom Nutzer angegebene CVV-Code für die angegebene Debitkarte.
String
$flow.payment_amount
Der Betrag, den der Nutzer zu zahlen bereit ist.
Zahl

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
payment_status_code
Gibt an, ob die Zahlung erfolgreich war. Gültige Werte werden durch die konfigurierbaren Eingabeparameter $flow.payment_success_code, $flow.insufficient_fund_code und $flow.limit_exceed_code definiert.
String

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Debitkartenzahlung verarbeiten“ für diese Komponente aufzurufen.
Kontozahlung verarbeiten
Der prebuilt_components_make_a_payment:process_payment_account-Webhook wird von der Komponente verwendet, um eine Zahlung mit den angegebenen Kontodetails zu verarbeiten.
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.payee_number
Die letzten vier Ziffern der Kontonummer des Zahlungsempfängers für die Zahlung.
String
$flow.payment_type
Zahlungsart für die Zahlung. Gültige Werte werden durch das benutzerdefinierte Element prebuilt_components_make_a_payment_payment_type definiert. Diese Komponente unterstützt standardmäßig „beneficiary_pay“ und „credit_card_pay“.
String
$session.params.last_four_digit_of_account_number
Die letzten vier Ziffern des Kontos des Nutzers.
String
$flow.payment_amount
Der Betrag, den der Nutzer zu zahlen bereit ist.
Zahl

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
payment_status_code
Gibt an, ob die Zahlung erfolgreich war. Gültige Werte werden durch die konfigurierbaren Eingabeparameter $flow.payment_success_code, $flow.insufficient_fund_code und $flow.limit_exceed_code definiert.
String

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Kontozahlung verarbeiten“ für diese Komponente aufzurufen.
Mobile Zahlungen verarbeiten
Der prebuilt_components_make_a_payment:process_payment_mobile-Webhook wird von der Komponente verwendet, um einen Link für mobile Zahlungen für die ausgewählten Zahlungsdetails des Nutzers zu generieren und 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 Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.
String
$flow.payee_number
Die letzten vier Ziffern der Kontonummer des Zahlungsempfängers für die Zahlung.
String
$flow.payment_type
Zahlungsart für die Zahlung. Gültige Werte werden durch das benutzerdefinierte Element prebuilt_components_make_a_payment_payment_type definiert. Diese Komponente unterstützt standardmäßig „beneficiary_pay“ und „credit_card_pay“.
String
$flow.payment_amount
Der Betrag, den der Nutzer zu zahlen bereit ist.
Zahl

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
payment_link_generated
Gibt an, ob der Link für mobile Zahlungen erfolgreich generiert und an den Nutzer gesendet wurde.
boolean

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Mobile Zahlungen verarbeiten“ für diese Komponente aufzurufen.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vordefinierte Komponente zum Erfassen von Telefonnummern
bookmark_border
Diese vordefinierte Komponente erfasst und validiert den Ländercode und die Telefonnummer.
Beschränkungen
Zusätzlich zu den allgemeinen Einschränkungen für vordefinierte Komponenten gelten für diese vordefinierte Komponente die folgenden Einschränkungen:
Telefonnummern mit mehr als 16 Ziffern sind nicht zulässig.
Empfohlene Einstellungen für Kundenservicemitarbeiter
Aktivieren Sie DTMF, damit Nutzer numerische Werte über die Telefontastatur eingeben können.
Zusätzliche Funktionen
Diese vorgefertigte Komponente bietet die folgenden zusätzlichen Funktionen:
Wiederholen
Wartezimmer
Wiedergabe
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.
Gültige Telefonnummer in zwei Wendungen
Der Endnutzer gibt zuerst die Landesvorwahl und dann die Telefonnummer an. Der Kundenservicemitarbeiter bestätigt und akzeptiert sie.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Wie lautet der Name oder Code Ihres Landes?
+1

Ihre Landesvorwahl ist +1. Nennen Sie mir bitte Ihre Telefonnummer.
6502530000

Alles klar. Die von Ihnen genannte Nummer lautet +1 6502530000. Ist das richtig?
Ja, das ist richtig.

Super, ich habe jetzt die Telefonnummer.

Gültige Telefonnummer für einzelne Abbiegung
Der Endnutzer gibt Landesvorwahl und Telefonnummer gleichzeitig an. Der Kundenservicemitarbeiter bestätigt und akzeptiert sie.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Wie lautet der Name oder Code Ihres Landes?
+1 6502530000

Alles klar. Die von Ihnen genannte Nummer lautet +1 6502530000. Ist das richtig?
Ja, das ist richtig.

Super, ich habe jetzt die Telefonnummer.

Ungültige Telefonnummer
Der Endnutzer gibt in einem Turn eine Ländervorwahl und eine Telefonnummer an. Der Kundenservicemitarbeiter stellt fest, dass die angegebene Telefonnummer zwar eine gültige Länge (16 Ziffern) hat, aber nicht gültig ist. Der Kundenservicemitarbeiter bittet den Endnutzer dann noch einmal, seine Telefonnummer anzugeben.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Wie lautet der Name oder Code Ihres Landes?
+1 6502530001

Diese Telefonnummer konnte nicht erkannt werden. Ich habe die Landesvorwahl als „+1“ erfasst. Geben Sie eine gültige Telefonnummer an.
6502530000

Alles klar. Die von Ihnen genannte Nummer lautet +1 6502530000. Ist das richtig?
Ja, das ist richtig.

Super, ich habe jetzt die Telefonnummer.

Ungültige Ländervorwahl und Telefonnummer
Der Endnutzer gibt in einem Gespräch eine Ländervorwahl und eine Telefonnummer an. Der Kundenservicemitarbeiter prüft die Angaben und stellt fest, dass die Ländervorwahl und die Telefonnummer ungültig sind. Der Kundenservicemitarbeiter bittet den Endnutzer dann noch einmal, den Ländercode und die Telefonnummer anzugeben.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Wie lautet der Name oder Code Ihres Landes?
+0080000000000

Die angegebene Ländervorwahl oder Telefonnummer ist ungültig. Fangen wir noch einmal von vorn an. Nennen Sie den Namen oder Code Ihres Landes.
1

Ihre Landesvorwahl ist +1 . Wie lautet Ihre Telefonnummer?
6502530000

Alles klar. Die von Ihnen genannte Nummer lautet +1 6502530000. Ist das richtig?
Ja, das ist richtig.

Super, ich habe jetzt die Telefonnummer.

Unbekannte Eingabe
Die Komponente beendet den Ablauf, nachdem der Endnutzer dreimal eine nicht erkannte Eingabe gemacht hat.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Wie lautet der Name oder Code Ihres Landes?
Alles in Ordnung

Das habe ich nicht verstanden. Können Sie den Ländercode noch einmal sagen oder eingeben?
nett

Hm, das habe ich immer noch nicht verstanden. Achten Sie darauf, dass Sie die Ländervorwahl mitsprechen. Wenn ich Sie nicht gut verstehe, können Sie den Ländercode auch über die Tastatur eingeben.
good

Ich habe Ihre Antwort leider nicht verstanden.

Überprüfung der Telefonnummer
Die vordefinierte Komponente „Telefonnummer“ verwendet die Systemfunktion „IS_PHONE_NUMBER“, um zu prüfen, ob die Telefonnummer einem gültigen Muster entspricht.
Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Telefonnummernerfassung
Komponentenspezifischer Intent
prebuilt_components_[component_name][intent_name] prebuilt_components_telephone_number_collection_incorrect_country_code Parameter

[param_name]

telephone_number Entitätstyp prebuilt_components[component_name]_[intent_name]
prebuilt_components_telephone_no_country_code

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
telephone_number_collection_telephone_number
Dieser Parameter gibt die von der Komponente erfasste Telefonnummer zurück.
String
telephone_number_collection_country_code
Dieser Parameter gibt den von der Komponente erfassten Ländercode zurück.
String

Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
Abgeschlossen
Ihr Agent sollte jetzt eingerichtet und bereit zum Testen sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vordefinierte Komponente für verlorene oder gestohlene Karten
bookmark_border
Versionshinweise
Die vordefinierte Komponente für verlorene und gestohlene Karten authentifiziert den Nutzer, ruft Karten ab, die auf den Nutzer registriert sind, und ermöglicht es ihm, eine Karte zu sperren. Nachdem der Nutzer seine gesperrte Karte bestätigt hat, kann er sich über die Komponente für ein Upgrade registrieren oder eine neue Karte beantragen. Diese Komponente verwendet eine benutzerdefinierte Version der vorgefertigten Komponente Authentifizierung, um Karteninhaber zu authentifizieren.
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.
Nicht authentifizierter Nutzer mit einer einzelnen Karte
Der Kundenservicemitarbeiter stellt fest, dass der Nutzer noch nicht authentifiziert wurde, und erhebt Informationen, um zu bestätigen, dass der Nutzer ein registrierter Karteninhaber ist. Nachdem sich der Nutzer authentifiziert hat, ruft der Kundenservicemitarbeiter Informationen zur einzelnen Karte ab, die für den Nutzer registriert ist. Der Nutzer bestätigt, dass er die Karte sperren möchte. Der Kundenservicemitarbeiter sperrt die Karte. Schließlich bestätigt der Kundenservicemitarbeiter die bevorzugte Karte und Lieferadresse des Nutzers und stellt ihm eine neue Karte aus.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Der Kundenservicemitarbeiter authentifiziert den Nutzer mit der vordefinierten Komponente Authentication

Vielen Dank. Sie wurden erfolgreich authentifiziert.

Bitte warten Sie, während wir Ihre Kartendetails abrufen.

Wir haben Ihre MasterCard mit der Endung 4444 gefunden. Möchten Sie Ihre Karte dauerhaft sperren?
Ja

Bitte teilen Sie uns mit, warum Sie Ihre Karte sperren möchten. Sie können Optionen wie „Beschädigt“, „Gestolen“ oder „Verloren“ auswählen.
Ich habe meine Karte verloren

Vielen Dank für Ihre Rückmeldung. Wir helfen Ihnen, Ihre Karte dauerhaft zu sperren. Können Sie bestätigen, dass die Karte auf 4444 endet?
Ja

Okay. Bevor wir fortfahren, senden wir einen Code an Ihre registrierte Mobiltelefonnummer. Bitte geben Sie den Code ein, um die Anfrage zu bestätigen.
123457

Ihre Karte mit den Endziffern 4444 wird dauerhaft gesperrt. Danach können Sie mit dieser Karte keine Transaktionen mehr online oder an Kassen durchführen. Bestätigen Sie diese Aktion?
Ja

Ihre Karte wurde gesperrt. Ihre Anfragenummer lautet 9761431 und wurde an Ihre registrierte Mobiltelefonnummer gesendet. Möchten Sie eine neue Karte ausstellen lassen?
Ja

Sie haben Anspruch auf eine Platinkarte. Die jährliche Gebühr beträgt 97 $ und Sie erhalten jährliche Prämien und besondere Vorteile im Wert von 494 $. Klicken Sie auf den Link, der an Ihre registrierte Mobiltelefonnummer gesendet wurde, um mehr zu erfahren.

Möchten Sie sich für diese Karte registrieren?
Ja

Wir liefern die Karte an Ihre registrierte Adresse. Ist die Postleitzahl Ihrer Lieferadresse 12345?
Ja

Okay, bitte warten Sie einen Moment, während wir die Neuausstellung einer neuen Karte beantragen.

Der Antrag auf Neuausstellung der neuen Karte war erfolgreich. Ihre Anfragenummer lautet 4643943 und wurde an Ihre registrierte Mobiltelefonnummer gesendet.

Die Karte wird innerhalb von 3 Arbeitstagen an Ihre registrierte Adresse geliefert. Folgen Sie der Anleitung, die Sie mit der Karte erhalten haben, um sie zu verwenden.

Authentifizierter Nutzer mit mehreren Karten
Der Kundenservicemitarbeiter erkennt, dass der Nutzer bereits authentifiziert wurde, und ruft Informationen zu den für den Nutzer registrierten Karten ab. Der Nutzer wählt eine Karte aus, die zuvor gesperrt wurde. Der Kundenservicemitarbeiter ermöglicht es ihm daher, eine neue Karte anzufordern.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Bitte warten Sie, während wir Ihre Kartendetails abrufen.

Wir haben mehrere Karten mit Ihrer Nummer gefunden. Wir haben eine Visa-Karte mit der Endung 1456, eine MasterCard mit der Endung 1457, eine MasterCard mit der Endung 1345 und eine Visa-Karte mit der Endung 3456.

Nennen Sie uns die letzten vier Ziffern der Karte, die Sie sperren möchten.
1457

Die letzten vier Ziffern der Kartennummer, die wir erhalten haben, lauten 1457. Ist das richtig?
Ja

Die angeforderte Karte ist bereits dauerhaft gesperrt. Möchten Sie eine neue Karte ausstellen lassen?
Ja

Wir liefern die Karte an Ihre registrierte Adresse. Ist die Postleitzahl Ihrer Lieferadresse 12345?
Ja

Okay, bitte warten Sie einen Moment, während wir die Neuausstellung einer neuen Karte beantragen.

Der Antrag auf Neuausstellung der neuen Karte war erfolgreich. Ihre Anfragenummer lautet 5423270 und wurde an Ihre registrierte Mobiltelefonnummer gesendet.

Die Karte wird innerhalb von 3 Arbeitstagen an Ihre registrierte Adresse geliefert. Folgen Sie der Anleitung, die Sie mit der Karte erhalten haben, um sie zu verwenden.

Möchten Sie weitere Karten sperren?
Nein, das war’s schon.

Okay, vielen Dank für Ihren Anruf.

Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Verlorene und gestohlene Karte
Entitätstyp
prebuilt_components_[component_name][entity_type] prebuilt_components_lost_and_stolen_lock_reason Webhook prebuilt_components[component_name]:[webhook_action]
prebuilt_components_lost_and_stolen_card:lock_card_ticket_number

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 Ablaufebene müssen wie unten beschrieben 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.auth_level
(Optional) Gibt die Authentifizierungsebene des Aufrufers an.
integer
$session.params.auth_level_req
Gibt die Authentifizierungsebene an, die erforderlich ist, damit ein Nutzer auf seinen Transaktionsverlauf zugreifen kann. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert 1.
integer
$session.params.account_auth_enabled
Gibt an, ob der Nutzer wie unter Authentifizierungstypen beschrieben als Kontoinhaber authentifiziert werden soll. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert false.
boolean
$session.params.card_auth_enabled
Gibt an, ob der Nutzer wie unter Authentifizierungstypen beschrieben als Karteninhaber authentifiziert werden soll. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert true.
boolean
$session.params.phone_number
(Optional) Die registrierte Telefonnummer des Kunden, die für die Authentifizierung verwendet wird.
String
$session.params.card_count
(Optional) Anzahl der Kreditkarten, die mit dem authentifizierten Nutzer verknüpft sind.
integer
$flow.card_status_active
Gibt den Wert des Parameters an, der vom Webhook „Validate card“ zurückgegeben wird, um anzugeben, dass die ausgewählte Karte derzeit aktiv ist. Der Standardwert ist „active“.
String
$flow.card_status_lock_temp
Gibt den Wert des Parameters an, der vom Webhook „Validate card“ zurückgegeben wird, um anzugeben, dass die ausgewählte Karte vorübergehend gesperrt ist. Der Standardwert ist „inactive“.
String
$flow.card_status_lock_permanent
Gibt den Wert des Parameters an, der vom Webhook „Validate card“ zurückgegeben wird, um anzugeben, dass die ausgewählte Karte dauerhaft gesperrt ist. Der Standardwert ist „blocked“.
String
$flow.max_retry_card_number
Gibt die zulässige Anzahl von Wiederholungsversuchen an, wenn die letzten vier Ziffern der Kreditkarte erfasst werden. Der Standardwert ist 3.
integer
$flow.max_otp_retry_count
Gibt die Anzahl der zulässigen Wiederholungen an, wenn das Einmalpasswort (OTP) vom Nutzer erfasst wird. Der Standardwert ist 3.
integer

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.
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
auth_level
Gibt die Authentifizierungsstufe des Anrufers an.
integer
phone_number
Die Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.
String
card_count
Die Anzahl der Karten, die mit der registrierten Telefonnummer verknüpft sind.
integer
last_four_digit_of_card_number
Wenn ein Nutzer nur eine Karte hat, werden die letzten vier Ziffern der Kartennummer zurückgegeben. Wenn ein Nutzer mehr als eine Karte hat, entspricht der Wert dieses Parameters den letzten vier Ziffern der Karte, die der Nutzer zum Sperren oder Neuausstellen ausgewählt hat.
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: Bei der Unterhaltung wurde 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: Es ist ein Webhook-Fehler 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

Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unten 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 findest du unter Authentifizierungs-Webhook einrichten.
Kartendetails abrufen
Über den prebuilt_components_account_services:get_card_details-Webhook erhält die Komponente Informationen zu den Karten, die für einen Nutzer registriert sind.
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

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
last_four_digit_of_all_cards
Liste mit den letzten vier Ziffern jeder Karte, die für den Nutzer registriert ist, z. B. [„0000“, „1111“, „2222“]. Jedes Element in dieser Liste entspricht derselben Karte wie das Element mit demselben Index in card_vendor_all.
Liste (String)
card_vendor_all
Liste mit dem Kreditkartenanbieter für jede Karte, die für den Nutzer registriert ist, z. B. [„Visa“, „Mastercard“, „Discover“]. Jedes Element in dieser Liste entspricht derselben Karte wie das Element mit demselben Index in last_four_digit_of_all_cards.
Liste (String)
card_count
Anzahl der Karten, die mit dem authentifizierten Nutzer verknüpft sind.
integer

Maximiere die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Kartendetails abrufen“ für diese Komponente aufzurufen.
Karte bestätigen
Über den prebuilt_components_lost_and_stolen_card:validate_card-Webhook erhält die Komponente Informationen zu einer bestimmten Karte, die im Konto eines Nutzers registriert 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
$session.params.last_four_digit_of_card_number
Die letzten vier Ziffern der Kartennummer, die der Nutzer sperren lassen möchte.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
zip_code
Die Postleitzahl, die mit dem Konto des Nutzers verknüpft ist.
String
card_vendor
Der Kreditkartenanbieter der ausgewählten Karte.
String
card_status
Gibt den aktuellen Status der Karte an. Gültige Werte sind standardmäßig „aktiv“, „vorübergehend blockiert“ oder „dauerhaft blockiert“. Diese Status werden durch die Parameter $flow.card_status_active, $flow.card_status_lock_temp und $flow.card_status_lock_permanent angegeben. Siehe Eingabeparameter.
String
card_upgrade
Gibt an, ob für die ausgewählte Karte ein Upgrade verfügbar ist.
boolean
card_upgrade_type
Gibt den verfügbaren Kartenupgradetyp an, z. B. „gold“ oder „platinum“. Wenn „card_upgrade“ false ist, ist dieser Parameter nicht erforderlich.
String
card_upgrade_annual_fee
Gibt den Dollarbetrag der jährlichen Gebühr an, die für die Kartenaktualisierung erforderlich ist, z. B. 150. Wenn „card_upgrade“ false ist, ist dieser Parameter nicht erforderlich.
Zahl
card_upgrade_benefit
Gibt den Dollarbetrag der Vorteile an, die für das Kartenupgrade verfügbar sind, z. B. 450. Wenn „card_upgrade“ false ist, ist dieser Parameter nicht erforderlich.
Zahl
reissue_status
Gibt an, ob für diese Karte eine neue Karte ausgestellt wurde.
boolean
dispatch_status
Gibt an, ob die neu ausgestellte Karte an die registrierte Adresse versandt wurde. Wenn „reissue_status“ false ist, muss „dispatch_status“ false sein.
boolean
card_estimated_duration
Geschätzte Lieferzeit für die neue Karte, z. B. „2 days“ oder „24 hours“. Wenn „reissue_status“ false ist, ist dieser Parameter nicht erforderlich.
String

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Karten prüfen“ für diese Komponente aufzurufen.
Karte sperren
Der prebuilt_components_lost_and_stolen_card:lock_card_ticket_number-Webhook wird von der Komponente verwendet, um eine Anfrage zum Sperren einer ausgewählten Karte zu erstellen.
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
$session.params.last_four_digit_of_card_number
Die letzten vier Ziffern der Kartennummer, die der Nutzer sperren lassen möchte.
String
$flow.lock_type
Gibt an, welche Sperre auf die Karte des Nutzers angewendet werden soll. Diese Komponente unterstützt standardmäßig dauerhafte Sperrungen für verlorene und gestohlene Karten. Gültige Sperrtypen werden durch die Parameter $flow.card_status_active, $flow.card_status_lock_temp und $flow.card_status_lock_permanent angegeben. Siehe Eingabeparameter.
String
$flow.lock_reason
Gibt an, warum der Nutzer die Sperrung der Karte beantragt hat. Gültige Werte werden durch das benutzerdefinierte Element prebuilt_components_lost_and_stolen_lock_reason definiert. Standardmäßig werden „damaged“, „stolen“, „lost“ und „others“ unterstützt.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
ticket_number
Die Ticketnummer für die erstellte Anfrage zur Sperrung einer Karte.
integer

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks für die Sperrung von Karten für diese Komponente aufzurufen.
Karte neu ausstellen
Mit dem prebuilt_components_lost_and_stolen_card:reissue_card_number-Webhook wird von der Komponente eine Anfrage zum Neuausstellen einer neuen oder aktualisierten Karte erstellt.
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
$session.params.last_four_digit_of_card_number
Die letzten vier Ziffern der Kartennummer, die der Nutzer sperren lassen möchte.
String
zip_code
Die Postleitzahl, die mit dem Konto des Nutzers verknüpft ist.
String
card_upgrade
Gibt an, ob der Nutzer ein Upgrade für seine Karte ausgewählt hat.
boolean
card_upgrade_type
Gibt die vom Nutzer ausgewählte Art des Kartenupgrades an, z. B. „gold“ oder „platinum“. Wenn „card_upgrade“ false ist, ist dieser Parameter nicht erforderlich.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
acknowledgement_number
Die Ticketnummer für die erstellte Anfrage zur Neuausstellung einer Karte.
integer

Wenn Sie den Webhook „Karte neu ausstellen“ für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt und folgen Sie der Anleitung.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Migration des Sprachmodells für „phone_call“ im 2. Quartal 2024
bookmark_border
Versionshinweise
Migrationsstatus
Stand Juli 2024 ist die automatische Migration für die folgende Kombination von Einstellungen abgeschlossen, die der zweiten Zeile in der Migrationstabelle entspricht:
Aktuelle model-ID
Aktuell model_variant
Aktuelle single_utterance-Einstellung *
Modell-ID, auf die der Traffic geleitet wird
phone_call
Sonstiges (nicht USE_STANDARD)
false
telephony

*
Wenn für Ihren Konversations-Agenten (Dialogflow CX) die erweiterte Timeout-basierte Empfindlichkeit für das Ende der Spracheingabe aktiviert ist, wird die Modell-ID unter der Annahme weitergeleitet, dass single_utterance false ist, auch wenn die Einstellung zur Laufzeit auf true festgelegt ist.

Bei anderen Kombinationen von Einstellungen wird die automatische Migration bis auf Weiteres ausgesetzt (kein geschätzter Termin).
Sie können die Modell-ID phone_call weiterhin verwenden. Wir empfehlen Ihnen jedoch, Konformer-basierte Sprachmodelle zu aktivieren.
Übersicht über die Migration
Bei bestimmten Kombinationen von Sprach-Tag und Spracheinstellung werden die Anfragen von Conversational Agents (Dialogflow CX) und Dialogflow ES mit Audio nach und nach nicht mehr an das klassische Speech-to-Text-Modell mit der Modell-ID phone_call, sondern an die neuen conformerbasierten Sprachmodelle weitergeleitet. Da die Weiterleitung nur intern erfolgt, bleiben die aktuellen Modell-IDs und der Code gültig und es werden weiterhin Zugriffe erzielt.
Die betroffenen Sprach-Tags sind: en-au, en-gb, de, de-de, es, es-es, es-us, fr, fr-ca, fr-fr, it, it-it, ja, pt-br.
In der folgenden Tabelle sehen Sie, wie die Weiterleitung des Speech-to-Text-phone_call-Modells nach der Migration erfolgt. Wenn Ihre Konfiguration mit dem Sprach-Tag und den ersten drei Spalten in der Tabelle übereinstimmt, wird die neue Modell-ID in der vierten Spalte aufgeführt.
Aktuelle model-ID
Aktuell model_variant
Aktuelle single_utterance-Einstellung *
Modell-ID, an die der Traffic weitergeleitet wird
phone_call
USE_STANDARD
false
latest_long
phone_call
Sonstiges (nicht USE_STANDARD)
false
telephony
phone_call
Beliebig
true
latest_short

*
Wenn für Ihren Konversations-Agenten (Dialogflow CX) die erweiterte Timeout-basierte Empfindlichkeit für das Ende der Spracheingabe aktiviert ist, wird die Modell-ID unter der Annahme weitergeleitet, dass single_utterance false ist, auch wenn die Einstellung zur Laufzeit auf true festgelegt ist.

Migrationsoptionen
Es gibt drei Migrationsoptionen: vorzeitige Aktivierung, automatische Migration und vorübergehende Deaktivierung.
Funktion aktivieren und früher migrieren
Wenn Sie die Funktion proaktiv aktivieren möchten, ändern Sie die Sprachmodell-ID, die Sie in der Conversational Agents (Dialogflow CX) API und der Dialogflow ES API verwendet haben, in die aktualisierte ID. Bei Conversational Agents (Dialogflow CX) können Sie die Modell-ID auch in der Konsole für Conversational Agents (Dialogflow CX) in den Erweiterten Spracheinstellungen unter Sprach- und IVR-Einstellungen ändern.
Das in der API zur Laufzeit angegebene Sprachmodell hat Vorrang vor dem in der Konsole für Conversational Agents (Dialogflow CX) angegebenen Sprachmodell, es sei denn, Sie aktivieren die Einstellung Sprachmodell auf Anfrageebene überschreiben. Weitere Informationen zur Priorität in Sprachmodellen
Bei Partner-Telefonieintegrationen erkundigen Sie sich bei Ihrem Telefonanbieter, ob das Sprachmodell in der API festgelegt wird. Wenn Sie das Phone Gateway für Conversational Agents (Dialogflow CX) verwenden, lesen Sie die Einschränkungen des Sprachmodells.
Wenn Sie Ihr Projekt proaktiv migrieren, haben Sie Zeit, die Modelle zu testen und die Vorteile der verbesserten Genauigkeit und Robustheit früher zu nutzen. Für die meisten Integrationen ist single_utterance = true erforderlich. Wenn Sie also keine erweiterte Timeout-basierte Empfindlichkeit für das Ende der Sprache verwenden, sollten Sie latest_short verwenden.
Wenn Probleme mit den neuen Modellen auftreten, erstellen Sie bitte eine Google Cloud Supportanfrage mit den Details zum Problem.
Automatisch migrieren
Hinweis: Weitere Informationen finden Sie unter Migrationsstatus.
Sie müssen nichts weiter tun, damit die Migration automatisch erfolgt. Die vorhandenen IDs für Spracherkennungsmodelle sind gültig und wir werden die Zugriffe intern umverteilen.
Deaktivierung und spätere Migration
Aufgrund des ausgesetzten Migrationsstatus werden keine neuen Deaktivierungsanfragen akzeptiert. Wenn Sie die Funktion für Ihre Projekte vor Juli 2024 deaktiviert haben, bleibt der Status so, bis wir weitere Informationen dazu bekannt geben.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vordefinierte Komponente „Angebote“
bookmark_border
Versionshinweise
Die vorgefertigte 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 bereitstellen. Außerdem können Nutzer Details zu allgemeinen Angeboten und Deals abrufen oder Probleme mit einem bestimmten Gutscheincode melden. In dieser Komponente wird die vorgefertigte Komponente Alphanumerische Sammlung verwendet, 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
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.
Nutzerspezifische und allgemeine Angebote
Der Endnutzer wurde bereits authentifiziert. Der Nutzer fragt nach seinen neuesten Angeboten und der Kundenservicemitarbeiter präsentiert ihm eine Liste mit Angeboten, die speziell für ihn gelten. Der Nutzer stellt einige Fragen zu den Angeboten und bittet dann um Angebote in einer bestimmten Kategorie. Der Kundenservicemitarbeiter präsentiert die Liste der Angebote in der Kategorie. Der Kundenservicemitarbeiter bietet an, die Angebotsdetails an den Nutzer zu senden, der dies jedoch ablehnt.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Herzlich willkommen! Möchtest du unsere neuesten Angebote kennenlernen oder hast du Probleme mit einem bestimmten Gutscheincode?
Ich möchte die neuesten Angebote sehen

Sie suchen nach Angeboten. Ist das richtig?
Ja

Wir haben die folgenden Angebote für Sie gefunden:
Angebot 1: 5% Rabatt auf Bekleidung mit dem Code APPARELS5, gültig bis 28. März 2024.
Angebot 2: 15% Rabatt auf Lebensmittel mit dem Code GROCERY500, gültig bis 28. März 2024.

Wir hoffen, dass Ihnen diese Angebote gefallen. Haben Sie Fragen zu Angeboten, die wir für Sie beantworten können?
Gibt es für das Angebot für Lebensmittel einen Mindestbestellwert?

Ja, für 15% Rabatt auf Lebensmittel ist ein Mindestbestellwert von 10 € erforderlich. Das Angebot kann mit dem Code GROCERY500 eingelöst werden und ist bis zum 28. März 2024 gültig.

Wir hoffen, Ihnen die gewünschten Informationen zukommen lassen zu können. Haben Sie Fragen zu Angeboten, die wir für Sie beantworten können?
Haben Sie Angebote für Elektronik?

Natürlich! Hier sind die Angebotsdetails:
Angebot 1: 5% Rabatt auf Elektronik mit dem Code ELECTRIC5, gültig bis 28. März 2024.
Angebot 2: 15% Rabatt auf Elektronik mit dem Code ELECTRIC15, gültig bis 28. März 2024.

Wir hoffen, dass wir Ihnen die gewünschten Informationen zukommen lassen konnten. Haben Sie Fragen zu Angeboten, die wir für Sie beantworten können?
Nein, ich bin fertig.

Sollen Angebotsdetails an Ihre registrierte Mobiltelefonnummer oder E-Mail-Adresse gesendet 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 Kundenservicemitarbeiter erfasst den Gutscheincode und gibt dem Nutzer Details zur Einlösung des Gutscheincodes. Der Nutzer bestätigt, dass er ein Problem mit dem Gutscheincode hat, und der Kundenservicemitarbeiter sendet ein Ticket, um das Problem zu melden.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Herzlich willkommen! Möchtest du unsere neuesten Angebote kennenlernen oder hast du Probleme mit einem bestimmten Gutscheincode?
Ich habe Probleme mit einem Gutscheincode

Sie suchen nach Gutscheincodes. Ist das richtig?
Ja

Wir bedauern, dass Ihre Erwartungen nicht erfüllt wurden. Können Sie mir bitte den Gutscheincode nennen, den Sie verwenden?

Der Kundenservicemitarbeiter erfasst den Gutscheincode mithilfe der vordefinierten Komponente Alphanumerische Sammlung.

Der Angebotscode APPARELS5 für Bekleidung erfordert einen Mindestbestellwert von 100$ und ist bis zum 28. März 2024 gültig. Achten Sie darauf, dass die Bedingungen wie der Mindestbestellwert erfüllt sind.

Sind diese Informationen hilfreich für Sie?
no

Bitte geben Sie das Problem an, das aufgetreten ist. Du könntest beispielsweise sagen: „Mein Gutscheincode funktioniert nicht.“
Gutscheincode funktioniert nicht

Zur Bestätigung: Das angegebene Gutscheincode-Problem besteht darin, dass der Gutscheincode nicht funktioniert. Ist das richtig?
Ja

Wir haben ein Ticket erstellt, um Ihr Problem zu melden. Vielen Dank für Ihren Anruf.

Namenskonventionen
Für diese vorgefertigte 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
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

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_concern_type
Gibt die Anzahl der zulässigen Wiederholungen an, wenn der Nutzer auswählt, ob er Angebote erhalten oder ein Problem mit einem Gutscheincode melden möchte. Der Standardwert ist 2.
integer
$flow.max_retry_offers_category
Gibt die zulässige Anzahl von Wiederholungsversuchen 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 Wiederholungen an, wenn der Gutscheincode angegeben wird, 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 Wiederholungen an, wenn das Problem mit einem Gutscheincode angegeben wird. Der Standardwert ist 2.
integer
$flow.max_retry_message_confirm_channel
Gibt die zulässige Anzahl von Wiederholungsversuchen an, wenn ein Kanal angegeben wird, über den Angebotsdetails empfangen werden sollen. 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, das 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, das vom get_coupon_code_details-Webhook zurückgegeben wird und angibt, dass der Gutscheincode abgelaufen ist. Der Standardwert ist „expired“.
String

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.
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
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: Bei der Unterhaltung wurde 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: Es ist ein Webhook-Fehler 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.
Zusammenfassung
Mit dem Summarization-Generator wird eine Zusammenfassung nach dem Anruf generiert, die die von der Komponente verarbeitete Unterhaltung beschreibt.
Allgemeine FAQ
Der General FAQ-Generator wird verwendet, um häufig gestellte Fragen zu Rabatten, Angeboten, Käufen und Treuepunkteprogrammen zu beantworten.
Kann ich Sonderangebotsprodukte zurückgeben, wenn ich meine Meinung ändere?
Erhalte ich beim Kauf bestimmter Produkte kostenlose Proben oder Geschenke?
Bieten Sie Preisanpassungen an, wenn der gekaufte Artikel später im Angebot ist?
Gibt es eine Frist für das Einlösen von Prämien im Treuepunkteprogramm?
Nutzerspezifische Angebotsdetails
Der User-specific offer details-Generator wird verwendet, um anhand der Informationen aus dem get_offers_details-Webhook Details zu nutzerspezifischen Angeboten bereitzustellen.
Details zu Angeboten
Mit dem Offers and deals details-Generator werden Details zu allgemeinen Angeboten und Deals anhand der Informationen aus dem get_offers_details-Webhook bereitgestellt. Der Nutzer kann nach Angeboten in einer bestimmten Kategorie fragen oder weitere Informationen zu bestimmten Angeboten anfordern.
Häufig gestellte Fragen zu Angeboten
Der Offers and deals FAQ-Generator wird verwendet, um häufig gestellte Fragen zu Angeboten zu beantworten.
Gibt es spezielle Angebote für Neukunden?
Wie kann ich über anstehende Angebote informiert werden?
Gibt es Angebote, die nur im Geschäft oder online erhältlich sind?
Wie oft werden Ihrer Plattform neue Angebote hinzugefügt?
Häufig gestellte Fragen zu Rabatten und Gutscheincodes
Die Discount and promo code FAQ wird verwendet, um häufig gestellte Fragen zu Rabatten und Gutscheincodes zu beantworten.
Kann ich einen Rabattcode mehrmals verwenden?
Kann ich mehrere Rabatte auf eine einzelne Bestellung anwenden?
Wie kann ich einen Rabattcode an der Kasse einlösen?
Was passiert, wenn ich beim Bezahlvorgang vergessen habe, einen Rabattcode anzuwenden?
Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
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.
Angebotsdetails abrufen
Über den prebuilt_components_offers_and_deals:get_offers_details-Webhook ruft die Komponente Details zu nutzerspezifischen und allgemeinen Angeboten ab.
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 und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
active_category
Liste der Angebotskategorien, die für den Nutzer verfügbar sind. Gültige Werte werden durch das prebuilt_components_offers_and_deals_category-Element definiert.
Liste (String)
user_email
Die für das angegebene Konto registrierte E-Mail-Adresse, über die Angebotsdetails gesendet werden.
String
user_offer
Liste der nutzerspezifischen Angebotsdetails. Jedes Element der Liste steht für ein einzelnes Angebot. Schlüssel/Wert-Paare beschreiben verschiedene Attribute des Angebots, 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 steht für ein einzelnes Angebot und entspricht dem Format des Felds user_offer.
Liste (Objekt)

Maximieren Sie die Seite, um eine Anleitung zum Konfigurieren des Webhooks „Get offers details“ für diese Komponente aufzurufen.
Gutscheincode-Details abrufen
Über den prebuilt_components_offers_and_deals:get_coupon_code_details-Webhook ruft die Komponente Details zu einem bestimmten Gutscheincode ab, für den 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
Die mit dem Konto des Nutzers verknüpfte Telefonnummer.
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 das prebuilt_components_offers_and_deals_category-Element 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 die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Get coupon code details“ für diese Komponente aufzurufen.
Nachricht senden
Über den prebuilt_components_offers_and_deals:send_message-Webhook sendet die Komponente eine Nachricht mit Angebotsdetails an den ausgewählten Kanal des Nutzers.
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.confirmation_channel
Kanal, über den der Nutzer Angebotsdetails erhalten möchte. Gültige Werte werden durch das prebuilt_components_channel_email_phone-Element definiert.
String

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Nachricht senden“ für diese Komponente aufzurufen.
Ticket erstellen
Der prebuilt_components_offers_and_deals:raise_ticket-Webhook wird von der Komponente verwendet, um ein Ticket mit einem Gutscheincode zu senden, in dem ein Nutzerproblem 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 Ortstelefonnummer des Nutzers ohne Landesvorwahl, 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 diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks zum Erstellen von Tickets für diese Komponente aufzurufen.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vorgefertigte Komponente zurückgeben und erstatten
bookmark_border
Versionshinweise
Die vorgefertigte Komponente für Rückgaben und Erstattungen 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 zurückgeben und Optionen wie Erstattungs- und Rückgabemethoden 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.
Rückgabe im Geschäft für ein einzelnes Produkt
Der Endnutzer wurde bereits authentifiziert. Der Kundenservicemitarbeiter bestätigt, welche Artikel aus der letzten Bestellung zurückgegeben werden sollen, und erfragt den Grund für die Rückgabe. Der Nutzer entscheidet sich, die Artikel in einem Geschäft zurückzugeben, 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 Nummer, die auf 12345 endet und zwei Lampen enthält, die am 10. 11. 2023 aufgegeben wurde?
Ja

Sie möchten die Google-Lampe zurückgeben. 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 zurückgeben möchten.
zwei

Geben Sie den Grund für die Rückgabe an. Sie können beispielsweise sagen, dass der Artikel defekt oder nicht funktionsfähig ist, nicht mehr benötigt wird, ein Problem mit der Größe oder Passform vorliegt, der falsche Artikel gesendet wurde, der Artikel zu spät geliefert wurde oder dass Sie ihn versehentlich gekauft haben.
andere

Geben Sie bitte den Grund für die Rückgabe an.
schlechte Qualität

Prüfen, ob der Grund für die Rückgabe die schlechte Qualität ist. Ist das richtig?
Ja

Bitte teilen Sie uns mit, wo Sie die Erstattung erhalten möchten. Sie können beispielsweise „Guthaben“ oder „Quellkonto“ sagen.
Quellkonto

Vielen Dank, dass Sie bestätigt haben, dass die Erstattung auf die ursprüngliche Zahlungsmethode erfolgen soll.

Wie möchten Sie das Produkt zurückgeben? Sie können z. B. „Im Geschäft zurückgeben“, „An einem Ort abgeben“ oder „Abholung planen“ sagen.
Rückgabe im Geschäft

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.
1

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 ihn aus, befestigen Sie ihn an Ihrem Paket und geben Sie die Rücksendung innerhalb von 30 Tagen ab.
Nachdem wir den Artikel in unserem Lager erhalten haben, dauert es drei bis fünf Arbeitstage, bis die Erstattung auf Ihrem Konto angezeigt wird. Hinweis: Die Versand- und Bearbeitungskosten sind in der Erstattung nicht enthalten.
Vielen Dank für Ihren Anruf.

Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Rückgabe und Erstattung
Entitätstyp
prebuilt_components_[component_name][entity_type] prebuilt_components_return_refund_mode_of_return Webhook prebuilt_components[component_name]:[webhook_action]
prebuilt_components_return_refund:post_return_details

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_counter
Gibt die Anzahl der zulässigen Wiederholungen an, wenn Sie auswählen, ob Sie mit einem alternativen Konto fortfahren möchten. Der Standardwert ist 2.
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 eine andere Bestellung für die Rückgabe ausgewählt werden darf, wenn die Bestell-ID nicht gefunden wird oder die Bestellung nicht zurückgegeben werden kann. 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, in Fällen, in denen mehrere Bestellungen dieselben letzten fünf Ziffern haben. Der Standardwert ist 2.
integer
$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_retry_product_number_counter
Gibt die maximale Anzahl der zulässigen Wiederholungen an, wenn ein Produkt zur Rückgabe ausgewählt wird. Der Standardwert ist 2.
integer
$flow.max_product_return_confirm_counter
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_return_reason_counter
Gibt die zulässige Anzahl von Wiederholungsversuchen an, wenn der Grund für die Rückgabe bestätigt wird. Der Standardwert ist 2.
integer
$flow.order_product_return_reason_others
Gibt den Wert der Entität prebuilt_components_return_refund_reason an, der angibt, dass der Nutzer „Sonstiges“ als Rückgabegrund ausgewählt hat. Der Standardwert ist „others“.
String
$flow.max_retry_select_quantity
Gibt die maximale Anzahl der zulässigen Wiederholungen an, wenn die Menge des zurückzugebenden Produkts ausgewählt wird. 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 Geschäftsauswahl an. Der Standardwert ist 2.
integer
$flow.max_retry_another_zip_code
Gibt die maximale Anzahl von Wiederholungsversuchen an, die beim Angeben einer Postleitzahl zulässig sind. 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_return_refund_mode_of_refund-Entität an, der angibt, dass der Nutzer die Erstattung auf sein Quellkonto ausgewählt hat. Der Standardwert ist source_account.
String
$flow.order_return_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 die Rückgabe zu planen. Der Standardwert ist scheduled_for_pickup.
String

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.
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: Bei der Unterhaltung wurde 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: Es ist ein Webhook-Fehler 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 sind unterschiedlich. 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 Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
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_return_refund: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
returnable_product_id
Liste der Produkt-IDs für rücknehmbare Produkte in der Bestellung.
Liste (String)
returnable_product_name
Liste der Produktnamen für rücknehmbare Produkte in der Bestellung.
Liste (String)
returnable_product_brand_name
Liste der Markennamen für rücknehmbare Produkte in der Bestellung.
Liste (String)
returnable_product_quantity
Liste der Stückzahlen für rücknehmbare 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.
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.
Geschäftsdetails abrufen
Über den prebuilt_components_return_refund: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.
Rücksendedetails posten
Der prebuilt_components_return_refund:post_return_details-Webhook wird von der Komponente verwendet, um eine Rückgabe 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.return_product_id_list
Liste der Produkt-IDs, die der Nutzer zurückgeben möchte.
Liste (String)
$flow.return_product_quantity_list
Liste der Produktmengen, die der Nutzer zurückgeben möchte, die den einzelnen Elementen in $flow.return_product_id_list entsprechen.
Liste (String)
$flow.return_reason_list
Liste der Rückgabegründe für jedes zurückgegebene Produkt, die den einzelnen Elementen in $flow.return_product_id_list entspricht.
Liste (String)
$flow.order_return_location
Der für die Rückgabe ausgewählte Modus. Gültige Werte werden durch das prebuilt_components_exchange_order_location-Element definiert.
String
$flow.order_return_store_id
Die Geschäfts-ID des Geschäfts, das der Nutzer für eine Rückgabe im Geschäft ausgewählt hat.
String
$flow.order_refund_mode
Die Zahlungsart für die Erstattung. Gültige Werte werden durch das prebuilt_components_return_refund_mode_of_return-Element definiert. Wenn keine Erstattung erforderlich ist, ist dieser Wert null.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
order_return_ticket_id
Ticket-ID für die eingereichte Rücksendung.
String

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Post return details“ für diese Komponente aufzurufen.
Informationen zur Erstattung bei Zahlung per Nachnahme senden
Über den prebuilt_components_return_refund:send_COD_refund_information-Webhook sendet die Komponente rückgabebezogene 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.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vordefinierte Komponente für die Postleitzahlenerhebung
bookmark_border
Mit dieser vordefinierten Komponente werden fünfstellige Postleitzahlen erfasst.
Beschränkungen
Zusätzlich zu den allgemeinen Einschränkungen für vordefinierte Komponenten gelten für diese vordefinierte Komponente die folgenden Einschränkungen:
Postleitzahlen mit mehr als fünf Ziffern werden nicht akzeptiert.
Alphanumerische Postleitzahlen werden nicht akzeptiert.
Empfohlene Einstellungen für Kundenservicemitarbeiter
Aktivieren Sie DTMF, damit Nutzer numerische Werte über die Telefontastatur eingeben können.
Zusätzliche Funktionen
Diese vorgefertigte Komponente bietet die folgenden zusätzlichen Funktionen:
Wiederholen
Wartezimmer
Wiedergabe
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.
Gültige Postleitzahl
Der Endnutzer gibt eine fünfstellige Postleitzahl an, die der Kundenservicemitarbeiter erfolgreich erfasst.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Nennen oder geben Sie die fünfstellige Postleitzahl ein.
27656

Sie haben die Postleitzahl 27656 genannt. Ist das richtig?
Ja

Sehr gut. Ich habe die Postleitzahl erfasst.

Wiederholen
Der Endnutzer gibt im zweiten Versuch eine fünfstellige Postleitzahl an, die der Kundenservicemitarbeiter akzeptiert.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Nennen oder geben Sie die fünfstellige Postleitzahl ein.
27656

Sie haben die Postleitzahl 27657 genannt. Ist das richtig?
no

Tut mir leid, ich habe das nicht richtig verstanden.
Bitte nennen oder geben Sie die fünfstellige Postleitzahl ein.
27656

Sie haben die Postleitzahl 27656 genannt. Ist das richtig?
Ja

Sehr gut. Ich habe die Postleitzahl erfasst.

Ungültige Postleitzahl
Der Endnutzer gibt eine ungültige Postleitzahl an, die mehr als fünf Ziffern lang ist. Der Kundenservicemitarbeiter bittet ihn noch einmal, die korrekte Postleitzahl anzugeben, und erfasst sie dann.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Nennen oder geben Sie die fünfstellige Postleitzahl ein.
276566

Ich habe 123456 gehört. Das ist keine gültige fünfstellige Postleitzahl.
Bitte nennen oder geben Sie die fünfstellige Postleitzahl ein.
27656

Sie haben die Postleitzahl 27656 genannt. Ist das richtig?
Ja

Sehr gut. Ich habe die Postleitzahl erfasst.

Unbekannte Eingabe
Die Komponente beendet den Ablauf, nachdem der Endnutzer dreimal eine nicht erkannte Eingabe gemacht hat.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Nennen oder geben Sie die fünfstellige Postleitzahl ein.
Alles in Ordnung

Das habe ich nicht verstanden. Können Sie die fünfstellige Postleitzahl noch einmal sagen oder eingeben?
Gut

Hm, das habe ich immer noch nicht verstanden. Geben Sie bitte die fünfstellige Postleitzahl an. Sie können die Postleitzahl auch über die Tastatur eingeben.
Sehr gut

Ich habe Ihre Antwort leider nicht verstanden.

Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Postleitzahlerhebung
Komponentenspezifischer Intent
prebuilt_components_[component_name]_[intent_name]
prebuilt_components_zip_code_collection_collect_zip_code
Parameter
[param_name]
zip_code

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
zip_code_collection_zip_code
Dieser Parameter gibt die Postleitzahl zurück, die im Konversationsablauf erfasst wurde.
String

Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
Abgeschlossen
Ihr Agent sollte jetzt eingerichtet und bereit zum Testen sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vordefinierte Komponente für Kreditkartenabrechnungen
bookmark_border
Versionshinweise
Die vorgefertigte Komponente für Kreditkartenabrechnungen prüft die Authentifizierungsstufe eines Kunden und sendet die Kreditkartenabrechnung dann für einen bestimmten Zeitraum an einen authentifizierten Kunden. Wenn der Kunde mehrere Kreditkarten hat, bestätigt die Komponente die jeweilige Karte, für die der Kunde eine Kreditkartenabrechnung abrufen möchte. Diese Komponente verwendet eine benutzerdefinierte Version der vordefinierten Komponente Authentifizierung, um Karteninhaber zu authentifizieren, und eine benutzerdefinierte Version der Datenerfassung für das Geburtsdatum, um Start- und Enddatum für den Abrechnungszeitraum zu erfassen.
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.
Einzelne Kreditkarte
Der Endnutzer hat eine einzige Kreditkarte. Der Kundenservicemitarbeiter erfragt das Start- und Enddatum der Abrechnung, ob der Nutzer die Abrechnung verschlüsseln möchte, und sendet die Kreditkartenabrechnung an den Nutzer.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Der Kundenservicemitarbeiter authentifiziert den Nutzer mit der vordefinierten Komponente Authentication

Vielen Dank. Sie wurden erfolgreich authentifiziert.

Bitte warten Sie, während wir Ihre Kartendetails abrufen.

Wir haben eine Kartennummer gefunden, die auf 1002 endet und mit Ihrer Nummer verknüpft ist.

Geben Sie das Startdatum des Kreditkartenabzugs an, beginnend mit dem Monat, gefolgt vom Tag und dann dem Jahr. Die Kreditkartenabrechnung wird nur für die letzten 180 Tage zur Verfügung gestellt.

Kundenservicemitarbeiter erfasst das Startdatum der Abrechnung mithilfe der vorgefertigten Komponente Geburtsdatum

Super, wir haben das Startdatum Ihrer Kreditkartenabrechnung erfasst.

Geben Sie das Enddatum der Kreditkartenabrechnung an, beginnend mit dem Monat, gefolgt vom Tag und dann dem Jahr. Die Kreditkartenabrechnung wird nur für die letzten 180 Tage zur Verfügung gestellt.

Kundenservicemitarbeiter erfasst das Enddatum der Abrechnung mithilfe der vorgefertigten Komponente Geburtsdatum

Sehr gut. Wir haben das Enddatum Ihrer Kreditkartenabrechnung erfasst.

Vielen Dank. Bitte bestätigen Sie, dass Sie die Abrechnung vom 01.06.2023 bis zum 30.06.2023 benötigen.
Ja

Bitte warten Sie, während wir Ihre Kontoabrechnung abrufen.

Wir haben Transaktionen zwischen dem 01.06.2023 und dem 30.06.2023 gefunden. Möchten Sie sie per E-Mail, SMS oder WhatsApp erhalten?
An meine E-Mail-Adresse senden

Möchten Sie das Dokument verschlüsseln, bevor wir es für Sie freigeben?
Nein danke

Sie erhalten den Kontoauszug innerhalb von 15 Minuten an Ihre registrierte E-Mail-Adresse.

Mehrere Kreditkarten
Der Endnutzer hat mehrere Kreditkarten. Der Kundenservicemitarbeiter bestätigt, für welche Karte der Nutzer eine Kreditkartenabrechnung anfordert. Der Kundenservicemitarbeiter erfragt das Start- und Enddatum der Abrechnung, ob der Nutzer die Abrechnung verschlüsseln möchte, und sendet die Kreditkartenabrechnung an den Nutzer.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Der Kundenservicemitarbeiter authentifiziert den Nutzer mit der vordefinierten Komponente Authentication

Vielen Dank. Ihre Bestätigung war erfolgreich.

Bitte warten Sie, während wir Ihre Kartendetails abrufen.

Wir haben festgestellt, dass mit Ihrer Nummer zwei Karten verknüpft sind. Wie lauten die letzten vier Ziffern der Karte, um die es hier geht?
1122

Die letzten vier Ziffern der Kartennummer, die wir erhalten haben, lauten 1122. Ist das richtig?
Ja

Geben Sie das Startdatum des Kreditkartenabzugs an, beginnend mit dem Monat, gefolgt vom Tag und dann dem Jahr. Die Kreditkartenabrechnung wird nur für die letzten 180 Tage zur Verfügung gestellt.

Kundenservicemitarbeiter erfasst das Startdatum der Abrechnung mithilfe der vorgefertigten Komponente Geburtsdatum

Super, wir haben das Startdatum Ihrer Kreditkartenabrechnung erfasst.

Geben Sie das Enddatum der Kreditkartenabrechnung an, beginnend mit dem Monat, gefolgt vom Tag und dann dem Jahr. Die Kreditkartenabrechnung wird nur für die letzten 180 Tage zur Verfügung gestellt.

Kundenservicemitarbeiter erfasst das Enddatum der Abrechnung mithilfe der vordefinierten Komponente Geburtsdatum

Sehr gut. Wir haben das Enddatum Ihrer Kreditkartenabrechnung erfasst.

Vielen Dank. Geht es um die Abrechnung vom 13.07.2023 bis zum 14.07.2023?
Ja

Bitte warten Sie, während wir die Details Ihrer Kontoabrechnung abrufen.

Wir haben Transaktionen vom 13.07.2023 bis zum 14.07.2023 gefunden. Möchten Sie sie per E-Mail, SMS oder WhatsApp erhalten?
SMS

Möchten Sie das Dokument verschlüsseln, bevor wir es für Sie freigeben?
Ja

Die Passwortdetails werden an Ihr registriertes Mobiltelefon gesendet.

Sie erhalten den Kontoauszug innerhalb von 15 Minuten auf Ihr registriertes Mobiltelefon.

Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Kreditkartenabrechnung
Entitätstyp
prebuilt_components_[component_name][entity_type] prebuilt_components_statement_channel_all Webhook prebuilt_components[component_name]:[webhook_action]
prebuilt_components_credit_card_statement:request_statement

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 Ablaufebene müssen wie unten beschrieben 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.auth_level
(Optional) Gibt die Authentifizierungsebene des Aufrufers an.
integer
$session.params.auth_level_req
Gibt die Authentifizierungsstufe an, die erforderlich ist, damit ein Nutzer auf seine Kreditkartenabrechnung zugreifen kann. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert 1.
integer
$session.params.account_auth_enabled
Gibt an, ob der Nutzer wie unter Authentifizierungsebenen beschrieben als Kontoinhaber authentifiziert werden soll. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert false.
boolean
$session.params.card_auth_enabled
Gibt an, ob der Nutzer wie unter Authentifizierungsebenen beschrieben als Karteninhaber authentifiziert werden soll. Dieser Wert wird in den Parametervoreinstellungen der Auftragsausführung für Seiteneinträge auf der Seite check auth level konfiguriert. Standardmäßig ist dieser Wert true.
boolean
$session.params.phone_number
(Optional) Die registrierte Telefonnummer des Kunden, die für die Authentifizierung verwendet wird.
String
$session.params.credit_card_count
(Optional) Anzahl der Kreditkarten, die mit dem authentifizierten Nutzer verknüpft sind.
integer
$session.params.last_four_digit_of_card_number
(Optional) Die letzten vier Ziffern der Kundenkartennummer, für die die Kontoabrechnung erforderlich ist. Wenn der Kunde nur eine Karte hat, werden diese Informationen nach der Authentifizierung automatisch abgerufen. Wenn der Kunde mehrere Karten hat, wird die jeweilige Kartennummer vom Kunden erfasst.
String
$session.params.credit_card_statement_max_days
Gibt die maximale Anzahl von Tagen vor dem aktuellen Datum an, die für ein Startdatum der Abrechnung zulässig ist. Standardmäßig ist dieser Wert -180. Das bedeutet, dass das Startdatum der Abrechnung maximal 180 Tage vor dem aktuellen Datum liegen darf. Dieser Parameter wird in der Startseitenroute true konfiguriert.
integer
$flow.max_retry_count
Gibt an, wie oft der Endnutzer aufgefordert werden darf, ein gültiges Enddatum für die Kontoabrechnung anzugeben. Der Standardwert ist 3.
integer

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.
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
auth_level
Gibt die Authentifizierungsstufe des Anrufers an.
integer
phone_number
Die Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.
String
credit_card_count
Die Anzahl der Kreditkarten, die mit der registrierten Telefonnummer verknüpft sind.
integer
last_four_digit_of_card_number
Wenn ein Nutzer nur eine Karte hat, werden die letzten vier Ziffern der Kartennummer zurückgegeben. Wenn ein Nutzer mehr als eine Karte hat, entspricht der Wert dieses Parameters den letzten vier Ziffern der Kartennummer, für die der Nutzer Informationen zur Kreditkartenabrechnung erhalten möchte.
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: Bei der Unterhaltung wurde 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: Es ist ein Webhook-Fehler 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

Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
Konfigurieren Sie die bereitgestellten flexiblen Webhooks mit einer Konfiguration, die Ihre externen Dienste beschreibt. Weitere Informationen finden Sie unten 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 findest du unter Authentifizierungs-Webhook einrichten.
Kreditkartendetails abrufen
Der prebuilt_components_credit_card_statement:credit_card_details-Webhook wird von der Komponente verwendet, um Kreditkartendetails für eine registrierte Telefonnummer 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
Die Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
credit_card_count
Die Anzahl der Kreditkarten, die mit der registrierten Telefonnummer verknüpft sind.
integer
credit_card
Die letzten vier Ziffern der Kreditkartennummer des Kunden. Wenn der Kunde mehrere Karten hat, ist dieser Wert null.
String
E-Mail
Die registrierte E-Mail-Adresse des Nutzers. Wenn für die Telefonnummer keine E-Mail-Adresse registriert ist, ist dieser Wert null.
String

Maximieren Sie die Ansicht, um eine Anleitung zum Konfigurieren des Webhooks „Get credit card details“ (Kreditkartendetails abrufen) für diese Komponente aufzurufen.
Karte bestätigen
Mit dem prebuilt_components_credit_card_statement:validate_date-Webhook wird von der Komponente überprüft, ob eine bestimmte Kreditkarte für eine registrierte Telefonnummer vorhanden 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
$session.params.last_four_digit_of_card_number
Die letzten vier Ziffern der angegebenen Kreditkartennummer des Nutzers.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
valid_card
Gibt an, ob die angegebene Karte für die registrierte Telefonnummer gefunden wurde.
boolean

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Karten prüfen“ für diese Komponente aufzurufen.
Transaktionen abrufen
Die Komponente verwendet den prebuilt_components_credit_card_statement:card_transaction_details-Webhook, um die Transaktionen für eine Karte anhand der registrierten Telefonnummer des Nutzers, der letzten vier Ziffern der Kartennummer und des Abrechnungszeitraums 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
Die Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.
String
$session.params.last_four_digit_of_card_number
Die letzten vier Ziffern der Kartennummer, für die der Nutzer die Zustellung von Kreditkartenabrechnungsinformationen ausgewählt und bestätigt hat.
String
$flow.statement_start_date
Das Startdatum der angeforderten Abrechnung im Format JJJJ-MM-TT.
String
$flow.statement_end_date
Optional: Das Startdatum der angeforderten Abrechnung im Format JJJJ-MM-TT. Wenn der Nutzer keinen Wert angibt oder das Ende nicht angibt, wird standardmäßig das aktuelle Datum verwendet.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
transactions_count
Die Anzahl der Transaktionen, die für die angegebene Kreditkarte im angegebenen Abrechnungszeitraum gefunden wurden.
integer

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Transaktionen abrufen“ für diese Komponente aufzurufen.
Kontoabrechnung anfordern
Über den prebuilt_components_credit_card_statement:request_statement-Webhook sendet die Komponente eine Kreditkartenabrechnung an einen ausgewählten Kanal, sofern die registrierte Telefonnummer des Nutzers, die letzten vier Ziffern der Kreditkartennummer und der Abrechnungszeitraum angegeben sind.
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
$session.params.last_four_digit_of_card_number
Die letzten vier Ziffern der Kartennummer, für die der Nutzer die Zustellung von Kreditkartenabrechnungsinformationen ausgewählt und bestätigt hat.
String
$flow.statement_start_date
Das Startdatum der angeforderten Abrechnung im Format JJJJ-MM-TT.
String
$flow.statement_end_date
Optional: Das Startdatum der angeforderten Abrechnung im Format JJJJ-MM-TT. Wenn der Nutzer keinen Wert angibt oder das Ende nicht angibt, wird standardmäßig das aktuelle Datum verwendet.
String
$flow.channel_medium
Der Kanal, über den der Nutzer die Nachricht erhalten möchte. Gültige Werte werden von den benutzerdefinierten Entitäten prebuilt_components_statement_channel_phone und prebuilt_components_statement_channel_all definiert, je nachdem, ob der Nutzer eine registrierte E-Mail-Adresse hat. Standardmäßig werden email, mobile und WhatsApp unterstützt.
String
$flow.encryption_status
Gibt an, ob das Dokument vor dem Senden an den angegebenen Kanal verschlüsselt werden soll. Wenn der Nutzer keinen Wert angibt oder das Ende nicht angeben möchte, wird standardmäßig true verwendet.
boolean

Wenn Sie den Webhook für die Erklärungsanfrage für diese Komponente konfigurieren möchten, maximieren Sie den Abschnitt.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vorgefertigte Komponente zur Erhebung des CVV einer Kreditkarte
bookmark_border
Die vordefinierte Komponente zum Erfassen der CVV-Zahl (Card Verification Value) einer Kreditkarte erfasst eine drei- oder vierstellige CVV-Zahl.
Beschränkungen
Zusätzlich zu den allgemeinen Einschränkungen für vordefinierte Komponenten gelten für diese vordefinierte Komponente die folgenden Einschränkungen:
Die Integration des Zahlungsgateways ist in dieser Komponente nicht enthalten.
CVVs mit weniger als drei oder mehr als vier Ziffern werden nicht akzeptiert.
Zusätzliche Funktionen
Diese vorgefertigte Komponente bietet die folgenden zusätzlichen Funktionen:
Wiederholen
Wartezimmer
Wiedergabe
Empfohlene Einstellungen für Kundenservicemitarbeiter
Aktivieren Sie DTMF, damit Nutzer numerische Werte über die Telefontastatur eingeben können.
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.
Gültige CVV
Der Endnutzer gibt eine drei- bis vierstellige CVV ein und die Komponente akzeptiert sie.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Bitte geben Sie den drei- oder vierstelligen CVV-Code auf Ihrer Karte ein.
3434

Sie haben angegeben, dass die CVV 3434 lautet. Ist das richtig?
Ja

Sehr gut. Ich habe die CVV erfasst.

Neuversuche
Der Endnutzer gibt im dritten Versuch eine drei- bis vierstellige CVV ein, die von der Komponente akzeptiert wird.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Bitte geben Sie den drei- oder vierstelligen CVV-Code auf Ihrer Karte ein.
45

Ich habe „45“ gehört. Dies ist keine gültige 3- oder 4-stellige CVV-Nummer.

Nennen oder geben Sie die 3- oder 4-stellige CVV-Nummer auf Ihrer Karte ein.
34

Ich habe „34“ gehört. Das ist keine gültige 3- oder 4-stellige CVV-Nummer.

Nennen oder geben Sie die 3- oder 4-stellige CVV-Nummer auf Ihrer Karte ein.
3434

Sie haben angegeben, dass die CVV 3434 lautet. Ist das richtig?
Ja

Sehr gut. Ich habe die CVV erfasst.

Unbekannte Eingabe
Die Komponente beendet den Ablauf, wenn der Endnutzer dreimal eine nicht erkannte Eingabe macht.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Bitte geben Sie den drei- oder vierstelligen CVV-Code auf Ihrer Karte ein.
Alles in Ordnung

Das habe ich nicht verstanden. Können Sie mir bitte noch einmal den drei- oder vierstelligen CVV-Code Ihrer Karte nennen oder eingeben?
Alles in Ordnung

Hm, das habe ich immer noch nicht verstanden. Geben Sie die drei- oder vierstellige CVV-Nummer Ihrer Karte an oder geben Sie sie über die Tastatur ein.
Alles in Ordnung

Ich habe Ihre Antwort leider nicht verstanden.

Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
CVV Collection
Komponentenspezifischer Intent
vordefiniertecomponents[componentname][intent_name]
prebuilt_components_cvv_collect_cvv
Parameter
[param_name]
cvv_code

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
cvv_collection_cvv
Dieser Parameter gibt die CVV zurück, die von der Komponente erfasst wurde.
String

Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
Abgeschlossen
Ihr Agent sollte jetzt eingerichtet und bereit zum Testen sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vorgefertigte Komponente für Betrug und Streitigkeiten im Einzelhandel
bookmark_border
Versionshinweise
Die vordefinierte Komponente für Betrug und Streitigkeiten im Einzelhandel 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 einen Einspruch im Zusammenhang mit einer Bestellung oder einem Produkt einlegen. Diese Komponente verwendet die vorgefertigte Komponente Einzelhandel – Authentifizierung, um Nutzer zu authentifizieren. Die Komponente verwendet auch Generatoren für die Zusammenfassung nach dem Anruf.
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.
Einspruch für einzelnes Produkt
Der Endnutzer wurde noch nicht authentifiziert. Der Kundenservicemitarbeiter erfasst Details zu früheren Bestellungen, um die Identität des Nutzers zu bestätigen. Nachdem der Nutzer authentifiziert wurde, erhebt der Kundenservicemitarbeiter Informationen zur Beschwerde, einschließlich des Grundes für die Beschwerde und des spezifischen Produkts, das der Nutzer anfechten möchte. Nachdem der Kundenservicemitarbeiter die erforderlichen Details erfasst hat, reicht er den Einspruch ein und gibt dem Nutzer die Bestätigungsnummer.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Hallo John, Damit wir Ihre Identität bestätigen können, benötigen wir Ihre Bestell-ID, das Transaktionsdatum und den Betrag, bevor Sie eine Betrugs- oder Beschwerdemeldung einreichen können.

Können Sie mir bitte die letzten fünf Ziffern Ihrer Bestell-ID nennen?
12345

Die letzten fünf Ziffern der Bestell-ID, die wir erhalten haben, lauten 12345. Ist das richtig?
Ja

Super, wir haben jetzt die Bestell-ID.

Geben Sie bitte das Bestelldatum an. Nennen Sie mir den Monat, den Tag und das Jahr Ihrer Bestellung.
2023-10-12

Okay, Ihr Bestelldatum ist der 12. Oktober 2023. Ist das richtig?
Ja

Sehr gut. Wir haben das Bestelldatum erfasst.

Bitte teilen Sie uns den Bestellbetrag in US-Dollar mit. Wenn der Transaktionsbetrag Ihrer Bestellung beispielsweise 100, 30 € betrug, sagen Sie „100“.
97

Okay, der Transaktionsbetrag Ihrer Bestellung beträgt 97 $. Ist das richtig?
Ja

Geben Sie die Art des Betrugs oder der Beschwerde an, die Sie melden möchten. Sie können beispielsweise Folgendes sagen: Zahlungen oder Abrechnung, Produkt, Rückgabe und Erstattung, Bedenken hinsichtlich Datensicherheit oder Datenschutz, Lieferung oder Versand, Verpackung oder „Sonstiges“.
Produkt

Vielen Dank für Ihre Nachricht. Zur Bestätigung: Der Grund für den Betrug oder die Beschwerde ist das Produkt. Ist das richtig?
Ja

Bitte teilen Sie uns mit, ob sich das ausgewählte Problem auf eine gesamte Bestellung, ein einzelnes Produkt oder ein anderes Anliegen bezieht.
Produkt

Geht es um Ihre letzte Bestellung mit der Nummer, die auf 12345 endet, die am 10. 11. 2023 um 18:00 Uhr aufgegeben wurde und zwei Lampen, ein Hemd und ein weiteres Produkt enthält?
Ja

Wir haben einige Produkte in Ihrer Bestellung gefunden. Bitte geben Sie an, welches Produkt Sie melden möchten. Produkt 1: Google-Lampe, Produkt 2: Google-Hemd, Produkt 3: Google-Jeans.

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.
3

Sie möchten einen Betrugs- oder Einspruchsfall für die Google-Jeans einreichen. Ist das richtig?
Ja

Bitte erläutern Sie uns in wenigen Worten den Grund für den Betrug oder den Einspruch.
schlechte Qualität

Der angegebene Grund für Betrug oder Einspruch ist von minderer Qualität. Ist das richtig?
Ja

Vielen Dank für die Bestätigung. Wir haben ein Ticket an unser Team für Betrug oder Anfechtungen gesendet. Sie sollten bald von ihnen hören. Ihre Ticketnummer lautet 6595513.

Möchten Sie die Bestätigungsnummer noch einmal hören?
Ja

Ihre Ticketnummer lautet 6595513.

Möchten Sie, dass wir Ihnen eine Bestätigungsnachricht mit der Ticketnummer senden?
Ja

Sollen Sie die Bestätigungsnachricht an Ihre registrierte Telefonnummer oder E-Mail-Adresse erhalten?
Telefon

Nur zur Bestätigung: Sollen Sie die Bestätigungsnachricht auf Ihrem Smartphone erhalten? Bitte sagen Sie Ja oder Nein.
Ja

Vielen Dank. Eine Bestätigungsnachricht wurde an Ihr registriertes Smartphone gesendet. Das kann einige Zeit dauern.

Möchten Sie ein Betrugs- oder Einspruchsticket für eine andere Bestellung erstellen?
no

Vielen Dank für Ihren Anruf. Unser Team wird sich mit Ihnen in Verbindung setzen.

Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Betrug und Streitigkeiten
Entitätstyp
prebuilt_components_[component_name][entity_type] prebuilt_components_product_dispute_reason Webhook prebuilt_components[component_name]:[webhook_action]
prebuilt_components_fraud_and_dispute_order:get_security_answers

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_counter
Gibt die Anzahl der zulässigen Wiederholungen an, wenn Sie auswählen, ob Sie mit einem alternativen Konto fortfahren möchten. Der Standardwert ist 2.
integer
$flow.max_retry_telephone_number
Gibt die zulässige Anzahl von Wiederholungsversuchen an, wenn eine registrierte Telefonnummer angegeben wird. Der Standardwert ist 2.
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 2.
integer
$flow.max_retry_another_order
Gibt an, wie oft eine andere Bestellung für die Rückgabe ausgewählt werden darf, wenn die Bestell-ID nicht gefunden wird oder die Bestellung nicht zurückgegeben werden kann. 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, in Fällen, in denen mehrere Bestellungen dieselben letzten fünf Ziffern haben. Der Standardwert ist 2.
integer
$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_retry_product_number_counter
Gibt die maximale Anzahl der zulässigen Wiederholungen an, wenn ein Produkt zur Rückgabe ausgewählt wird. Der Standardwert ist 2.
integer
$flow.max_product_report_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_dispute_reason
Gibt die zulässige Anzahl von Wiederholungsversuchen an, wenn der Grund für den Einspruch bestätigt wird. Der Standardwert ist 2.
integer

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.
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
dispute_ticket_id
Ticket-ID für den eingereichten Einspruch.
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: Bei der Unterhaltung wurde 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: Es ist ein Webhook-Fehler 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.
Zusammenfassung
Mit dem Summarization-Generator wird eine Zusammenfassung nach dem Anruf generiert, die die von der Komponente verarbeitete Unterhaltung beschreibt.
Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
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 zum Einrichten des prebuilt_components_retail_authentication:verify_user_details-Webhooks findest du unter Webhook-Einrichtung für Nutzerdetails überprüfen.
Ruf Bestellinformationen ab
Der prebuilt_components_fraud_and_dispute_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_time
Die Uhrzeit, zu der die Bestellung aufgegeben wurde, im Format HH:MM.
String
order_product_count
Die Anzahl der eindeutigen Produkte in einer Bestellung.
integer
order_amount
Der Bestellbetrag in US-Dollar.
integer
order_payment_mode
Gibt die Zahlungsart an, die bei der Bestellung verwendet wurde.
String
all_product_id
Liste der Produkt-IDs für alle Produkte in der Bestellung.
Liste (String)
all_product_name
Liste der Produktnamen für alle Produkte in der Bestellung.
Liste (String)
all_product_brand_name
Liste der Markennamen für alle Produkte in der Bestellung.
Liste (String)
all_product_quantity
Liste der Stückzahlen für alle 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.
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.
Details zur Meldung von Beiträgen
Der prebuilt_components_fraud_and_dispute_order:post_reporting_details-Webhook wird von der Komponente verwendet, um ein Ticket zu Betrug oder Einspruch 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.dispute_product_id
Die Produkt-ID, für die der Nutzer Einspruch einlegen möchte.
String
$flow.order_product_dispute_reason
Gründe für den Einspruch gegen das betreffende Produkt. Gültige Werte werden durch das prebuilt_components_product_dispute_reason-Element definiert.
String
$flow.order_product_dispute_reason_other
Wenn der Nutzer „Sonstiges“ als Grund für die Beschwerde ausgewählt hat, enthält dieses Feld den von ihm angegebenen Grund.
String
$flow.order_product_dispute_reason_detail
Ausführlicher Grund für den Einspruch.
String

API-Antwortparameter
Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.
Parametername
Beschreibung
Ausgabeformat
order_product_dispute_ticket_number
Ticket-ID für den eingereichten Einspruch.
String

Wenn Sie den Webhook „Post reporting details“ für diese Komponente konfigurieren möchten, maximieren Sie die Ansicht und folgen Sie der Anleitung.
Nachricht senden
Über den prebuilt_components_fraud_and_dispute_order:send_message-Webhook sendet die Komponente Bestätigungsdetails zur Beschwerde 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_product_dispute_ticket_number
Bestätigungsnummer für den eingereichten Einspruch.
String
$flow.confirmation_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

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks „Nachricht senden“ für diese Komponente aufzurufen.
Abgeschlossen
Ihr Agent und seine Webhooks sollten jetzt eingerichtet und bereit für den Test sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vordefinierte Komponente zum Erfassen von Kreditkartennummern
bookmark_border
Diese vordefinierte Komponente erfasst eine 8- bis 19-stellige Kreditkartennummer. Erfasste Kreditkartennummern werden mit dem Luhn-Algorithmus validiert.
Beschränkungen
Zusätzlich zu den allgemeinen Einschränkungen für vordefinierte Komponenten gelten für diese vordefinierte Komponente die folgenden Einschränkungen:
Die Integration des Zahlungsgateways ist nicht in der Komponente enthalten.
Kreditkartennummern mit weniger als 8 oder mehr als 19 Ziffern werden nicht unterstützt.
Empfohlene Einstellungen für Kundenservicemitarbeiter
Aktivieren Sie DTMF, damit Nutzer numerische Werte über die Telefontastatur eingeben können.
Zusätzliche Funktionen
Diese vorgefertigte Komponente bietet die folgenden zusätzlichen Funktionen:
Wiederholen
Wartezimmer
Wiedergabe
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.
Einzelner Block
Der Endnutzer gibt in der ersten Unterhaltung die vollständige Kreditkartennummer an. Der Kundenservicemitarbeiter bestätigt und akzeptiert sie.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Nennen oder geben Sie den ersten Teil Ihrer Kreditkartennummer ein. Sie können jederzeit „Abspielen“ sagen, um die aktuell erfassten Nummern zu hören.
4242 4242 4242 4242

Ich habe 4242424242424242 erhalten. Ist das richtig?
Ja

Nennen Sie bitte den nächsten Teil Ihrer Kreditkartennummer oder geben Sie ihn ein. Wenn Sie fertig sind, sagen Sie „Fertig“.
Das war’s schon.

Zur Bestätigung: Die Kreditkartennummer lautet 4242424242424242. Ist das richtig?
Ja

Vielen Dank. Ihre Kreditkartennummer wurde bestätigt.

Mehrere Teile
Der Endnutzer gibt die Kreditkartennummer in drei Teilen an. Der Kundenservicemitarbeiter bestätigt und akzeptiert sie.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Nennen oder geben Sie den ersten Teil Ihrer Kreditkartennummer ein. Sie können jederzeit „Abspielen“ sagen, um die aktuell erfassten Nummern zu hören.
4242

Ich habe 4242, ist das richtig?
Ja

Nennen Sie bitte den nächsten Teil Ihrer Kreditkartennummer oder geben Sie ihn ein. Wenn Sie fertig sind, sagen Sie „Fertig“.
424242

Ich habe 424242, ist das richtig?
Ja

Nennen Sie bitte den nächsten Teil Ihrer Kreditkartennummer oder geben Sie ihn ein. Wenn Sie fertig sind, sagen Sie „Fertig“.
424242

Ich habe 424242, ist das richtig?
Ja

Nennen Sie bitte den nächsten Teil Ihrer Kreditkartennummer oder geben Sie ihn ein. Wenn Sie fertig sind, sagen Sie „Fertig“.
Fertig

Zur Bestätigung: Die Kreditkartennummer lautet 4242424242424242. Ist das richtig?
Ja

Vielen Dank. Ihre Kreditkartennummer wurde bestätigt.

Wiederholen erfolgreich
Der Endnutzer gibt in der ersten Unterhaltung die vollständige Kreditkartennummer an. Der Kundenservicemitarbeiter bestätigt sie noch einmal, aber der Endnutzer sagt „Nein“. Der Kundenservicemitarbeiter bittet den Endnutzer, die Eingabe noch einmal vorzunehmen. Der Endnutzer gibt die Nummer an und bestätigt sie. Der Kundenservicemitarbeiter bestätigt und akzeptiert sie.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Nennen oder geben Sie den ersten Teil Ihrer Kreditkartennummer ein. Sie können jederzeit „Abspielen“ sagen, um die aktuell erfassten Nummern zu hören.
5105105105105100

Ich habe 5105105105105101 erhalten. Ist das richtig?
no

Kein Problem. Bitte wiederholen Sie die Kreditkartennummer oder sagen Sie jeweils vier Ziffern.
5105105105105100

Ich habe 5105105105105100, ist das richtig?
Ja

Nennen Sie bitte den nächsten Teil Ihrer Kreditkartennummer oder geben Sie ihn ein. Wenn Sie fertig sind, sagen Sie „Fertig“.
Das war’s schon.

Zur Bestätigung: Die Kreditkartennummer lautet 5105105105105100. Ist das richtig?
Ja

Vielen Dank. Ihre Kreditkartennummer wurde bestätigt.

Unbekannte Eingabe
Die Komponente beendet den Ablauf, nachdem der Endnutzer dreimal eine nicht erkannte Eingabe gemacht hat.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Nennen oder geben Sie den ersten Teil Ihrer Kreditkartennummer ein. Sie können jederzeit „Abspielen“ sagen, um die aktuell erfassten Nummern zu hören.
Alles in Ordnung

Das habe ich nicht verstanden. Können Sie die Kreditkartennummer noch einmal sagen oder eingeben?
Alles in Ordnung

Hm, das habe ich immer noch nicht verstanden. Achten Sie darauf, dass Sie die Kreditkartennummer richtig nennen. Sie können die Kreditkartennummer auch über die Zifferntastatur eingeben.
Alles in Ordnung

Ich habe Ihre Antwort leider nicht verstanden.

Überprüfung der Kreditkartennummer
Gültige Kreditkartennummern müssen zwischen 8 und 19 Ziffern lang sein. Außerdem werden mit dieser Komponente Kreditkartennummern mithilfe des Luhn-Algorithmus und der Systemfunktion IS_CREDIT_CARD_NUMBER validiert.
Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Erhebung von Kreditkartennummern
Komponentenspezifischer Intent
prebuilt_components_[component_name]_[intent_name]
prebuilt_components_credit_card_number_collection_credit_card_sequence
Parameter
[param_name]
user_provided_new_seq

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
credit_card_status
Dieser Parameter gibt an, ob die erfasste Kreditkartennummer mit dem Luhn-Algorithmus gültig ist:
„valid“ gibt an, dass die erfasste Kreditkartennummer erfolgreich validiert wurde und zwischen 8 und 19 Ziffern lang ist
„invalid“ gibt an, dass die erfasste Kreditkartennummer ungültig ist oder nicht zwischen 8 und 19 Ziffern lang ist
String
credit_card_number_collection_credit_card_number
Dieser Parameter gibt die von der Komponente erfasste Kreditkartennummer zurück.
String

Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
Abgeschlossen
Ihr Agent sollte jetzt eingerichtet und bereit zum Testen sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vordefinierter DMV-Agent (Kraftfahrzeugbehörde)
bookmark_border
Preview
This product or feature is subject to the „Pre-GA Offerings Terms“ in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available „as is“ and might have limited support. For more information, see the launch stage descriptions.
Hinweis :Diese Funktion ist nur eingeschränkt verfügbar. Wenden Sie sich an Ihr Google Cloud Account-Management-Team, um Zugriff auf diese Funktion und die API-Referenzdokumentation zu erhalten.
Mit den Playbook-basierten vorgefertigten Kundenservicemitarbeitern der Kraftfahrzeugbehörde (Department of Motor Vehicles, DMV) können Nutzer ihren Führerschein online verlängern und Termine in DMV-Niederlassungen buchen.
Beispieldialoge
Die folgenden Beispieldialoge veranschaulichen gängige Szenarien, die von diesem vorkonfigurierten Kundenservicemitarbeiter abgedeckt werden.
Führerschein verlängern
Der Nutzer möchte seinen Führerschein verlängern. Der Kundenservicemitarbeiter erfasst die erforderlichen Informationen, einschließlich der Lizenznummer, des Ablaufdatums der Lizenz, des Namens auf der Lizenz und des Geburtsdatums des Nutzers. Der Kundenservicemitarbeiter prüft dann, ob die Lizenz verlängert werden kann, und bestätigt, dass der Nutzer die Lizenz online verlängern möchte. Der Kundenservicemitarbeiter erstellt die Onlineanwendung und gibt eine Bestätigungsnummer an.
Nutzereingabe
Antwort des Kundenservicemitarbeiters
Hallo

Hallo, ich bin Ihr Assistent für die Zulassungsstelle. Ich kann Ihnen helfen, Ihren Führerschein online zu verlängern und einen Termin in einer DMV-Filiale zu vereinbaren. Was kann ich für Sie tun?
Ich möchte meinen Führerschein verlängern.

Nennen Sie mir bitte Ihre aktuelle Führerscheinnummer.
Ja, es lautet ABCD1234.

Vielen Dank. Ich habe Ihr Profil gefunden. Geben Sie das Ablaufdatum der Lizenz an.
09-01-2023

Nennen Sie mir den Namen auf der Lizenz.
Der Name auf der Lizenz lautet Jacky Wang.

Vielen Dank. Wie lautet Ihr Geburtsdatum?
1985-02-03

Können Sie mir die Informationen bestätigen?
Name des Fahrers: Jacky Wang
Geburtsdatum: 02.03.1985
Führerscheinnummer: ABCD1234
Gültig bis: 09.01.2023
Ja, das ist richtig.

Vielen Dank. Ich habe Ihre Angaben überprüft. Sie können die Verlängerung online vornehmen. Möchten Sie Ihren Führerschein online verlängern?
Ja

Sie haben die Verlängerung Ihres Führerscheins beantragt. Ihre Bestätigungsnummer lautet 3LKCN0JS.

Kann ich sonst noch etwas für Sie tun?
Nein, ich bin fertig. Danke.

Vielen Dank! Ich wünsche Ihnen einen schönen Tag.

Termin vereinbaren
Der Nutzer möchte einen Termin vereinbaren. Der Kundenservicemitarbeiter erfasst die erforderlichen Informationen, einschließlich des zuständigen DMV-Büros, des Termindatums und der Uhrzeit. Nachdem der Kundenservicemitarbeiter die erfassten Details mit dem Nutzer bestätigt hat, bucht er den Termin für den Nutzer und gibt eine Bestätigungsnummer an.
Nutzereingabe
Antwort des Kundenservicemitarbeiters
Können Sie mir helfen, einen Termin zu vereinbaren?

Ich kann Ihnen dabei helfen, einen Termin zu vereinbaren. Könnten Sie mir eine Adresse nennen, damit ich nach örtlichen DMV-Büros suchen kann?
Ja, 1st Main Street, MN.

Vielen Dank. Ich habe die folgenden DMV-Stellen in Ihrer Nähe gefunden. Können Sie eine auswählen?

1. Minnesota Driver & Vehicle Services: 2929 Chicago Ave, Minneapolis, MN 55407
2. Apple Valley DMV: 15026 Glazier Ave, Apple Valley, MN 55124
   Ich möchte zur DMV in Brooklyn.

Ich kann die von Ihnen angegebene Zulassungsstelle leider nicht finden. Könnten Sie eine Option aus der Liste auswählen:

1. Minnesota Driver & Vehicle Services
2. Apple Valley DMV
   Dann Apple Valley DMV

An welchem Datum möchten Sie einen Termin vereinbaren? Ich habe folgende Möglichkeiten:

1. 12-13-2023
2. 12-14-2023
3. 15.12.2023
   Wenn Ihnen keiner dieser Termine passt, können Sie mir auch ein anderes Datum nennen.
   Ich möchte am 16. Dezember 2023 fliegen.

Unser Büro ist am Wochenende geschlossen. Möchten Sie stattdessen eines der folgenden Datumsangaben auswählen?

1. 12-18-2023
2. 12-19-2023
3. 12-20-2023
4. Dezember 2023

Vielen Dank. Wann möchten Sie uns besuchen? Am 19. Dezember 2023 habe ich folgende Termine frei:

1. 9:30
2. 10:00
3. 11:30
   nine

Tut mir leid. 9:00 Uhr funktioniert nicht. Wann möchten Sie uns besuchen? Ich habe

1. 9:30
2. 10:00
3. 11:30
   9:30

Bitte bestätigen Sie, dass Sie diesen Termin buchen möchten:
Kfz-Zulassungsstelle: Apple Valley DMV
Termindatum: 19.12.2023
Terminzeit: 9:30
Ja, das ist in Ordnung.

Vielen Dank. Ich habe den Termin gebucht. Ihre Bestätigungsnummer lautet BNFG987H.

Kann ich sonst noch etwas für Sie tun?
Nein

Vielen Dank, dass Sie sich an den DMV-Assistenten gewandt haben. Ich wünsche Ihnen noch einen schönen Tag.

Unbekannte Eingabe
Der Nutzer stellt eine Frage zu einem Thema, das nichts mit der Verlängerung eines Führerscheins oder der Buchung eines Termins zu tun hat. Der Kundenservicemitarbeiter antwortet und erklärt, welche Themen er bearbeiten kann.
Nutzereingabe
Antwort des Kundenservicemitarbeiters
hi

Hallo, ich bin Ihr Assistent für die Zulassungsstelle. Ich kann Ihnen helfen, Ihren Führerschein online zu verlängern und einen Termin in einer DMV-Filiale zu vereinbaren. Was kann ich für Sie tun?
Ich möchte ein Auto kaufen

Das habe ich nicht verstanden. Ich kann Ihnen helfen, einen Führerschein zu verlängern oder einen Termin zu vereinbaren.

Was kann ich für Sie tun?
Ich möchte einen Termin vereinbaren

Ich kann Ihnen dabei helfen, einen Termin zu vereinbaren. Könnten Sie mir eine Adresse nennen, damit ich nach örtlichen DMV-Büros suchen kann?
Wie viel kostet das?

Ich kann die voraussichtlichen Gebühren leider nicht ermitteln. Informationen zu allen Dienstleistungen und Gebühren finden Sie auf der Website Ihrer örtlichen Kraftfahrzeug-Zulassungsstelle.

Möchten Sie fortfahren?
Nein, das war’s.

Kann ich sonst noch etwas für Sie tun?
Nein, das ist alles.

Okay, vielen Dank, dass Sie sich an den DMV-Assistenten gewandt haben. Ich wünsche Ihnen noch einen schönen Tag.

Grundlegende Einrichtung
So richten Sie diesen vordefinierten Agent ein:
Importieren Sie den vordefinierten Agenten.
Konfigurieren Sie die bereitgestellten Tools mit Ihren externen Diensten. Weitere Informationen finden Sie unter Tool-Einrichtung.
Tool-Einrichtung
Dieser Agent enthält Tools, die für die Einbindung in externe Dienste verwendet werden. Mit dem Installationsprogramm für vorgefertigte Tools können Sie Beispielcode und Daten für Ihren vorgefertigten Agenten bereitstellen.
Wenn Sie Beispielcode und ‑daten für den vorgefertigten DMV-Agenten bereitstellen und konfigurieren möchten, maximieren Sie die Anleitung.
Tool zum Verlängern von Lizenzen
Mit dem Tool dmv_renew_tool werden die Details des Führerscheins überprüft, einschließlich Name des Fahrers, Geburtsdatum, Führerscheinnummer und Ablaufdatum. Sobald die erforderlichen Informationen erfasst und bestätigt wurden, wird mit diesem Tool geprüft, ob eine Lizenz verlängert werden kann. Wenn die Lizenz verlängert werden kann, wird über das Tool ein Verlängerungsantrag für den Nutzer eingereicht.
Tool zum Buchen von Terminen
Das dmv_book_appointment_tool-Tool ruft verfügbare Termininformationen ab, einschließlich lokaler Standorte, Termindaten und Terminzeiten. Sobald eine gültige Praxis, ein gültiges Datum und ein gültiges Zeitfenster ausgewählt wurden, wird mit diesem Tool der Termin gebucht.
Abgeschlossen
Ihr Agent und seine Integrationen sollten jetzt eingerichtet und bereit für den Test sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vordefinierte Komponente zum Erfassen des Geburtsdatums
bookmark_border
Diese vordefinierte Komponente erfasst und validiert ein Geburtsdatum, indem Monat, Tag und Jahr erfasst werden.
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 unterstützt nicht die Überprüfung des Geburtsdatums des Endnutzers über die Bestätigung per Ausweis.
Empfohlene Einstellungen für Kundenservicemitarbeiter
Aktivieren Sie DTMF, damit Nutzer numerische Werte über die Telefontastatur eingeben können.
Zusätzliche Funktionen
Diese vorgefertigte Komponente bietet die folgenden zusätzlichen Funktionen:
Wiederholen
Wartezimmer
Wiedergabe
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.
Vollständiges Geburtsdatum
Der Endnutzer gibt sein vollständiges Geburtsdatum in einer Antwort an. Der Kundenservicemitarbeiter akzeptiert es.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Geben Sie Ihr Geburtsdatum ein. Nennen Sie Ihren Geburtsmonat, gefolgt von Ihrem Geburtstag und dann Ihrem Geburtsjahr.

9. September 1995

Okay, Ihr Geburtsdatum ist der 9. September 1995. Ist das richtig?
Ja

Sehr gut, ich habe Ihr Geburtsdatum erfasst.

Teilweises Geburtsdatum
Der Endnutzer gibt sein Geburtsdatum an, indem er zuerst den Monat, dann das Datum und schließlich das Jahr nennt. Der Kundenservicemitarbeiter akzeptiert es.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Geben Sie Ihr Geburtsdatum ein. Nennen Sie Ihren Geburtsmonat, gefolgt von Ihrem Geburtstag und dann Ihrem Geburtsjahr.
März

An welchem Tag wurden Sie geboren?
12

In welchem Jahr wurden Sie geboren?
1999

Okay, Ihr Geburtsdatum ist der 12. März 1999. Ist das richtig?
Ja

Sehr gut, ich habe Ihr Geburtsdatum erfasst.

Validierung von Datumsangaben in der Zukunft
In diesem Szenario wird davon ausgegangen, dass das aktuelle Datum der 22. März 2023 ist. Der Endnutzer gibt ein zukünftiges Geburtsdatum an. Der Kundenservicemitarbeiter bestätigt es und fordert den Endnutzer noch einmal auf, das richtige Geburtsdatum anzugeben.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Geben Sie Ihr Geburtsdatum ein. Nennen Sie Ihren Geburtsmonat, gefolgt von Ihrem Geburtstag und dann Ihrem Geburtsjahr.

9. September 2023

In welchem Jahr wurden Sie geboren?
2023

Okay, Ihr Geburtsdatum ist der 9. September 2023. Ist das richtig?
Ja

Tut mir leid, Sie haben ein Datum in der Zukunft angegeben. Fangen wir noch einmal von vorn an.
In welchem Monat sind Sie geboren?
März

An welchem Tag wurden Sie geboren?
12

In welchem Jahr wurden Sie geboren?
1999

Okay, Ihr Geburtsdatum ist der 12. März 1999. Ist das richtig?
Ja

Sehr gut, ich habe Ihr Geburtsdatum erfasst.

Ungültiges Datum
Der Endnutzer gibt ein ungültiges Geburtsdatum an, z. B. den 30. Februar 1999 oder den 31. April 1999. Der Kundenservicemitarbeiter überprüft das Geburtsdatum und bittet den Endnutzer noch einmal, das richtige Geburtsdatum anzugeben.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Geben Sie Ihr Geburtsdatum ein. Nennen Sie Ihren Geburtsmonat, gefolgt von Ihrem Geburtstag und dann Ihrem Geburtsjahr.

30. Februar 1999

Okay, Ihr Geburtsdatum ist der 30. Februar 1999. Ist das richtig?
Ja

Das angegebene Datum ist ungültig. Fangen wir noch einmal von vorn an.
In welchem Monat sind Sie geboren?
März

An welchem Tag wurden Sie geboren?
12

In welchem Jahr wurden Sie geboren?
1999

Okay, Ihr Geburtsdatum ist der 12. März 1999. Ist das richtig?
Ja

Sehr gut, ich habe Ihr Geburtsdatum erfasst.

Unbekannte Eingabe
Die Komponente beendet den Ablauf, nachdem der Endnutzer dreimal eine nicht erkannte Eingabe gemacht hat.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Geben Sie Ihr Geburtsdatum ein. Nennen Sie Ihren Geburtsmonat, gefolgt von Ihrem Geburtstag und dann Ihrem Geburtsjahr.
Alles in Ordnung

Das habe ich nicht verstanden. Können Sie Ihr Geburtsdatum noch einmal sagen oder eingeben?
nett

Ich habe Ihr Geburtsdatum leider nicht erhalten. Fangen wir mit dem Monat an. In welchem Monat sind Sie geboren?
good

Das habe ich nicht verstanden. Können Sie die Monatszahl bitte noch einmal sagen oder eingeben?
nett

Hm, das habe ich immer noch nicht verstanden. Achten Sie darauf, den Monat zu nennen. Wenn ich Sie nicht gut verstehe, können Sie die Monatszahl auch über die Tastatur eingeben.
nett

Ich habe Ihre Antwort leider nicht verstanden.

Überprüfung des Geburtsdatums
Bei dieser vordefinierten Komponente werden die Systemfunktionen IS_DATE und IS_FUTURE_DATE verwendet, um zu prüfen, ob ein erfasstes Datum gültig und in der Vergangenheit liegt. Außerdem gilt:
Eingaben wie „Dieser Monat“, „Nächster Monat“ oder „Letzter Monat“ werden in die entsprechenden Monate umgewandelt. Wenn der Endnutzer beispielsweise im März mit dem Kundenservicemitarbeiter interagiert, werden „diesen Monat“, „nächsten Monat“ und „letzten Monat“ in „März“, „April“ und „Februar“ umgewandelt.
Prüft, ob das Jahr aus vier Ziffern besteht. Wenn die Jahreseingabe nur zwei Ziffern enthält, wandelt die Komponente sie in eine vierstellige Jahreszahl um. Beispiel: „98“ wird in „1998“ umgewandelt.
Eingaben wie „diesen Donnerstag“, „letzten Donnerstag“ und „nächsten Donnerstag“ werden als entsprechender Monat und Tag erfasst. Der Kundenservicemitarbeiter wird aufgefordert, das Jahr anzugeben. Wenn der Endnutzer beispielsweise am 22. März 2023 (Mittwoch) mit dem Kundenservicemitarbeiter interagiert, werden „diesen Donnerstag“, „letzten Donnerstag“ und „nächsten Donnerstag“ in „23. März“, „16. März“ und „30. März“ umgewandelt.
Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Erhebung des Geburtsdatums
Komponentenspezifischer Intent
prebuilt_components_[component_name][intent_name] prebuilt_components_dob_collection_collect_month Parameter

[param_name]

geb. Entitätstyp prebuilt_components[component_name]_[entity_type]
prebuilt_components_dob_collection_dob_day

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
dob_collection_dob
Dieser Parameter gibt ein Objekt mit den Elementen des Geburtsdatums zurück: Tag, Monat und Jahr.
{
„year“: integer,
„month“: integer,
„day“: integer
}

Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
Abgeschlossen
Ihr Agent sollte jetzt eingerichtet und bereit zum Testen sein.
Dialogflow
Documentation
CX
War das hilfreich?
Feedback geben
Vorgefertigte Komponente zum Erfassen des Ablaufdatums der Kreditkarte
bookmark_border
Mit dieser vorgefertigten Komponente wird das Ablaufdatum einer Kreditkarte von einem Endnutzer erfasst.
Beschränkungen
Zusätzlich zu den allgemeinen Einschränkungen für vordefinierte Komponenten gelten für diese vordefinierte Komponente die folgenden Einschränkungen:
Die Integration des Zahlungsgateways ist in dieser Komponente nicht enthalten.
Empfohlene Einstellungen für Kundenservicemitarbeiter
Aktivieren Sie DTMF, damit Nutzer numerische Werte über die Telefontastatur eingeben können.
Zusätzliche Funktionen
Diese vorgefertigte Komponente bietet die folgenden zusätzlichen Funktionen:
Wiederholen
Wartezimmer
Wiedergabe
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.
Erfolgreiche Eingabe
Der Endnutzer gibt beim ersten Versuch ein Ablaufdatum an, das der Kundenservicemitarbeiter akzeptiert.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Nennen oder geben Sie das Ablaufdatum der Kreditkarte ein. Geben Sie dabei zuerst den Monat und dann das Jahr an.
27.01.

Das Ablaufdatum der Kreditkarte ist Januar 2027. Ist das richtig?
Ja

Super, ich habe das Ablaufdatum der Kreditkarte erfasst.

Neuversuche
Der Endnutzer gibt beim ersten Versuch ein Ablaufdatum an. Bei der Bestätigung des erfassten Ablaufdatums durch den Kundenservicemitarbeiter sagt der Endnutzer, dass es falsch ist. Der Kundenservicemitarbeiter bittet den Endnutzer, zu bestätigen, welcher Teil des Ablaufdatums falsch ist – das gesamte Datum, der Monat oder das Jahr – und bittet ihn noch einmal, diese Details anzugeben.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Nennen oder geben Sie das Ablaufdatum der Kreditkarte ein. Geben Sie dabei zuerst den Monat und dann das Jahr an.
27.01.

Das Ablaufdatum der Kreditkarte ist Januar 2027. Ist das richtig?
Es ist falsch

Tut mir leid, ich habe das nicht richtig verstanden. Möchten Sie das gesamte Datum ändern oder stattdessen den Monat oder das Jahr?
Monat

Das tut uns leid. Nennen oder geben Sie den Ablaufmonat Ihrer Kreditkarte ein.
Feb.

Der Ablaufmonat der Kreditkarte ist Februar. Ist das richtig?
Ja

Ich habe das Ablaufdatum der Kreditkarte erhalten: Februar 2027. Ist das richtig?
Ja

Super, ich habe das Ablaufdatum der Kreditkarte erfasst.

Teilweise Eingabe
Szenario: Der Endnutzer kann das Ablaufdatum beim ersten Versuch nicht angeben. Der Kundenservicemitarbeiter teilt das Ablaufdatum in einen Monat und ein Jahr auf und bittet um diese Angaben. Der Endnutzer gibt die Eingabe diesmal korrekt ein und der Kundenservicemitarbeiter akzeptiert sie.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Nennen oder geben Sie das Ablaufdatum der Kreditkarte ein. Geben Sie dabei zuerst den Monat und dann das Jahr an.
13

Das Ablaufdatum stimmt leider nicht ganz. Versuchen wir es noch einmal mit dem Monat.

Nennen oder geben Sie den Ablaufmonat Ihrer Kreditkarte ein.
1

Der Ablaufmonat der Kreditkarte ist Januar. Ist das richtig?
Ja, richtig.

Nennen oder geben Sie das Ablaufjahr Ihrer Kreditkarte ein.
26

Das Ablaufjahr der Kreditkarte lautet 2026. Ist das richtig?
Ja

Ich habe das Ablaufdatum der Kreditkarte erhalten: Januar 2026. Ist das richtig?
Ja

Super, ich habe das Ablaufdatum der Kreditkarte erfasst.

Unbekannte Eingabe
Die Komponente beendet den Ablauf, nachdem der Endnutzer dreimal eine nicht erkannte Eingabe gemacht hat.
Nutzereingabe
Antwort des Kundenservicemitarbeiters

Nennen oder geben Sie das Ablaufdatum der Kreditkarte ein. Geben Sie dabei zuerst den Monat und dann das Jahr an.
Alles in Ordnung

Das habe ich nicht verstanden. Können Sie das Ablaufdatum der Kreditkarte noch einmal sagen oder eingeben?
nett

Hm, das habe ich immer noch nicht verstanden. Geben Sie das Ablaufdatum der Kreditkarte durch. Sie können das Ablaufdatum der Kreditkarte auch über die Tastatur eingeben.
good

Ich habe Ihre Antwort leider nicht verstanden.

Gültigkeitsdatum der Kreditkarte überprüfen
Die Monate des Gültigkeitsdatums der Kreditkarte müssen als Ganzzahl zwischen „01“ und „12“ oder als String eingegeben werden, der einen Monat zwischen „Januar“ und „Dezember“ darstellt.
Das Jahr des Ablaufdatums der Kreditkarte muss aus vier Ziffern bestehen. Wenn die Eingabe zweistellig ist, wird sie in ein vierstelliges Jahr umgewandelt, z.B. „25“ in „2025“. Außerdem darf das Jahr nicht mehr als 10 Jahre in der Zukunft liegen.
Das Ablaufdatum der Kreditkarte, einschließlich Monat und Jahr, muss ein zukünftiges Datum sein, das auf den aktuellen Monat und das aktuelle Jahr folgt.
Namenskonventionen
Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:
Funktion
Format
Beispiel
Flow
[Component Name]
Ablaufdatum der Kreditkarte
Komponentenspezifischer Intent
prebuilt_components_[component_name][intent_name] prebuilt_components_credit_card_expiration_date_collection_collect_date Entitätstyp prebuilt_components[component_name]_[entity_type_name]
prebuilt_components_credit_card_expiration_date_collection_month
Parameter
[param_name]
expiration_date

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
credit_card_expiration_date_collection_credit_card_expiration_date
Dieser Parameter gibt das Objekt der Ablaufelementtypen zurück, die während der Unterhaltungssitzung erfasst werden.
{
„year“: integer,
„month“: integer
}

Grundlegende Einrichtung
So richten Sie diese vorkonfigurierte Komponente ein:
Importieren Sie die vordefinierte Komponente.
Abgeschlossen
Ihr Agent sollte jstzt dgerdicshtet und bereit zum Testen sein.