Бөлісу құралы:


Параметр кілттерін беру үшін автоматтандыру сөздігін пайдаланыңыз

Автоматтандыру сөздігі сеанстарға арналған мәтінмәндік деректерді сақтайды. Параметрді әрекетке беру үшін автоматтандыру сөздігіндегі пернелерді пайдалануға болады.​

Әкімші қолданбасында үлгілер мен макростарды жасау кезінде сеанс тақырыбы, хабарландыру тақырыбы, қолданба қойындысының үлгісінің тақырыбы және қолданба қойындысының түрлері үшін теңшелетін параметр мәндері сияқты параметр кілттерін беруге болады. Бұл кілттер орындау кезінде қол жетімді контексттік ақпарат негізінде ауыстырылады.

Үлгілердегі деректер параметрін өткізу

Хабарландырулары бар үлгілерге арналған сценарийді алайық.

Хабарландыру сәйкесінше Өріс тақырыбы және Мән деп аталатын белгілі бір өрістер мен мәндерді көрсетеді.

Кенни Смит, тұтынушы сөйлесуді бастады және агент хабарландыруды көргенде, ол Тұтынушының аты-жөні ретінде Кенни Смит көрсетеді.

Мұнда, Өріс тақырыбыТұтынушы аты және Мән бұл Кенни Смит.

Тұтынушының атын Kenny Smith ретінде анықтау үшін үлгілер үшін сіз (әкімші) параметрді кілттер ретінде беруіңіз керек.

Сәйкесінше сеанс және хабарландыру тақырыптары үшін сіз деректер параметрлерін бере аласыз. Қосымша ақпарат: Деректер параметрінің кілттеріне сөздік пішімдерін автоматтандыру

Жүйе осы параметр кілттерін сеанс контекстіне, арна провайдеріне, Microsoft Dataverse және пайдаланушы әрекеттеріне алмастырады. Қосымша ақпарат: Мәтінмәндік деректер параметрлерінің түрлері

Макростарда және агент сценарийлерінде деректер параметрін беру

Макростар — пайдаланушы сұрауы бойынша іске қосылатын теңшелген реттік әрекеттер жинағы. Әкімші ретінде макрос орындауы қажет әрекеттерді конфигурациялауыңыз керек. Әрекеттерді конфигурациялау үшін деректер параметрлерін беру керек. Қосымша ақпарат: Дерек параметрінің кілттерін беру үшін сөздік пішімдерін автоматтандыру

Агент макросты іске қосқан кезде, жүйе осы параметр кілттерін сеанс контекстіне, арна провайдеріне, Dataverse және пайдаланушы әрекеттеріне алмастырады.

Мәтінмән сеанстан болған кезде фокусталған Бекіту қойыншасынан немесе ағымдағы қойыншадан ақпарат алынатын ағымдағы сеанс ақпаратына байланысты макрос әрекеті іске қосылады. Мысалы, істі жасау үшін оқиға нысанының пішіні мен пішіннің GUID мекенжайын қамтитын әрекеттерді анықтау керек (міндетті емес). Қосымша ақпарат: Мәтінмәндік деректер параметрінің түрлері

Контексттік деректер параметрлерінің түрлері

Автоматтандыру сөздігінде келесі көздерден қол жетімді контексттік деректер параметрлерін қолданады:

Автоматтандыру сөздігі.

Арна провайдерлеріндегі контексттік деректер

Бұл мәтінмәндік деректер Тұтынушыға қызмет көрсетуге арналған омни-арна сияқты бірінші тарап арна провайдерінен немесе Dynamics 365 арна біріктіру платформасында көрсетілген виджетті пайдаланатын үшінші тарап арна провайдерінен алынады. Customer Service омниарнасы мәтінмәндік деректері әңгіме алдындағы сауалнама, келушілер порталын шарлау және т.б.

Пайдаланушы әрекеттеріндегі мәтінмәндік деректер

Бұл деректер сеанста қандай да бір әрекеттерді орындаған кезде және толтырылады. Мысал жаңа тұтынушының жазбасын, істі және т.б. ашады.

Dataverse ішіндегі контексттік деректер

Ұйымдастырушылық деректер Dataverse ішінде сақталады және сіз OData сұрауларын қолдана отырып деректерді шығарып ала аласыз. Қосымша ақпарат: OData сұраулары

Басқа макрос әрекеттеріндегі контексттік деректер

Макростағы әрекет осы макростағы басқа әрекеттермен тұтынылатын мәтінмәндік деректерді жасайды.

Мысалы, келесі тапсырыста екі әрекет қадамы бар:

  1. Жазба жасау үшін жаңа пішінді ашу.
  2. Алдын ала анықталған үлгісі бар электрондық хабарды ашыңыз.

Алдын ала анықталған үлгімен электрондық пошта пішінін ашу әрекетін жасау кезінде мәтінмәндік деректер параметрінің кілттерін Жаңа пішінді жасау үшін ашу бөлімінен алуға болады. жазу макрос әрекет қадам.

Бірінші макрос әрекетіндегі контексттік деректер параметрі келесідей:

  • Нысанның логикалық атауы
  • Бет түрі
  • Қойынша идентификаторы

Ескертпе

Басқа макрос әрекеттеріндегі мәтінмәндік деректер параметрлері макростарға тән және үлгілерге қолданылмайды.

Деректер параметрінің кілттерін беру үшін сөздік пішімдерін автоматтандыру

Автоматтандыру сөздігі сеанстарға арналған мәтінмәндік деректерді сақтайды. Автоматика сөздігіндегі кілттерді макростардағы әрекетке параметрлер ретінде беруге болады. Жүйе осы параметр кілттерін сеанс контекстіне, арна провайдеріне, Dataverse және пайдаланушы әрекеттеріне негізделген нақты мәнмен алмастырады.

Автоматика сөздігі келесі форматтарды қолдайды:

Бөліктер

A slug бұл жүйе контекст негізінде орындалу уақытында толтырылатын ауыстыру параметрі. Келесі бөліктер тізімін тек макрос пен агент сценарийлері үшін қолданыңыз және агент сценарийінің өрнек құрушысын қолдана отырып агент сценарийін әдепкі ретінде орнату үшін пайдаланыңыз. Қосымша ақпарат: Өнімділік құралдары

Өнімділік құралдарына арналған жиындар (макрос және агент сценарийлері)

Макростар мен агент сценарийлерінде мына жиындарға қолдау көрсетіледі:

Бөлік Сипаттама
${customerName} Сөйлесуді бастаған тұтынушы аты.
${caseId} Істің бір мәнді идентификаторы. Жүйе іс идентификаторын іс сөйлесумен байланыстырылған болса ғана көрсетеді.
${caseTitle} Іс тақырыбы. Жүйе іс тақырыбын іс сөйлесумен байланыстырылған болса ғана көрсетеді.
${LiveWorkItemId} Әңгімелесудің бірегей идентификаторы.
${queueId} Кезек тізімінің бір мәнді идентификаторы. Бұл әріптік-сандық жол кезек тізімі бетінің URL мекенжайында көрсетіледі.
${visitorLanguage} Сұхбатты бастаған тұтынушының сөйлесу тілі.
${visitorDevice} Сұхбатты бастаған тұтынушы құрылғысы.
${entityRoutingLogicalName} Хабарландыру нысан жазбасына арналған болса, нысан атауы.
${customerEntityName} Егер тұтынушы расталған болса, нысан атауы (контакт немесе тіркелгі).
${customerRecordId} Егер тұтынушы расталған болса, нысанның бір мәнді идентификаторы (контакт немесе тіркелгі).
${<name of the pre-conversation survey questions>} Жұмыс ағыны үшін конфигурацияланған барлық сөйлесу алдындағы сауалнама сұрақтарында сұрақтың аты ретінде слог атауы болады.

Ескертпе

Тұтынушыға қызмет көрсету жұмыс кеңістігіне арналған макростар мен сценарийлерде тек ${anchor.<attribute_name>} слагқа қолдау көрсетіледі.

Келесі бөлік ұқсас агент пен сұхбатқа қайта қосылу мақсатында тұтынушылармен бөлісуге болатын қайта қосу сілтемесін құру үшін пайдаланылады. Қосымша ақпарат: Алдыңғы чатқа қайта қосылуды конфигурациялаңыз

Бөлік Сипаттама
{ReconnectUrl{ReconnectID}} Қайта қосу сілтемесін құру үшін жылдам жауап беруде пайдаланылады.

Өнімділік құралдарының бөліктеріне арналған пішін

Арна провайдерінен, ағымдағы пайдаланушы сеансынан, басқа макрос әрекеттерінің шығысынан немесе ${Slug} мәтінмәнді шығарып алатын Dataverseпараметр пішімі.

Өнімділікті автоматтандыру контексі

Dynamics 365 жүйесіндегі үлгіге негізделген қолданбаларға қатысты әрекеттерді орындау үшін пайдаланылатын өнімділікті автоматтандыру контекстінде слогты орындағыңыз келсе, ${</slug/>} пішімін пайдаланыңыз. . Мысалы: ${customerName}

Сеанс коннекторының контексті

Сеанс мәтінмәнінде слогты орындағыңыз келгенде, ${$session.<slug>} пішімін пайдалануыңыз керек. Мысалы: ${$session.customerName}

Сеанс мәтінмәні үшін қол жетімді слагтар мыналарды қамтиды:

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

омниарна коннектор контексі

Customer Service омниарнасы мәтінмәнінде слогты орындағыңыз келгенде, ${$oc.<slug>} пішімін пайдалануыңыз керек. Мысалы: ${$oc.customerName}

Session.CurrentTab.<Attribute> және Session.AnchorTab.<Attribute> параметрлері ағымдағы сеанс пен анкерлік қойындыға немесе фокусталатын ағымдағы қойындыға негізделген мәтінмәндік деректерді береді. Келесі — қолдау көрсетілетін төлсипат түрлері:

  • EntityName
  • EntityId

Мысалдар:

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

Ескертпе

Session.CurrentTab.<Attribute> және Session.AnchorTab.<Attribute> параметрлері макростарға ғана жарамды және үлгілерге қолданылмайды.

Үлгілерге арналған бөліктер

Қолдау көрсетілетін бөліктер тізімі:

Бөлік Сипаттама
{anchor.<attribute_name>} Анкер қойыншасына жүктелген жазбаның төлсипаттарына қол жеткізу үшін пайдаланылады.
{customerName} Сөйлесуді бастаған тұтынушы аты.
{caseId} Істің бір мәнді идентификаторы. Жүйе іс идентификаторын іс сөйлесумен байланыстырылған болса ғана көрсетеді.
{caseTitle} Іс тақырыбы. Жүйе іс тақырыбын іс сөйлесумен байланыстырылған болса ғана көрсетеді.
{queueId} Кезек тізімінің бір мәнді идентификаторы. Бұл әріптік-сандық жол кезек тізімі бетінің URL мекенжайында көрсетіледі.
{visitorLanguage} Сұхбатты бастаған тұтынушының сөйлесу тілі.
{visitorDevice} Сұхбатты бастаған тұтынушы құрылғысы.
{entityRoutingLogicalName} Хабарландыру нысан жазбасына арналған болса, нысан атауы.
{entityRoutingRecordId} Хабарландыру нысан жазбасына арналған болса, нысан жазбасының бір мәнді идентификаторы.
{customerRecordId} Егер тұтынушы расталған болса, нысанның бір мәнді идентификаторы (контакт немесе тіркелгі).
{<name of the pre-chat survey questions>} Жұмыс ағыны үшін конфигурацияланған чатқа дейінгі сауалнаманың барлық сұрақтарында сұрақтың атауы ретінде бөліктің атауы болады.

Үлгілердің бөліктеріне арналған пішім

Арна провайдерінен, ағымдағы пайдаланушы сеансынан немесе үлгі мәтінмәнін шығарып алатын {Slug} параметр пішімі Dataverse. Мысалы: {caseId}

OData сұраулары

Dataverse бағдарламасынан қолжетімді мәтінмәндерді алу үшін OData сұрауларын пайдалануға болады.

OData сұрау пішімі:

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

Мысалдар:

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

Тұрақты мәндер

Бұл бизнес талаптары негізінде жаңартылатын қатаң кодталған мәндер. Таңдаған әр қатты кодталған атрибут үшін белгілі бір атрибуттың пішім түрін орындаңыз.

Мысал (макрос):

Іс тақырыбының әрқашан Contoso - қосылатынын қалайсыз. Жазба жасау үшін Жаңа пішінді ашу әрекетін келесі өрістермен пайдаланасыз .

Параметр Мән
Нысанның логикалық атауы incident
Төлсипаттың атауы Іс тақырыбы
Атрибут мәні Contoso - {caseTitle}

Мұнда, Contoso - қатты кодталған статикалық мән.

Мысал (Үлгілер):

Кіріс сөйлесу сұрауы үшін сіз сеансқа тұрақты тақырыпты және орындалу уақыты кезінде агенттер көретін хабарландыру үлгісін бергіңіз келеді.

Хабарландыру тақырыбы = New chat request

Сеанс тақырыбы = Chat conversation

Сондай-ақ келесіні қараңыз

Сеанс үлгілерін басқару
Қолданба қойындысының үлгілерін басқару
Хабарландыру үлгілерін басқару
Үлгілерді жұмыс ағындарымен байланыстырыңыз