Del via


Bruk automatiseringsordlisten til å sende parameternøkler

Automatiseringsordlisten vedlikeholder kontekstavhengige data for økter. Du kan bruke nøklene fra automatiseringsordlisten til å sende parameteren i en handling.​

Når du oppretter maler og makroer i administratorappen, kan du sende parameternøkler som tittel for en økt, tittel for varsling, tittel for en programkategorimal og egendefinerte parameterverdier for programkategorityper. Disse nøklene erstattes basert på den kontekstavhengige informasjonen som er tilgjengelig under kjøringen.

Sende dataparametere i maler

La oss ta et scenario for maler med varslene.

Varselet viser bestemte felt og verdier som kalles henholdsvis for Felttopptekst og Verdi.

Kenny Smith, en kunde, startet en diskusjon og når agenten ser meldingen, viser den Kundenavn som Kenny Smith.

Her er Felttopptekst Kundenavn og Verdi er Kenny Smith.

For at maler skal kunne identifisere navnet på kunden som Kenny Smith, må du (administrator) sende parameteren som nøkler.

På samme måte kan du overføre dataparameterne for økt- og varslingstitler. Mer informasjon: Automatiseringsordlisteformater for dataparameternøkler

Disse parameternøklene erstattes med de faktiske verdiene basert på konteksten for økt, kanalleverandør, Microsoft Dataverse og brukerhandlinger. Mer informasjon: Typer kontekstdataparametere

Sende dataparametere i makroer og agentskript

Makroer er et sett med konfigurerte sekvensielle handlinger som kjøres ved behov av brukeren. Som administrator må du konfigurere handlingene som en makro må utføre. Hvis du vil konfigurere handlingene, må du sende dataparameterne. Mer informasjon: Automatiseringsordlisteformater for å sende dataparameternøkler

Når agenten kjører makroen, erstatter systemet disse parameternøklene med de faktiske verdiene basert på konteksten for økt, kanalleverandør, Dataverse og brukerhandlinger.

Når konteksten kommer fra en økt, kjøres makrohandlingen basert på informasjonen i en gjeldende økt, der informasjonen hentes fra en ankerkategori eller gjeldende kategori som er i fokus. Hvis du for eksempel vil opprette en sak, må du definere handlingene som inneholder skjemaet for hendelsesenheter, og GUID-en for skjemaet (valgfritt). Mer informasjon: Typer kontekstdataparameter

Typer kontekstdataparametere

Automatiseringsordlisten bruker kontekstdataparameterne som er tilgjengelige fra følgende kilder:

Automatiseringsordliste.

Kontekstdata fra kanalleverandøren

Disse kontekstdataene er fra den førsteparts kanalleverandøren, for eksempel Omnikanal for Customer Service, eller en tredjeparts kanalleverandør som bruker kontrollprogrammet som vises av Kanalintegreringsrammeverk for Dynamics 365. Kontekstdataene fra Omnikanal for Customer Service er evaluering før samtale, navigasjon i gjesteportal og så videre.

Kontekstdata fra brukerhandlinger

Disse dataene fylles ut etter hvert som og når agenter utfører enkelte aktiviteter i økten. Et eksempel er å åpne en ny kundeoppføring, sak og så videre.

Kontekstdata fra Dataverse

Organisasjonsdataene lagres i Dataverse, og du kan hente dataene med bruk av OData-spørringer. Mer informasjon: OData-spørringer

Kontekstdata fra andre makrohandlinger

En handling i en makro genererer kontekstdata som brukes av andre handlinger i makroen.

Det er for eksempel to handlingstrinn i følgende rekkefølge:

  1. Åpne et nytt skjema for å opprette en oppføring.
  2. Åpne et e-postskjema med en forhåndsdefinert mal.

Når du oppretter handlingen Åpne et e-postskjema med forhåndsdefinertmal, kan du hente kontekstdataparameternøkler fra det åpne handlingstrinnet Åpne et nytt skjema for å opprette en oppføring i makroen.

Kontekstdataparameteren fra den første makrohandlingen er som følger:

  • Logisk navn på enhet
  • Sidetype
  • Kategori-ID

Merk

Kontekstdataparameterne fra andre makrohandlinger er spesifikke for makroer, og gjelder ikke for maler.

Automatiseringsordlisteformater for å sende dataparameternøkler

Automatiseringsordlisten vedlikeholder kontekstavhengige data for økter. Nøklene i automatiseringsordlisten kan sendes som parametere til handlingen makroer. Disse parameternøklene erstattes med den faktiske verdien basert på konteksten for økt, kanalleverandør, Dataverse og brukerhandlinger.

Automatiseringsordlisten støtter følgende formater:

Plassholdere

En plassholder er en erstatningsparameter som systemet fyller ut ved kjøretid basert på konteksten. Bruk følgende liste over plassholdere bare for makroer og agentskript og til å angi et agentskript som standard ved hjelp av uttrykksverktøyet for agentskript. Mer informasjon: Produktivitetsverktøy

Plassholdere for produktivitetsverktøy (makroer og agentskript)

Makroer og agentskript støtter følgende dynamiske datainger:

Plassholder Beskrivelse
${customerName} Navnet på kunden som startet diskusjonen.
${caseId} Den unike ID-en til en sak. Systemet viser saks-ID-en bare hvis en sak er koblet til diskusjonen.
${caseTitle} Tittelen på saken. Systemet viser tittelen på saken bare hvis saken er koblet til diskusjonen.
${LiveWorkItemId} Den unike ID-en for samtalen.
${queueId} Den unike ID-en for en kø. Denne alfanumeriske strengen vises på URL-adressen til køsiden.
${visitorLanguage} Språket til kunden som startet diskusjonen.
${visitorDevice} Enheten til kunden som startet diskusjonen.
${entityRoutingLogicalName} Navnet på enheten hvis varslingen gjelder en enhetsoppføring.
${customerEntityName} Navnet på enheten (kontakt eller forretningsforbindelse) hvis kunden godkjennes.
${customerRecordId} Den unike ID-en til enheten (kontakt eller forretningsforbindelse) hvis kunden godkjennes.
${<name of the pre-conversation survey questions>} Alle spørsmål i evalueringen før samtalen som er konfigurert for en arbeidsflyt, vil ha plassholdernavnet som navnet på spørsmålet.

Merk

Bare plassholderen ${anchor.<attribute_name>} støttes i makroer og skript for Customer Service workspace.

Den følgende plassholderen brukes til å generere en kobling for ny tilkobling som kan deles med kunder for å koble tilbake til samme agent og diskusjon. Mer informasjon: Konfigurere en ny tilkobling til en tidligere chat

Plassholder Beskrivelse
{ReconnectUrl{ReconnectID}} Brukes i hurtigsvar til å generere koblingen for ny tilkobling.

Format for plassholdere for produktivitetsverktøy

Parameterformatet ${Slug} som henter kontekten fra kanalleverandøren, gjeldende brukerøkt, utdata fra andre makrohandlinger eller Dataverse.

Kontektst for produktivitetsautomatisering

Når du vil kjøre en plassholder i konteksten for produktivitetsautomatisering, som brukes til å utføre operasjoner relatert til modelldrevne apper i Dynamics 365, bruker du formatet ${</slug/>} Eksempel: ${customerName}

Kontekst for øktkobling

Når du vil kjøre en plassholder i øktkontekst, må du bruke formatet ${$session.<slug>}. Eksempel: ${$session.customerName}

Plassholdere som er tilgjengelige for øktkonteksten, omfatter følgende:

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

Kontekst for omnikanalkobling

Når du vil kjøre en plassholder i kontekst for Omnikanal for Customer Service, må du bruke formatet ${$oc.<slug>}. Eksempel: ${$oc.customerName}

Parameterne Session.CurrentTab.<Attribute> og Session.AnchorTab.<Attribute> gir kontekstdata basert på den gjeldende økten og ankerkategorien eller den gjeldende kategorien som er i fokus. Følgende attributtyper støttes.

  • EntityName
  • EntityId

Eksempler:

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

Merk

Parameterne Session.CurrentTab.<Attribute> og Session.AnchorTab.<Attribute> gjelder bare for makroer og gjelder ikke for maler.

Plassholdere for maler

Listen over støttede plassholdere er:

Plassholder Bekrivelse
{anchor.<attribute_name>} Brukes til å få tilgang til attributter for oppføringen som lastes inn i ankerkategorien.
{customerName} Navnet på kunden som startet diskusjonen.
{caseId} Den unike ID-en til en sak. Systemet viser saks-ID-en bare hvis saken er koblet til diskusjonen.
{caseTitle} Tittelen på saken. Systemet viser tittelen på saken bare hvis saken er koblet til diskusjonen.
{queueId} Den unike ID-en for en kø. Denne alfanumeriske strengen vises på URL-adressen til køsiden.
{visitorLanguage} Språket til kunden som startet diskusjonen.
{visitorDevice} Enheten til kunden som startet diskusjonen.
{entityRoutingLogicalName} Navnet på enheten hvis varslingen gjelder en enhetsoppføring.
{entityRoutingRecordId} Den unike ID-en til enhetsoppføringen hvis varslingen gjelder en enhetsoppføring.
{customerRecordId} Den unike ID-en til enheten (kontakt eller forretningsforbindelse) hvis kunden godkjennes.
{<name of the pre-chat survey questions>} Alle spørsmål i undersøkelsen før chat som er konfigurert for en arbeidsstrøm, vil ha plassholdernavnet som navnet på spørsmålet.

Format for plassholdere for maler

Parameterformatet {Slug} som henter malkonteksten fra kanalleverandøren, gjeldende brukerøkt, eller Dataverse. Eksempel: {caseId}

OData-spørringer

Du kan bruke OData-spørringer til å hente kontekstene som er tilgjengelige fra Dataverse.

OData-spørringsformatet er som følger:

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

Eksempler:

  • {$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}

Statiske verdier

Dette er hardkodede verdier som du oppdaterer basert på kravene til virksomheten. Følg formattypen for det bestemte attributtet for hvert hardkodet attributt du velger.

Eksempel (makro):

Du vil at en sakstittel alltid skal legges til med Contoso. Du bruker handlingen Åpne et nytt skjema for å opprette en oppføring med følgende felt.

Parameter Verdi
Logisk navn for enhet incident
Attributtnavn Sakstittel
Attributtverdi Contoso - {caseTitle}

Her er Contoso - den hardkodede statiske verdien.

Eksempel (maler):

For en innkommende chatteforespørsel vil du gi den statiske tittelen til økten og varslingsmalen som agenter kan se under kjøring.

Varslingstittel = New chat request

Økttittel = Chat conversation

Se også

Administrere øktmaler
Adminisrere programkategorimaler
Administrere varslingsmaler
Knytte maler til arbeidsflyter