Använd automatiseringsordlistan för att skicka parameternycklar
Automatiseringsord listan underhåller kontextuella sessionsdata. Du kan använda nycklarna från automatiserad ordlista för att skicka parametern i en åtgärd.
När du skapar mallar och makron i administratörsappen kan du skicka parameternycklar som rubrik till en session, meddelanderubrik, rubrik på en flikmall för ett program och anpassade parametervärden för fliktyper för program. Nycklarna ersätts med hjälp av den sammanhangsberoende informationen som är tillgänglig under körningstillfället.
Skicka dataparameter i mallar
Vi ska nu gå igenom ett scenario för mallar med aviseringarna.
I meddelandet visas vissa fält och värden som kallas Fältrubrik respektive Värde.
Kenny Svensson, en kund, startar en konversation och när handläggaren ser meddelandet visas kundnamnet som Kenny Svensson.
Här är fältrubrikenkundnamn och värdet är Kenny Svensson.
För att mallar ska kunna identifiera kundens namn som Kenny Smith måste du (administratören) skicka parametern som nycklar.
På samma sätt kan du skicka dataparametrarna för sessions- och aviseringsrubriker. Mer information finns i Format för automatiseringsordlista för dataparameternycklar
Systemet ersätter de här parameternycklarna med de faktiska värdena utifrån sammanhanget för sessionens, kanalleverantörens Microsoft Dataverse och användarnas åtgärder. Mer information finns i typer av sammanhangsdataparametrar
Skicka dataparametrar i makron och handläggarmanuskript
Makron är en uppsättning konfigurerade sekventiella åtgärder som körs på begäran av användaren. Som en administratör måste du konfigurera de åtgärder som ett makro måste utföra. För att kunna konfigurera åtgärderna måste du skicka dataparametrarna. Mer information: Format för automatiseringsordlista för att skicka dataparameternycklar
När handläggaren kör makron ersätter systemet de här parameternycklarna med de faktiska värdena utifrån sammanhanget för sessionens, kanalleverantörens Dataverse och användarnas åtgärder.
När kontexten kommer från en session körs makroåtgärden baserat på informationen för en aktuell session, där informationen hämtas från en flik för ankare eller aktuell flik som är i fokus. Om du till exempel vill skapa ett ärende måste du definiera åtgärderna som innehåller formuläret för incidententitet och GUID för formuläret (valfritt). Mer information finns i typer av sammanhangsdataparametrar
Typer av sammanhangsdataparametrar
I automatiseringsordlistan används de sammanhangsdataparametrar som är tillgängliga från följande källor:
- Sammanhangsdata som samlats in från kanalleverantören
- Sammanhangsdata från användaråtgärder
- Sammanhangsdata från Dataverse
- Sammanhangsdata från andra makroåtgärder
Sammanhangsdata som samlats in från kanalleverantören
Den här kontextinformationen kommer från den primära kanalleverantören, t.ex. Flerkanal för Customer Service eller en leverantör av tredjepartskanal som använder den widget som visas av Dynamics 365 ramverk för kanalintegration. Kontextinformationen från Flerkanal för Customer Service är en undersökning före konversation, portalnavigering och så vidare.
Sammanhangsdata från användaråtgärder
Dessa data fylls i som och när handläggarna utför några aktiviteter i sessionen. Ett exempel på detta är att öppna en ny kundpost, ärende och så vidare.
Sammanhangsdata från Dataverse
Organisationsdata lagras i Dataverse och du kan hämta data med hjälp av OData-frågor. Mer information finns i OData-frågor
Sammanhangsdata från andra makroåtgärder
En åtgärd i ett makro genererar sammanhangsdata som används av andra åtgärder i det makrot.
Det finns till exempel två åtgärdssteg i följande ordning:
- Öppna ett nytt formulär för att skapa en post.
- Öppna ett e-postformulär med en fördefinierad mall.
När du skapar åtgärden Öppna ett e-postformulär med fördefinierad mall kan du få parameternycklarna för sammanhangsdata från makroåtgärdssteget Öppna ett nytt formulär för att skapa en post.
Sammanhangsdataparametern från den första makroåtgärden är följande:
- Entitetens logiska namn
- Sidtyp
- Flik-ID
Kommentar
De sammanhangsdataparametrar från andra makroåtgärder som är specifika för makron gäller endast för mallar.
Format för automatiseringsordlista för att skicka dataparameternycklar
Automatiseringsord listan underhåller kontextuella sessionsdata. Nycklarna från automatiseringsordlistan kan skickas som parametrar till åtgärden i makron. Systemet ersätter de här parameternycklarna med de faktiska värdena utifrån sammanhanget för sessionens, kanalleverantörens Dataverse och användarnas åtgärder.
Automatiseringsordlistan stöder följande format:
Maskinsatta rader
Ett dynamiskt datafält är en ersättningsparameter som systemet fyller i vid körning baserat på kontext. Använd följande lista över dynamiska datafält endast för makron och handläggarmanuskript, samt för att ange ett handläggarmanuskript som standard med hjälp av uttrycksverktyget för handläggarmanuskript. Mer information: Produktivitetsverktyg
Dynamiska datafält för produktivitetsverktyg (makron och handläggarmanuskript)
Makro- och handläggartyp stöder följande dynamiska datafält:
| Maskinsatta rader | Beskrivning |
|---|---|
${customerName} |
Namnet på den kund som initierade kundrelationen. |
${caseId} |
Unikt ID för ett ärende. I systemet visas endast ärende-ID om ett ärende är länkat till konversationen. |
${caseTitle} |
Ärendets rubrik. I systemet visas endast ärenderubriken om ärende är länkat till konversationen. |
${LiveWorkItemId} |
Konversationens unika ID. |
${queueId} |
Unikt ID för en kö. Den alfanumeriska strängen visas i URL:en för kön. |
${visitorLanguage} |
Språket för den kund som initierade konversationen. |
${visitorDevice} |
Enheten för den kund som initierade konversationen. |
${entityRoutingLogicalName} |
Namnet på entiteten, om aviseringen gäller en entitetspost. |
${customerEntityName} |
Namnet på entiteten (kontakt eller konto), om kunden är autentiserad. |
${customerRecordId} |
Unikt ID för entiteten (kontakt eller konto), om kunden är autentiserad. |
${<name of the pre-conversation survey questions>} |
Alla undersökningsfrågorna innan konversationen som har konfigurerats för ett arbetsflöde kommer att ha datafältnamnet som namn på frågan. |
Kommentar
Endast ${anchor.<attribute_name>} dynamiskt datafält stöds i makron och skript för Customer Service workspace.
Dynamiskt datafält för återanslutningslänk
Följande dynamiska datafält används för att skapa en länk för återanslutning som kan delas med kunder för att ansluta tillbaka till samma handläggare och konversation. Mer information: Konfigurera en återanslutning till en tidigare chatt
| Maskinsatta rader | Beskrivning |
|---|---|
{ReconnectUrl{ReconnectID}} |
Används i snabba svar för att skapa återanslutningslänken. |
Format för dynamiska datafält för produktivitetsverktyg
Det ${Slug} parameterformat som hämtar kontexten från kanalleverantören, aktuell användarsession, utdata från andra makroåtgärder eller Dataverse.
Automatiserad produktivitetskontext
Om du vill köra en kula i produktivitetsautomatisering kontexten, som används för att utföra åtgärder som är relaterade till modellbaserade appar i Dynamics 365, använder du formatet ${</slug/>} Till exempel: ${customerName}
Anslutningskontext för session
När du vill köra ett dynamiskt datafält i sessionskontexten måste du använda formatet ${$session.<slug>}. Till exempel: ${$session.customerName}
Datafält som är tillgängliga för sessionskontext inkluderar:
${$session.visitorDevice}${$session.visitorDevice}${$session.entityRoutingLogicalName}${$session.entityRoutingRecordId}${$session.<name of the pre-chat survey questions>
Kopplingskontext för Flerkanal
När du vill köra ett dynamiskt datafält i kontext för Flerkanal för Customer Service måste du använda formatet ${$oc.<slug>}. Till exempel: ${$oc.customerName}
Parametrarna Session.CurrentTab.<Attribute> och Session.AnchorTab.<Attribute> tillhandahåller sammanhangsdata baserade på den aktuella sessionen och den fästpunktsflik eller aktuell flik som står i fokus. Följande versioner är de som stöds av attributtyper.
- EntityName
- EntityId
Exempel:
Session.CurrentTab.<EntityName>Session.CurrentTab.<EntityId>Session.AnchorTab.<EntityName>Session.AnchorTab.<EntityId>
Kommentar
Parametrarna Session.CurrentTab.<Attribute> och Session.AnchorTab.<Attribute> gäller endast för makron och inte för mallar.
Dynamiska datafält för mallar
Lista över maskinsatta rader som stöds
| Dynamiskt datafält | Beskrivning |
|---|---|
{anchor.<attribute_name>} |
Används för att komma åt de attribut för en post som har lästs in på fliken ankare. |
{customerName} |
Namnet på den kund som initierade kundrelationen. |
{caseId} |
Unikt ID för ett ärende. I systemet visas endast ärende-ID om ärendet är länkat till konversationen. |
{caseTitle} |
Ärendets rubrik. I systemet visas endast ärenderubriken om ärende är länkat till konversationen. |
{queueId} |
Unikt ID för en kö. Den alfanumeriska strängen visas i URL:en för kön. |
{visitorLanguage} |
Språket för den kund som initierade konversationen. |
{visitorDevice} |
Enheten för den kund som initierade konversationen. |
{entityRoutingLogicalName} |
Namnet på entiteten, om aviseringen gäller en entitetspost. |
{entityRoutingRecordId} |
Unikt ID för entiteten, om aviseringen gäller en entitetspost. |
{customerRecordId} |
Unikt ID för entiteten (kontakt eller konto), om kunden är autentiserad. |
{<name of the pre-chat survey questions>} |
Alla frågor som har konfigurerats för ett arbetsflöde kommer att ha namnet maskinsatt rad. som namn på frågan. |
Format för dynamiska datafält för mallar
Det {Slug} parameterformat som hämtar mallkontexten från kanalleverantör, aktuell användarsession eller Dataverse. Till exempel: {caseId}
OData-frågor
Du kan använda OData-frågor för att få de kontexter som är tillgängliga Dataverse.
OData-frågeformat:
{$odata.<entityName>.<entityAttributeName>.<?options>}
Exempel:
{$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}
Statiska värden
Dessa är hårdkodade värden som du uppdaterar baserat på dina affärskrav. För varje hårdkodat attribut som du väljer följer du formattypen för det aktuella attributet.
Exempel (makro):
En ärenderubrik ska alltid få tillägget Contoso -. Använd åtgärden Öppna ett nytt formulär om du vill skapa en post med följande fält.
| Parameter | Värde |
|---|---|
| Logiskt namn för entitet | incident |
| Attributnamn | Ärenderubrik |
| Attributvärde | Contoso - {caseTitle} |
Här är Contoso ett hårdkodat statiskt värde.
Exempel (mallar):
För inkommande chattförfrågan ska du ange den statiska rubriken på den session och de aviseringsmall som handläggarna ser vid körning.
Aviseringsrubik = New chat request
Sessionsrubrik = Chat conversation
Se även
Hantera sessionsmallar
Hantera programfliksmallar
Hantera aviseringsmallar
Associera mallar med arbetsströmmar