Teilen über


Verwenden Sie das Automatisierungswörterbuch, um Datenparameterschlüssel zu übergeben

Das Automatisierungswörterbuch verwaltet die Kontextdaten für Sitzungen. Sie können die Schlüssel aus dem Automatisierungswörterbuch verwenden, um den Parameter in einer Aktion zu übergeben.

Beim Erstellen von Vorlagen und Makros in der Verwaltungs-App können Sie Parameterschlüssel wie den Titel einer Sitzung, den Titel der Benachrichtigung, den Titel einer Anwendungsregisterkartenvorlage und benutzerdefinierte Parameterwerte für Anwendungsregistertypen übergeben. Diese Schlüssel werden anhand der kontextbezogenen Informationen ersetzt, die zum Zeitpunkt der Ausführung verfügbar sind.

Weitergeben von Datenparametern in Vorlagen

Nehmen wir ein Szenario für Vorlagen mit den Benachrichtigungen.

Die Benachrichtigung zeigt bestimmte Felder und Werte, die als entsprechend als Feldkopfzeile und Wert bezeichnet werden.

Der Kunde Kenny Smith hat eine Unterhaltung gestartet. Wenn der Agent die Benachrichtigung sieht, zeigt sie Kundenname als Kenny Smith an.

Hier ist die Feldkopfzeile Kundenname und der Wert lautet Kenny Smith.

Für Vorlagen zum Identifizieren des Kundennamens als Kenny Smith müssen Sie (der Administrator) den Parameter als Schlüssel übergeben.

Dies gilt auch für Sitzungs- und Benachrichtigungstitel, Sie können die Datenenparameter weitergeben. Weitere Informationen: Automatisierungswörterbuchformate für Datenparameterschlüssel

Das System ersetzt diese Parameterschlüssel durch die tatsächlichen Werte basierend auf dem Kontext der Sitzung, dem Kanalanbieter, Microsoft Dataverse und den Benutzeraktionen. Weitere Informationen: Typen von Kontextdatenparametern

Datenparameter in Makros und Agent-Skripts übergeben

Makros sind eine Reihe konfigurierter sequenzieller Aktionen, die vom Benutzer bei Bedarf ausgeführt werden. Als Administrator müssen Sie die Aktionen konfigurieren, die ein Makro ausführen muss. Um die Aktionen zu konfigurieren, müssen Sie die Datenenparameter weitergeben. Weitere Informationen: Verwenden des Automatisierungswörterbuchs, um Datenparameterschlüssel zu übergeben

Wenn der Agent das Makro ausführt, ersetzt das System diese Parameterschlüssel durch die tatsächlichen Werte basierend auf dem Kontext der Sitzung, dem Kanalanbieter, Dataverse und den Benutzeraktionen.

Wenn der Kontext aus einer Sitzung stammt, wird die Makroaktion basierend auf den Informationen für eine aktuelle Sitzung ausgeführt, wobei die Informationen von einer Registerkarte Anker oder einer aktuellen Registerkarte abgerufen werden, die im Fokus steht. Wenn Sie zum Beispiel eine Anfrage erstellen möchten, müssen Sie die Aktionen definieren, die das Entitätsformular für den Vorfall und die GUID des Formulars enthalten (optional). Weitere Informationen: Typen von Kontextdatenparametern

Typen von Kontextdatenenparametern

Das Automatisierungswörterbuch verwendet die Kontextdatenenparameter, die unter den folgenden Quellen verfügbar sind:

Automatisierungswörterbuch.

Kontextdaten vom Kanalanbieter

Diese Kontextdaten stammen vom Erstanbieter-Kanalanbieter wie Omnichannel for Customer Service oder von einem Drittanbieter-Kanalanbieter, der das vom Dynamics 365-Kanalintegrationsframework bereitgestellte Widget verwendet. Die Kontextdaten von Omnichannel for Customer Service sind beispielsweise eine Umfrage vor der Unterhaltung oder eine Besucherportalnavigation.

Kontextdaten aus Benutzeraktionen

Diese Daten werden ausgefüllt, wenn Agenten einige Aktivitäten in der Sitzung ausführen. Ein Beispiel öffnet einen neuen Kundendatensatz, einen Fall usw.

Kontextdaten von Dataverse

Die Organisationsdaten werden in Dataverse gespeichert und Sie können die Daten mit der Verwendung von OData-Abfragen abrufen. Weitere Informationen: OData-Abfragen

Kontextdaten aus anderen Makro-Aktionen

Eine Aktion in einem Makro generiert Kontextdaten, die von anderen Aktionen in diesem Makro verwendet werden.

Beispielsweise gibt es zwei Aktionsschritte in der folgenden Reihenfolge:

  1. Neues Formular zur Datensatzerstellung öffnen.
  2. E-Mail-Formular mit einer vordefinierten Vorlage öffnen.

Beim Erstellen der Aktion E-Mail-Formular mit vordefinierter Vorlage öffnen können Sie die Kontextdatenparameterschlüssel aus dem Makro-Aktionsschritt Neues Formular zur Datensatzerstellung öffnen abrufen.

Der Kontextdatenenparameter aus der ersten Makro-Aktion sind Folgende:

  • Logischer Entitätsname
  • Seitentyp
  • Registerkarten-ID

Notiz

Die Kontextdatenparameter aus anderen Makroaktionen gelten nur für Makros und nicht für Vorlagen.

Automatisierungswörterbuchformate für die Weitergabe von Datenparameterschlüsseln

Das Automatisierungswörterbuch verwaltet die Kontextdaten für Sitzungen. Die Schlüssel im Automatisierungswörterbuch können als Parameter an die Aktion in Makros übergeben werden. Das System ersetzt diese Parameterschlüssel durch den tatsächlichen Wert, basierend auf dem Kontext der Sitzung, dem Kanalanbieter, Dataverse und Benutzeraktionen.

Das Automatisierungswörterbuch unterstützt die folgenden Formate:

Platzhalterfelder

EIN Platzhalterfeld ist ein Ersetzungsparameter, den das System zur Laufzeit kontextabhängig ausfüllt. Verwenden Sie die folgende Liste von Platzhalterfeldern nur für Makros und Agent-Skripts und zum Festlegen eines Agent-Skripts als Standard mithilfe des Agent-Skript-Ausdrucks-Generators. Mehr Informationen: Produktivitätstools

Platzhalterfeld für Produktivitätstools (Makros und Agent-Skripts)

Makros und Agentenskripts unterstützen die folgenden Platzhalterfelder:

Slug Beschreibung
${customerName} Der Name des Kunden, der die Unterhaltung eingeleitet hat.
${caseId} Der eindeutige Bezeichner der Anfrage. Das System zeigt die Fall-ID nur an, wenn ein Fall mit der Unterhaltung verknüpft ist.
${caseTitle} Der Titel der Anfrage. Das System zeigt den Titel der Anfrage nur an, wenn die Anfrage mit der Unterhaltung verknüpft ist.
${LiveWorkItemId} Die eindeutige ID der Unterhaltung.
${queueId} Der eindeutige Bezeichner der Warteschlange. Diese alphanumerische Zeichenfolge wird in der URL der Warteschlangenseite angezeigt.
${visitorLanguage} Die Sprache des Kunden, der die Unterhaltung gestartet hat.
${visitorDevice} Das Gerät des Kunden, der die Unterhaltung gestartet hat.
${entityRoutingLogicalName} Der Name der Entität, wenn die Benachrichtigung für einen Entitätsdatensatz bestimmt ist.
${customerEntityName} Der Name der Entität (Kontakt oder Konto), wenn der Kunde authentifiziert ist.
${customerRecordId} Die eindeutige ID der Entität (Kontakt oder Konto), wenn der Kunde authentifiziert ist.
${<name of the pre-conversation survey questions>} Bei allen Unterhaltungen innerhalb einer Umfrage vor dem Chat, die für einen Arbeitsstream konfiguriert sind, wird der Platzhalterfeldname als Name der Abfrage verwendet.

Notiz

Nur das ${anchor.<attribute_name>}-Platzhalterfeld wird in den Makros und Skripten für den Customer Service workspace unterstützt.

Der folgende Slug wird verwendet, um eine Wiederverbindungsverbindung zu generieren, die für Kunden freigegeben werden kann, um eine Verbindung zu demselben Agenten und derselben Konversation herzustellen. Mehr Informationen: Konfigurieren Sie eine erneute Verbindung zu einem vorherigen Chat

Slug Beschreibung
{ReconnectUrl{ReconnectID}} Wird in schnellen Antworten verwendet, um den Link zum erneuten Verbinden zu generieren.

Format für Platzhalterfelder für Produktivitätstools

Das ${Slug}-Parameterformat, das den Kontext vom Kanalanbieter, der aktuellen Benutzersitzung, der Ausgabe anderer Makroaktionen oder Dataverse abruft.

Produktivitätsautomatisierungkontext

Wenn Sie ein Platzhalterfeld im Kontext der Produktivitätsautomatisierung ausführen möchten, das verwendet wird, um Vorgänge im Zusammenhang mit modellgesteuerten Apps in Dynamics 365 auszuführen, verwenden Sie das ${</slug/>} Beispiel: ${customerName}

Sitzungs-Connector-Kontext

Wenn Sie ein Platzhalterfeld im Sitzungskontext ausführen möchten, müssen Sie das Format ${$session.<slug>} verwenden. Beispiel: ${$session.customerName}

Einige der für den Sitzungskontext verfügbaren Platzhalterfelder enthalten:

  • ${$session.visitorDevice}
  • ${$session.visitorDevice}
  • ${$session.entityRoutingLogicalName}
  • ${$session.entityRoutingRecordId}
  • ${$session.<name of the pre-chat survey questions>

Omnichannel-Connector-Kontext

Wenn Sie ein Platzhalterfeld im Omnichannel for Customer Service-Kontext ausführen möchten, müssen Sie das Format ${$oc.<slug>} verwenden. Beispiel: ${$oc.customerName}

Die Parameter Session.CurrentTab.<Attribute> und Session.AnchorTab.<Attribute> liefern Kontextdaten basierend auf der aktuellen Sitzung und der Ankerregisterkarte oder der aktuellen Registerkarte im Fokus. Folgende Attributtypen werden unterstützt:

  • EntityName
  • Entitäts-ID

Beispiele:

  • Session.CurrentTab.<EntityName>
  • Session.CurrentTab.<EntityId>
  • Session.AnchorTab.<EntityName>
  • Session.AnchorTab.<EntityId>

Notiz

Die Parameter Session.CurrentTab.<Attribute> und Session.AnchorTab.<Attribute> gelten nur für Makros und nicht für Vorlagen.

Platzhalterfelder für Vorlagen

Dies ist eine Liste der unterstützten Platzhalterfelder:

Slug Beschreibung des Dataflows
{anchor.<attribute_name>} Wird verwendet, um auf Attribute des Datensatzes zuzugreifen, der auf der Ankerregisterkarte geladen wird.
{customerName} Der Name des Kunden, der die Unterhaltung eingeleitet hat.
{caseId} Der eindeutige Bezeichner der Anfrage. Das System zeigt die ID der Anfrage nur an, wenn die Anfrage mit der Unterhaltung verknüpft ist.
{caseTitle} Der Titel der Anfrage. Das System zeigt den Titel der Anfrage nur an, wenn die Anfrage mit der Unterhaltung verknüpft ist.
{queueId} Der eindeutige Bezeichner der Warteschlange. Diese alphanumerische Zeichenfolge wird in der URL der Warteschlangenseite angezeigt.
{visitorLanguage} Die Sprache des Kunden, der die Unterhaltung gestartet hat.
{visitorDevice} Das Gerät des Kunden, der die Unterhaltung gestartet hat.
{entityRoutingLogicalName} Der Name der Entität, wenn die Benachrichtigung für einen Entitätsdatensatz bestimmt ist.
{entityRoutingRecordId} Der eindeutige Bezeichner des Entitätsdatensatzes, wenn die Benachrichtigung für einen Entitätsdatensatz bestimmt ist.
{customerRecordId} Die eindeutige ID der Entität (Kontakt oder Konto), wenn der Kunde authentifiziert ist.
{<name of the pre-chat survey questions>} Bei allen Fragen innerhalb einer Umfrage vor dem Chat, die für einen Arbeitsstream konfiguriert sind, wird der Platzhalterfeldname als Name der Abfrage verwendet.

Format für Platzhalterfelder für Vorlagen

Das {Slug}-Parameterformat, das den Vorlagenkontext vom Kanalanbieter, der aktuellen Benutzersitzung oder Dataverse abruft. Beispiel: {caseId}

OData-Abfragen

Sie können OData-Abfragen verwenden, um die Kontexte abzurufen, die in Dataverse verfügbar sind.

Das OData-Abfragenformat ist:

{$odata.<entityName>.<entityAttributeName>.<?options>}

Beispiele:

  • {$odata.account.name.?$filter=accountid eq '{customerRecordId}'}
  • {$odata.incident.prioritycode.?$filter=incidentid eq '{caseId}'&$select=prioritycode}
  • {$odata.incident.title.?$filter=incidentid eq '{caseId}'&$select=title}

Statische Werte

Hierbei handelt es sich um hartcodierte Werte, die Sie gemäß Ihren Geschäftsanforderungen aktualisieren. Für jedes hartcodierte Attribut, das Sie auswählen, folgen Sie dem Formattyp für das entsprechende Attribut.

Beispiel (Makro):

Sie möchten, dass ein Falltitel immer mit Contoso - angehängt wird. Sie verwenden die Aktion Neues Formular zur Datensatzerstellung öffnen mit folgenden Feldern.

Parameter Wert
Logischer Entitätsname incident
Attributname Falltitel
Attributwert Contoso - {caseTitle}

Hier ist Contoso - der hartcodierte statische Wert.

Beispiel (Vorlagen):

Für eine eingehende Chatanforderung möchten Sie den statischen Titel für die Sitzung und die Benachrichtigungsvorlage bereitstellen, die Agenten zur Laufzeit sehen.

Benachrichtigungstitel = New chat request

Sitzungstitel = Chat conversation

Siehe auch

Verwalten von Sitzungsvorlagen
Verwalten von Anwendungsregisterkarten-Vorlagen
Verwalten von Benachrichtigungsvorlagen
Zuweisen von Vorlagen mit Arbeitsstreams