Automatiseringswoordenboek gebruiken om parametersleutels door te geven
In de automatiseringswoordenlijst worden de contextuele gegevens voor sessies bijgehouden. U kunt de sleutels uit het automatiseringswoordenboek gebruiken om de parameter in een actie door te geven.
Bij het maken van sjablonen en macro's in de beheer-app kunt u parametersleutels doorgeven, zoals de titel van een sessie, de titel van de melding, de titel van een toepassingstabbladsjabloon en aangepaste parameterwaarden voor typen toepassingstabbladen. Deze sleutels worden vervangen op basis van de contextuele informatie die beschikbaar is op het moment van uitvoering.
Gegevensparameter doorgeven in sjablonen
Laten we een scenario voor sjablonen met de meldingen bekijken.
De melding toont bepaalde velden en waarden, die respectievelijk Veldkop en Waarde worden genoemd.
Kenny Smith, een klant, is een gesprek begonnen en als de agent de melding ziet, wordt bij Klantnaam de waarde Kenny Smith weergegeven.
Hier is Klantnaam de waarde bij Veldkop en wordt Kenny Smith weergegeven bij Waarde.
Als sjablonen de naam van de klant als Kenny Smit moeten identificeren, moet u (de beheerder) de parameter als sleutels doorgeven.
Op dezelfde manier kunt u de gegevensparameters doorgeven voor sessie- en meldingstitels. Meer informatie: Indelingen in Automatiseringswoordenboek voor gegevensparametersleutels
Het systeem vervangt deze parametersleutels door de werkelijke waarden op basis van de context van de sessie, kanaalprovider, Microsoft Dataverse en gebruikersacties. Meer informatie: Typen contextgegevensparameters
Gegevensparameter doorgeven in macro's en agentscripts
Macro's zijn een reeks geconfigureerde opeenvolgende acties die op aanvraag door de gebruiker worden uitgevoerd. Als beheerder moet u de acties configureren die een macro moet uitvoeren. Als u de acties wilt configureren, moet u de gegevensparameters doorgeven. Meer informatie: Indelingen in Automatiseringswoordenboek voor het doorgeven van gegevensparametersleutels.
Als de agent de macro uitvoert, vervangt het systeem deze parametersleutels door de werkelijke waarden op basis van de context van de sessie, kanaalprovider, Dataverse en gebruikersacties.
Wanneer de context afkomstig is van een sessie, wordt de macroactie uitgevoerd op basis van de informatie voor een huidige sessie, waarbij de informatie wordt verkregen van een tabblad Anker of een huidig tabblad dat in focus is. Als u bijvoorbeeld een aanvraag wilt maken, moet u de acties definiëren die het formulier voor de incidententiteit en de GUID van het formulier bevatten (optioneel). Meer informatie: Typen contextgegevensparameter
Typen contextgegevensparameters
Het automatiseringswoordenboek gebruikt de contextgegevensparameters die beschikbaar zijn uit de volgende bronnen:
- Contextgegevens van de kanaalprovider
- Contextgegevens van gebruikersacties
- Contextgegevens van Dataverse
- Contextgegevens van andere macroacties
Contextgegevens van de kanaalprovider
Deze contextgegevens zijn afkomstig van de first-party kanaalprovider, zoals Omnichannel voor Customer Service of een externe kanaalprovider die de widget gebruikt die wordt weergegeven door het kanaalintegratieframework voor Dynamics 365. De contextgegevens van Omnichannel voor Customer Service zijn onderzoek vóór het gesprek, navigatie in bezoekersportal enzovoort.
Contextgegevens van gebruikersacties
Deze gegevens worden ingevuld als en wanneer agenten bepaalde activiteiten in de sessie uitvoeren. Een voorbeeld is het openen van een nieuwe klantrecord, case enzovoort.
Contextgegevens van Dataverse
De organisatiegegevens worden opgeslagen in Dataverse en u kunt de gegevens ophalen met behulp van OData-query's. Meer informatie: OData-query's
Contextgegevens van andere macroacties
Een actie in een macro genereert contextgegevens die worden gebruikt door andere acties in die macro.
Er zijn bijvoorbeeld twee actiestappen in deze volgorde:
- Open een nieuw formulier om een record te maken.
- Open een e-mailformulier met een vooraf gedefinieerde sjabloon.
Tijdens het maken van de actie Een e-mailformulier met vooraf gedefinieerde sjabloon openen kunt u de contextgegevensparametersleutels ophalen vanuit de macroactiestap Een nieuw formulier openen om een record te maken.
De contextgegevensparameter van de eerste macroactie is als volgt:
- Logische naam entiteit
- Paginatype
- Tabblad-id
Notitie
De contextgegevensparameters van andere macroacties zijn specifiek voor macro's en zijn niet van toepassing op sjablonen.
Automatiseringswoordenboek voor het doorgeven van gegevensparametersleutels
In de automatiseringswoordenlijst worden de contextuele gegevens voor sessies bijgehouden. De sleutels in het automatiseringswoordenboek kunnen worden doorgegeven als parameters aan de actie in macro's. Het systeem vervangt deze parametersleutels door de werkelijke waarde op basis van de context van de sessie, kanaalprovider, Dataverse en gebruikersacties.
Het automatiseringswoordenboek ondersteunt de volgende indelingen:
Gegevensvelden
Een gegevensveld is een vervangende parameter die door het systeem tijdens runtime wordt ingevuld op basis van context. Gebruik de volgende lijst met gegevensvelden alleen voor macro's en agentscripts en om een agentscript als standaard in te stellen met behulp van de opbouwfunctie voor expressies voor agentscripts. Meer informatie: Productiviteitshulpprogramma's
Gegevensvelden voor productiviteitstools (macro's en agentscripts)
Macro's en agentscripts ondersteunen de volgende gegevensvelden:
| Gegevensveld | Beschrijving |
|---|---|
${customerName} |
De naam van de klant die het gesprek heeft geïnitieerd. |
${caseId} |
De unieke id van een aanvraag. De aanvraag-id wordt alleen weergegeven als een aanvraag aan het gesprek is gekoppeld. |
${caseTitle} |
De titel van de aanvraag. De titel van de aanvraag wordt alleen weergegeven als de aanvraag aan het gesprek is gekoppeld. |
${LiveWorkItemId} |
De unieke id van het gesprek. |
${queueId} |
De unieke id van een wachtrij. Deze alfanumerieke reeks wordt weergegeven in de URL van de wachtrijpagina. |
${visitorLanguage} |
De taal van de klant die het gesprek is begonnen. |
${visitorDevice} |
Het apparaat van de klant die het gesprek is begonnen. |
${entityRoutingLogicalName} |
De naam van de entiteit, als de melding voor een entiteitsrecord is. |
${customerEntityName} |
De naam van de entiteit (contactpersoon of account), als de klant is geverifieerd. |
${customerRecordId} |
De unieke id van de entiteit (contactpersoon of account), als de klant is geverifieerd. |
${<name of the pre-conversation survey questions>} |
Alle onderzoeksvragen voorafgaand aan het gesprek die zijn geconfigureerd voor een werkstroom gebruiken de naam van het gegevens als de naam van de vraag. |
Notitie
Alleen het gegevensveld ${anchor.<attribute_name>} wordt ondersteund in de macro's en scripts voor Customer Service workspace.
Gegevensveld voor herverbindingskoppeling
Het volgende gegevensveld wordt gebruikt om een herverbindingskoppeling te genereren die met klanten kan worden gedeeld om weer verbinding te maken met dezelfde agent en hetzelfde gesprek. Meer informatie: Een herverbinding met een eerdere chat configureren
| Gegevensveld | Beschrijving |
|---|---|
{ReconnectUrl{ReconnectID}} |
Gebruikt in snelle antwoorden om de herverbindingskoppeling te genereren. |
Indeling voor gegevensvelden voor productiviteitstools
De ${Slug}-parameterindeling die de context ophaalt van de kanaalprovider, de huidige gebruikerssessie, uitvoer van andere macroacties of Dataverse.
Context van productiviteitsautomatisering
Als u een gegevensveld wilt uitvoeren in de productiviteitsautomatiseringscontext, die wordt gebruikt om bewerkingen uit te voeren met betrekking tot modelgestuurde apps in Dynamics 365, gebruikt u de indeling ${</slug/>} Bijvoorbeeld: ${customerName}
Context van sessieconnector
Als u een gegevensveld in de sessiecontext wilt uitvoeren, moet u de indeling ${$session.<slug>} gebruiken. Bijvoorbeeld: ${$session.customerName}
Tot de gegevensvelden die beschikbaar zijn voor de sessiecontext behoren:
${$session.visitorDevice}${$session.visitorDevice}${$session.entityRoutingLogicalName}${$session.entityRoutingRecordId}${$session.<name of the pre-chat survey questions>
Context van Omnichannel-connector
Als u een gegevensveld in de context van Omnichannel voor Customer Service wilt uitvoeren, moet u de indeling ${$oc.<slug>} gebruiken. Bijvoorbeeld: ${$oc.customerName}
De parameters Session.CurrentTab.<Attribute> en Session.AnchorTab.<Attribute> bieden contextgegevens op basis van de huidige sessie en het ankertabblad of het huidige tabblad in focus. Hieronder volgen de ondersteunde kenmerktypen:
- EntityName
- EntityId
Voorbeelden:
Session.CurrentTab.<EntityName>Session.CurrentTab.<EntityId>Session.AnchorTab.<EntityName>Session.AnchorTab.<EntityId>
Notitie
De parameters Session.CurrentTab.<Attribute> en Session.AnchorTab.<Attribute> zijn alleen van toepassing op macro's, niet op sjablonen.
Gegevensvelden voor sjablonen
De lijst met ondersteunde gegevensvelden zijn:
| Gegevensveld | Omschrijving |
|---|---|
{anchor.<attribute_name>} |
Wordt gebruikt om toegang te krijgen tot kenmerken van de record die in het ankertabblad is geladen. |
{customerName} |
De naam van de klant die het gesprek heeft geïnitieerd. |
{caseId} |
De unieke id van een aanvraag. De aanvraag-id wordt alleen weergegeven als de aanvraag aan het gesprek is gekoppeld. |
{caseTitle} |
De titel van de aanvraag. De titel van de aanvraag wordt alleen weergegeven als de aanvraag aan het gesprek is gekoppeld. |
{queueId} |
De unieke id van een wachtrij. Deze alfanumerieke reeks wordt weergegeven in de URL van de wachtrijpagina. |
{visitorLanguage} |
De taal van de klant die het gesprek is begonnen. |
{visitorDevice} |
Het apparaat van de klant die het gesprek is begonnen. |
{entityRoutingLogicalName} |
De naam van de entiteit, als de melding voor een entiteitsrecord is. |
{entityRoutingRecordId} |
De unieke id van de entiteitsrecord, als de melding voor een entiteitsrecord is. |
{customerRecordId} |
De unieke id van de entiteit (contactpersoon of account), als de klant is geverifieerd. |
{<name of the pre-chat survey questions>} |
Alle onderzoeksvragen voorafgaand aan de chat die zijn geconfigureerd voor een werkstroom gebruiken de naam van het gegevens als de naam van de vraag. |
Indeling van gegevensvelden voor sjablonen
De {Slug}-parameterindeling die de sjablooncontext ophaalt van de kanaalprovider, de huidige gebruikerssessie of Dataverse. Bijvoorbeeld: {caseId}
OData-query's
U kunt OData-query's gebruiken om de contexten op te halen die beschikbaar zijn van Dataverse.
De indeling van de OData-query is:
{$odata.<entityName>.<entityAttributeName>.<?options>}
Voorbeelden:
{$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 waarden
Dit zijn hard gecodeerde waarden die u bijwerkt op basis van uw zakelijke vereisten. Volg voor elk hard gecodeerd kenmerk dat u kiest het indelingstype voor dat specifieke kenmerk.
Voorbeeld (Macro):
U wilt dat aan een aanvraagtitel altijd Contoso - wordt toegevoegd. U gebruikt de actie Een nieuw formulier openen om een record te maken met de volgende velden.
| Parameter | Waarde |
|---|---|
| Logische naam van entiteit | incident |
| Kenmerknaam | Aanvraagtitel |
| Kenmerkwaarde | Contoso - {caseTitle} |
Hier is Contoso - de hard gecodeerde statische waarde.
Voorbeeld (Sjablonen):
Voor een inkomend chatverzoek wilt u de statische titel opgeven voor de sessie- en meldingssjabloon die agenten tijdens runtime zien.
Meldingstitel = New chat request
Sessietitel = Chat conversation
Zie ook
Sessiesjablonen beheren
Sjablonen voor toepassingstabbladen beheren
Meldingssjablonen beheren
Sjablonen aan werkstromen koppelen