Textbot Exchange

This help page is for Desktop Studio. This information is also available for CXone Studio.

The icon for the Textbot Exchange action.

Integriert einen virtuellen Self-Service-Agenten Eine Softwareanwendung, die Kundeninteraktionen anstelle eines Live-Mitarbeiters abwickelt. in Chat-Skripten. Diese Aktion wird in einer Schleife im Skript verwendet. Ein Skript muss mindestens zwei TextBot Exchange-Aktionen enthalten. Ihr virtueller Agent muss diese Aktion unterstützen.

Die TextBot Exchange-Aktion ist für komplexe virtuelle Agenten vorgesehen oder für Situationen, in denen das Verhalten des virtuellen Agenten von Runde zu Runde angepasst werden muss. Sie überwacht das Gespräch zwischen dem Kontakt und dem virtuellen Agenten Eine Softwareanwendung, die Kundeninteraktionen anstelle eines Live-Mitarbeiters abwickelt. Runde für Runde. Jede Äußerung Was ein Kontakt sagt oder tippt. wird an den virtuellen Agenten gesendet. Der virtuelle Agent analysiert die Äußerung, um die Absicht Die Bedeutung oder der Zweck hinter dem, was ein Kontakt sagt/tippt; was der Kontakt mitteilen oder erreichen möchte und den Kontext festzustellen, und legt dann die passende Antwort fest. TextBot Exchange übergibt die Antwort an den Kontakt. Wenn das Gespräch beendet ist, fährt die Aktion mit dem Skript fort.

Ein Doppelklick auf diese Aktion öffnet das Fenster Virtueller Agenten-Hub, in dem Sie alle Ihre virtuellen Agenten-Bots verwalten können.

Unterstützte Skripttypen


E-Mail-Adresse	Chat	SMS	Digital

Vergleich ähnlicher Aktionen

Die folgenden Aktionen haben ähnliche Funktionen, aber mit einigen wichtigen Unterschieden:

Textbot Exchange: Diese action wird für komplexe Interaktionen mit virtuellen Agenten verwendet. Sie ermöglicht Ihnen, Exchange-Parameter einzubeziehen und verschiedene Aspekte des Gesprächs zwischen dem Kontakt und dem virtuellen Agenten anzupassen.
Voicebot Exchange: Diese action wird für komplexe Interaktionen mit virtuellen Agenten verwendet. Sie ermöglicht Ihnen, Exchange-Parameter einzubeziehen und verschiedene Aspekte des Gesprächs zwischen dem Kontakt und dem virtuellen Agenten anzupassen.

Unterstützte virtuelle Agenten

Diese Aktion unterstützt die folgenden virtuellen Agenten:

Bevor Sie dieser Aktion einen virtuellen Agenten zuweisen können, müssen Sie in Virtueller Agenten-Hub eine App für den virtuellen Agenten hinzufügen und konfigurieren. Sie benötigen nur eine App für jeden virtuellen Agenten, den Sie verwenden. Sie können dieselbe App mehreren Aktionen für virtuelle Agenten in Ihren Skripten zuweisen. Weitere Informationen zur Konfiguration finden Sie in der Hilfeseite für den von Ihnen verwendeten virtuellen Agentenanbieter.

Eingabeeigenschaften

Diese Eigenschaften definieren Daten, die von der Aktion bei der Ausführung verwendet werden.

Eine oder mehrere Eigenschaften dieser Aktion erfordern eine Snippet-Aktion mit benutzerdefiniertem Code.

Eigenschaft	Details
Caption	Geben Sie eine kurze Phrase ein, mit der diese Aktion im Skript eindeutig identifiziert wird. Die Beschriftung wird im Skript-Arbeitsbereich unter dem Symbol der Aktion angezeigt. The default is the action name.
virtualAgentID	Der Name des in Virtueller Agenten-Hub ausgewählten virtuellen Agenten. Wenn Sie eine virtuelle Agenten-App einer Studio-Aktion in Virtueller Agenten-Hub zuweisen, wird diese Eigenschaft automatisch ausgefüllt. Der Name ist der Name, der im Feld Virtual Agent (Bot) Name in der Virtueller Agenten-Hub-App verwendet wird.
automatedIntent	Geben Sie namentlich eine bestimmte Absicht ein, auf die der virtuelle Agent antworten soll, anstatt den virtuellen Agenten die gesammelten Benutzereingaben interpretieren zu lassen. Ein häufiger Anwendungsfall hierfür ist das Auslösen der ersten Willkommensnachricht vom virtuellen Agenten. Welcome ist der Standardstring für die erste Begrüßung.
userInput	Die Nachricht, die der Kontakt im Chatfenster schreibt und die als Texteingabe an den virtuellen Agenten weitergegeben wird.
customPayload	Konfigurieren Sie diese Eigenschaft nur, wenn Sie benutzerdefinierte Nutzlastdaten zum virtuellen Agenten weitergeben müssen. Das benutzerdefinierte Nutzlast-Objekt wird vom Studio-Skript ausgefüllt. Sie können es verwenden, um Informationen wie den Namen des Kontakts aus einem CRM Systeme von Drittanbietern, die z. B. Kontakte, Vertriebsinformationen, Supportdetails und Fallgeschichten verwalten. zu übergeben, die in einer Willkommensnachricht verwendet werden sollen. Geben Sie den Namen des JSON-Objekts ein, das Daten vom Skript zum virtuellen Agenten weitergibt. Sie müssen das benutzerdefinierte Nutzlast-Objekt in einer Snippet-Aktion definieren. Das Objekt muss in das JSON-Format umgewandelt werden, entweder im Snippet oder in der customPayload-Eigenschaft. Anforderungen für spezifische Anbieter virtueller Agenten: Amazon Lex V1: Diese Eigenschaft ist auch dann erforderlich, wenn Sie keine Daten an den virtuellen Agenten übergeben müssen. Fügen Sie ein Snippet mit einem Platzhalterwert hinzu. Google Dialogflow ES: Diese Eigenschaft wird verwendet, um den Kontext für eine Absicht Die Bedeutung oder der Zweck hinter dem, was ein Kontakt sagt/tippt; was der Kontakt mitteilen oder erreichen möchte zu übergeben. Informieren Sie sich über die empfohlenen Verfahren für eigene Payloads mit Google Dialogflow ES, um eine korrekte Handhabung sicherzustellen. Google Dialogflow CX: Informieren Sie sich über die empfohlenen Verfahren für eigene Payloads mit Google Dialogflow CX, um eine korrekte Handhabung sicherzustellen. Verwenden Sie diese Eigenschaft nicht, wenn Sie Daten verarbeiten müssen, die der virtuelle Agent an das Skript zurückgibt. Verwenden Sie stattdessen die Variable customPayloadVarName (out).
botSessionState	Der Anbieter des virtuellen Agenten weist jedem Gespräch zwischen einem Kontakt und einem virtuellen Agenten eine eindeutige ID zu. Die Kennung verhindert, dass für das Gespräch jedes Mal eine neue Sitzung erstellt wird. Der Anbieter erstellt die ID beim Beginn des Gesprächs und übergibt sie mit der ersten Antwort an das Skript. Das Skript speichert die ID in der Variablen, die in der Eigenschaft botSessionStateVarName (out) dieser Aktion angegeben ist. Anschließend übergibt es die ID an die Eigenschaft botSessionState. Diese Eigenschaft muss korrekt konfiguriert werden, damit Ihr virtueller Agent ordnungsgemäß funktioniert. Weitere Informationen zur Konfiguration finden Sie auf der Hilfeseite zum Snippet für den Bot-Sitzungsstatus.

Ausgabeeigenschaften

Diese Eigenschaften enthalten Variablen mit Daten, die bei der Ausführung der Aktion zurückgegeben werden. Sie stehen zu Referenzzwecken und zur Verwendung nach Abschluss der Aktion zur Verfügung.

Eigenschaft	Beschreibung
nextPromptVarName (out)	Definiert das Verhalten, mit dem der Benutzer bei der nächsten Gesprächsrunde aufgefordert wird.
customPayloadVarName (out)	Gibt benutzerdefinierte JSON-Daten vom virtuellen Agenten an das Skript zurück. Verwenden Sie diese Variable, wenn das Skript Daten verarbeiten soll, die der virtuelle Agent bereitstellt. Kann Erfüllungsdaten enthalten. Wenn Sie Daten an den virtuellen Agenten übergeben möchten, verwenden Sie die Eigenschaft customPayload.
errorDetailsVarName (out)	Veranlasst die Fehlerabsichtssequenz; kann zu einer Übertragung an einen Live-Agenten führen.
intentInfoVarName (out)	Eine Variable, die Details vom virtuellen Agenten enthält, die die aktuelle Benutzerabsicht anzeigen.
botSessionStateVarName (out)	Enthält die Variable, in der das Skript die ID für den Bot-Sitzungsstatus speichert, die vom Anbieter des virtuellen Agenten bereitgestellt wird. Der Inhalt der Variablen wird an die botSessionState-Eigenschaft übergeben. Diese Eigenschaft muss korrekt konfiguriert werden, damit Ihr virtueller Agent ordnungsgemäß funktioniert. Weitere Informationen zur Konfiguration finden Sie auf der Hilfeseite zum Snippet für den Bot-Sitzungsstatus.

Bedingungen für Ergebnisverzweigungen

Mit Bedingungen für Ergebnisverzweigungen können Sie in Ihrem Skript Verzweigungen erstellen, die für unterschiedliche Ergebnisse bei der Ausführung einer Aktion vorgesehen sind.

Bedingung	Beschreibung
Default	Genommener Pfad, außer das Skript erfüllt eine Bedingung, die es erfordert, einer der anderen Verzweigungen zu folgen. Dieser Pfad wird auch genommen, wenn die anderen Verzweigungen der Aktion nicht definiert sind.
OnPromptAndCollectNextResponse	Genommener Pfad, wenn der virtuelle Agent bestimmt hat, dass die Interaktion fortgesetzt werden soll und bereit für weitere menschliche Eingaben des Kontakts ist. Fordert zur nächsten Runde im Gespräch auf.
OnError	Genommener Pfad, wenn ein unerwartetes Problem auftritt (wie z. B. schlechte Konnektivität, Syntaxfehler und so weiter). Die Variable _ERR muss mit einer zusammengefassten Erläuterung des Problems ausgefüllt werden.
OnReturnControlToScript	Genommener Pfad, wenn der virtuelle Agent anzeigt, dass das Gespräch beendet ist, und die Kontrolle an das Studio-Skript zurückgibt, um den Anruf weiterzuleiten oder zu beenden. Möglicherweise enthält das customPayload-Ergebnis Erfüllungsdaten, die verarbeitet werden müssen.

Snippet Aktionscode

Eine oder mehrere Eigenschaften dieser Aktion erfordern eine Snippetaction- mit dem folgenden benutzerdefinierten Code:

Best Practices für benutzerdefinierte Nutzdaten mit Google Dialogflow CX

Wenn Sie diese Aktion mit Google Dialogflow CX verwenden, beachten Sie die folgenden Best Practices für die Integration von benutzerdefinierten Nutzdaten:

Dialogflow CX verwendet keine Kontexte, um Daten an Dialogflow intents Die Bedeutung oder der Zweck hinter dem, was ein Kontakt sagt/tippt; was der Kontakt mitteilen oder erreichen möchte zu übergeben, wie es DialogflowES tut.
Sie können benutzerdefinierte Daten unter Verwendung von JSON-Schlüssel-Wert-Paaren an Dialogflow CX übergeben. Erstellen Sie in einer Snippet action -Aktion in Ihrem Skript ein dynamisches customPayload-Objekt und fügen Sie ihm die Schlüssel-Wert-Paare hinzu. Beispiel:
```
DYNAMIC customPayload
customPayload.ani = ani
customPayload.contactID = contactId
customPayload.masterContactId = masterId
customPayloadJSON = "{customPayload.asJSON()}"	
```
Konfigurieren Sie in der Exchange- oder Conversation-Aktion in Ihrem Skript die customPayload-Eigenschaft mit einer Variablen, die die asJSON()-Funktion in ihrem Wert enthält. Sie finden diese Variable im customPayload-Objekt.
Übergeben Sie customPayload-JSON mit der Payload-Eigenschaft von QueryParameters an den virtuellen Agenten. Lesen Sie die Google-Dokumentation zu Abfrageparametern für Google Dialogflow CX.
Die über QueryParameters übergebenen Daten werden von einem Webhook in Dialogflow CX empfangen. Sie können Code in der Dialogflow CX-Konsole schreiben, um die übergebenen Daten zu verarbeiten.
Verschachteln Sie kein Objekt in dem customPayload-Objekt. Verschachtelte Objekte werden als buchstäbliche Zeichenfolgen gesendet.
Um eigene Daten von Ihrem virtuellen Dialogflow CX-Agenten an das Skript zurückzugeben, verwenden Sie das Feld Benutzerdefinierte Nutzdaten in der Dialogflow CX-Konsole. Stellen Sie sicher, dass Sie sich in der Konsole für den virtuellen Agenten befinden, den Sie mit CXone verwenden. Ordnen Sie dies Ihrem Skript zu, indem Sie die Variable customPayloadVarName (out) in der voice- oder chat-Studio-Aktion in Ihrem Skript verwenden. Damit können Sie zum Beispiel das Verhalten der nächsten Eingabeaufforderung festlegen.
Parameter, die mithilfe von customPayload festgelegt werden, können nur im externen Webhook verwendet werden. Wenn Sie Parameter festlegen möchten, die außerhalb des externen Webhook verwendet werden sollen, legen Sie sie in einer Snippet-Aktion mit dem session_params-Feld fest. Beispiel:
```
{
	"session_params":
	{ 
		"name": "Winnie Le Pooh"
		"job": "Food critic"
		"location": "Hundred Acre Wood"
	}
}
```
Greifen Sie mit der folgenden Syntax auf die Sitzungsparameter in der Absicht des Dialogflow CX-Agenten zu:

$session.params.name = Winnie Le Pooh

$session.params.job = Food critic

$session.params.location = 100 Acre Wood

Sitzungsparameter werden nur mit virtuellen Dialogflow CX-Agenten verwendet. Verwenden Sie Kontexte, um ein ähnliches Ergebnis mit Dialogflow ES zu erzielen.
Hinweise zum Sprachkontext können mit der eigenen Payload im Parameter speechContexts weitergegeben werden. Der Wert von speechContexts.phrases muss ein Google Klassen-Token für den Hinweis sein, den Sie geben möchten. Das Token muss der Sprache und dem Gebietsschema Ihrer Kontakte entsprechen. Beispiel:
```
DYNAMIC customPayload
customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
customPayload.speechContexts.boost=10		
```

Best Practices für benutzerdefinierte Nutzdaten mit Google Dialogflow ES

Wenn Sie diese Aktion mit Google Dialogflow ES verwenden, beachten Sie die folgenden Best Practices für die Integration von benutzerdefinierten Nutzdaten:

CustomPayload wird verwendet, um den Kontext für eine Absicht Die Bedeutung oder der Zweck hinter dem, was ein Kontakt sagt/tippt; was der Kontakt mitteilen oder erreichen möchte zu übergeben. Der Kontext hilft dem virtuellen Agenten, die Absicht des Benutzers zu verstehen. Kontexte sind nicht erforderlich, aber sie helfen dem virtuellen Agenten, eine Äußerung Was ein Kontakt sagt oder tippt. einer Absicht zuzuordnen.
Erstellen Sie in einer Snippet -Aktion in Ihrem Skript ein customPayload-Objekt mit dem Format gemäß Google Dialogflow ES-Dokumentation für die REST-Ressource: projects.agent.sessions.context. Die Onlinehilfe für Studio enthält weitere Informationen über dynamische Datenobjekte.
Sie können auch benutzerdefinierte Daten mit customPayload ohne Kontexte übergeben. Fügen Sie dazu standardmäßige JSON-Schlüssel-Wert-Paare in ein dynamisches Objekt ein.
Sprachkontexte werden in eigener Payload zum speech_contact-Parameter hinzugefügt. Sie können die Inhalte dieses Parameters in Studio-Traces und Anwendungsprotokollen sehen.
Das dynamische customPayload-Objekt wird als Parameter für den virtuellen Agenten in Form von JSON übergeben, wie im Beispielskript gezeigt.
Hinweise zum Sprachkontext können mit der eigenen Payload im Parameter speechContexts weitergegeben werden. Der Wert von speechContexts.phrases muss ein Google Klassen-Token für den Hinweis sein, den Sie geben möchten. Das Token muss der Sprache und dem Gebietsschema Ihrer Kontakte entsprechen. Beispiel:
```
DYNAMIC customPayload
customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
customPayload.speechContexts.boost=10		
```