แชร์ผ่าน


ใช้พจนานุกรมระบบอัตโนมัติเพื่อส่งผ่านคีย์พารามิเตอร์

พจนานุกรมการทำให้เป็นอัตโนมัติจะเก็บรักษาข้อมูลตามบริบทสำหรับเซสชัน ท่านสามารถใช้คีย์จากพจนานุกรมอัตโนมัติเพื่อส่งผ่านพารามิเตอร์ในการดำเนินการ

ขณะสร้างเทมเพลตและมาโครในแอปผู้ดูแลระบบ คุณสามารถส่งผ่านคีย์พารามิเตอร์ เช่น ชื่อของเซสชัน ชื่อการแจ้งเตือน ชื่อของเทมเพลตแท็บแอปพลิเคชัน และค่าพารามิเตอร์ที่กำหนดเองสำหรับชนิดแท็บแอปพลิเคชัน คีย์เหล่านี้จะถูกแทนที่ตามข้อมูลบริบทที่มีอยู่ในเวลาของการดำเนินการ

ส่งผ่านพารามิเตอร์ข้อมูลในเทมเพลต

ลองทำสถานการณ์สำหรับเทมเพลตด้วยการแจ้งเตือน

การแจ้งเตือนแสดงฟิลด์และค่าบางอย่างที่เรียกว่า ส่วนหัวของฟิลด์ และ ค่า ตามลำดับ

Kenny Smith ซึ่งเป็นลูกค้า ได้เริ่มต้นการสนทนาและเมื่อเจ้าหน้าที่เห็นการแจ้งเตือน จะปรากฏ ชื่อลูกค้า เป็น Kenny Smith

ที่นี่ ส่วนหัวของฟิลด์ คือ ชื่อลูกค้า และ ค่า คือ Kenny Smith

สำหรับเทมเพลตที่จะระบุชื่อของลูกค้าเป็น Kenny Smith คุณ (ผู้ดูแลระบบ) จะต้องส่งผ่านพารามิเตอร์เป็นคีย์

ในทำนองเดียวกัน สำหรับชื่อเซสชันและการแจ้งเตือน คุณสามารถส่งผ่านพารามิเตอร์ข้อมูลได้ ข้อมูลเพิ่มเติม: รูปแบบพจนานุกรมอัตโนมัติไปยังคีย์พารามิเตอร์ข้อมูล

ระบบจะแทนที่คีย์พารามิเตอร์เหล่านี้ด้วยค่าจริงตามบริบทของเซสชัน ผู้ให้บริการช่องทาง Microsoft Dataverse และการกระทำของผู้ใช้ ข้อมูลเพิ่มเติม: ชนิดของพารามิเตอร์ข้อมูลบริบท

ส่งผ่านพารามิเตอร์ข้อมูลในแมโครและสคริปต์ของเจ้าหน้าที่

มาโครเป็นชุดของการดำเนินการตามลำดับที่กำหนดค่าที่เรียกใช้ตามความต้องการโดยผู้ใช้ ในฐานะผู้ดูแลระบบ คุณต้องกำหนดค่าการกระทำที่มาโครต้องดำเนินการ การกำหนดค่าการกระทำ คุณจะต้องส่งผ่านพารามิเตอร์ข้อมูล ข้อมูลเพิ่มเติม: รูปแบบพจนานุกรมอัตโนมัติเพื่อส่งผ่านคีย์พารามิเตอร์ข้อมูล

เมื่อเจ้าหน้าที่เรียกใช้มาโคร ระบบจะแทนที่คีย์พารามิเตอร์เหล่านี้ด้วยค่าจริงตามบริบทของเซสชัน ผู้ให้บริการช่องทาง Dataverse และการกระทำของผู้ใช้

เมื่อบริบทมาจากเซสชัน การทำงานของแมโครจะดำเนินการตามข้อมูลสำหรับเซสชันปัจจุบัน ซึ่งได้รับข้อมูลจากแท็บจุดยึดหรือแท็บปัจจุบันที่อยู่ในโฟกัส ตัวอย่างเช่น ในการสร้างกรณี คุณต้องกำหนดการดำเนินการที่มีฟอร์มเอนทิตีของเหตุการณ์และ GUID ของฟอร์ม (ทางเลือก) ข้อมูลเพิ่มเติม: ชนิดของพารามิเตอร์ข้อมูลบริบท

ประเภทของพารามิเตอร์ข้อมูลบริบท

พจนานุกรมอัตโนมัติใช้พารามิเตอร์ข้อมูลบริบทที่มีอยู่จากแหล่งต่อไปนี้:

พจนานุกรมอัตโนมัติ

ข้อมูลบริบทจากผู้ให้บริการช่องทาง

ข้อมูลบริบทนี้มาจากผู้ให้บริการช่องทางฝ่ายหลัก เช่น ช่องทาง Omni สำหรับ Customer Service หรือผู้ให้บริการช่องทางบุคคลที่สามที่ใช้วิดเจ็ตที่เปิดเผยโดยกรอบงานการรวมของช่องทาง Dynamics 365 ข้อมูลบริบทจากช่องทาง Omni สำหรับ Customer Service คือการสำรวจก่อนการสนทนา การนำทางพอร์ทัลผู้เยี่ยมชม และอื่นๆ

ข้อมูลบริบทจากการดำเนินการของผู้ใช้

ข้อมูลนี้ถูกเติมเป็นและเมื่อเอเจนต์ดำเนินกิจกรรมบางอย่างในเซสชัน ตัวอย่างกำลังเปิดเร็กคอร์ดลูกค้าใหม่ กรณี และอื่น ๆ

ข้อมูลบริบทจาก Dataverse

ข้อมูลองค์กรถูกเก็บไว้ใน Dataverse และคุณสามารถดึงข้อมูลด้วยการใช้แบบสอบถาม OData ข้อมูลเพิ่มเติม: การสอบถาม OData

ข้อมูลบริบทจากการกระทำของมาโครอื่น

การดำเนินการ ในแมโครสร้างข้อมูลบริบทที่ใช้โดยการดำเนินการอื่นๆ ในแมโครนั้น

ตัวอย่างเช่น มีขั้นตอนการดำเนินการสองขั้นตอนในลำดับต่อไปนี้:

  1. เปิดฟอร์มใหม่เพื่อสร้างเรกคอร์ด
  2. เปิดฟอร์มอีเมลด้วยเทมเพลตที่กำหนดไว้ล่วงหน้า

ในขณะที่สร้างการดำเนินการ เปิดฟอร์มอีเมล์ด้วยเทมเพลตที่กำหนดไว้ล่วงหน้า คุณสามารถรับคีย์พารามิเตอร์ข้อมูลบริบทได้จากขึ้นตอนการดำเนินการมาโคร เปิดฟอร์มใหม่เพื่อสร้างเรกคอร์ด

พารามิเตอร์ข้อมูลบริบทจากการดำเนินการมาโครแรกมีดังนี้:

  • ชื่อตรรกะของเอนทิตี
  • ชนิดเพจ
  • รหัสแท็บ

หมายเหตุ

พารามิเตอร์ข้อมูลบริบทจากการดำเนินการแมโครอื่นๆ นั้นใช้เฉพาะกับมาโคร และไม่สามารถใช้ได้กับเทมเพลต

รูปแบบพจนานุกรมอัตโนมัติเพื่อส่งผ่านคีย์พารามิเตอร์ข้อมูล

พจนานุกรมการทำให้เป็นอัตโนมัติจะเก็บรักษาข้อมูลตามบริบทสำหรับเซสชัน คีย์ในพจนานุกรมอัตโนมัติสามารถส่งผ่านพารามิเตอร์ไปยังการดำเนินการในมาโคร ระบบจะแทนที่คีย์พารามิเตอร์เหล่านี้ด้วยค่าจริงตามบริบทของเซสชัน ผู้ให้บริการช่องทาง Dataverse และการกระทำของผู้ใช้

พจนานุกรมอัตโนมัติรองรับรูปแบบต่อไปนี้:

Slugs

slug เป็นพารามิเตอร์การแทนที่ที่ระบบจะเติมข้อมูลที่รันไทม์ตามบริบท ใช้รายการของ slug ต่อไปนี้สำหรับมาโครและสคริปต์ของเจ้าหน้าที่เท่านั้น และเพื่อตั้งค่าสคริปต์ของเจ้าหน้าที่เป็นค่าเริ่มต้นโดยใช้ตัวสร้างนิพจน์สคริปต์ของเจ้าหน้าที่ ข้อมูลเพิ่มเติม: เครื่องมือเพิ่มประสิทธิภาพ

Slugs สำหรับเครื่องมือเพิ่มประสิทธิภาพ (แมโครและสคริปต์ของเจ้าหน้าที่)

แมโครและสคริปต์สำหรับเจ้าหน้าที่สนับสนุน slug ต่อไปนี้:

Slug คำอธิบาย
${customerName} ชื่อของลูกค้าที่เริ่มต้นการสนทนา
${caseId} รหัสเฉพาะของกรณี ระบบแสดงรหัสของกรณี ก็ต่อเมื่อกรณีเชื่อมโยงกับการสนทนา
${caseTitle} ชื่อของกรณี ระบบแสดงชื่อของกรณี ก็ต่อเมื่อกรณีเชื่อมโยงกับการสนทนา
${LiveWorkItemId} รหัสเฉพาะของการสนทนา
${queueId} รหัสเฉพาะของคิว สตริงตัวอักษรผสมตัวเลขนี้ แสดงใน URL ของหน้าคิว
${visitorLanguage} ภาษาของลูกค้าผู้เริ่มต้นการสนทนา
${visitorDevice} อุปกรณ์ของลูกค้าผู้เริ่มต้นการสนทนา
${entityRoutingLogicalName} ชื่อของเอนทิตี หากการแจ้งเตือนนั้นใช้สำหรับเรกคอร์ดเอนทิตี
${customerEntityName} ชื่อของเอนทิตี (ผู้ติดต่อ หรือลูกค้าองค์กร) ถ้าลูกค้าได้รับการรับรองความถูกต้อง
${customerRecordId} รหัสเฉพาะของเอนทิตี (ผู้ติดต่อ หรือลูกค้าองค์กร) ถ้าลูกค้าได้รับการรับรองความถูกต้อง
${<name of the pre-conversation survey questions>} คำถามแบบสำรวจก่อนการสนทนาทั้งหมดที่กำหนดค่าสำหรับเวิร์กโฟลว์จะมีชื่อ Slug เป็นชื่อของคำถาม

หมายเหตุ

มีเพียง slug ${anchor.<attribute_name>} เท่านั้นที่ได้รับการสนับสนุนในมาโครและสคริปต์สำหรับ Customer Service workspace

Slug ต่อไปนี้ใช้เพื่อสร้างลิงก์การเชื่อมต่อใหม่ที่สามารถแชร์กับลูกค้า เพื่อเชื่อมต่อกลับไปยังเจ้าหน้าที่และการสนทนาเดียวกัน ข้อมูลเพิ่มเติม: กำหนดค่าการเชื่อมต่อใหม่ไปยังการสนทนาเดิม

Slug คำอธิบาย
{ReconnectUrl{ReconnectID}} ใช้ในการตอบกลับด่วนเพื่อสร้างลิงก์การเชื่อมต่อใหม่

รูปแบบสำหรับ slug สำหรับเครื่องมือเพิ่มประสิทธิภาพ

รูปแบบพารามิเตอร์ ${Slug} ที่ดึงบริบทจากผู้ให้บริการช่องทาง เซสชันผู้ใช้ปัจจุบัน เอาต์พุตของการดำเนินการของแมโครอื่นๆ หรือ Dataverse

บริบทระบบอัตโนมัติของประสิทธิภาพการทำงาน

เมื่อคุณต้องการดำเนินการกับ slug ในบริบทระบบอัตโนมัติของประสิทธิภาพการทำงาน ซึ่งใช้ในการดำเนินการที่เกี่ยวข้องกับแอปแบบจำลองใน Dynamics 365 ให้ใช้รูปแบบ ${</slug/>} ตัวอย่าง: ${customerName}

บริบทตัวเชื่อมต่อเซสชัน

เมื่อคุณต้องการดำเนิน slug ในบริบทเซสชัน คุณต้องใช้รูปแบบ ${$session.<slug>} ตัวอย่าง: ${$session.customerName}

Slug ที่พร้อมใช้งานสำหรับบริบทเซสชัน ได้แก่:

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

บริบทตัวเชื่อมต่อช่องทาง Omni

เมื่อคุณต้องการดำเนินการ slug ในบริบทช่องทาง Omni สำหรับ 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> สามารถใช้ได้กับมาโครเท่านั้น และไม่สามารถใช้ได้กับเทมเพลต

Slugs สำหรับเทมเพลต

รายชื่อ Slug ที่สนับสนุนมีดังนี้:

บุ้ง คำอธิบาย
{anchor.<attribute_name>} ใช้เพื่อเข้าถึงแอตทริบิวต์ของเรกคอร์ดที่โหลดในแท็บจุดยึด
{customerName} ชื่อของลูกค้าที่เริ่มต้นการสนทนา
{caseId} รหัสเฉพาะของกรณี ระบบแสดงรหัสของกรณี ก็ต่อเมื่อกรณีเชื่อมโยงกับการสนทนา
{caseTitle} ชื่อของกรณี ระบบแสดงชื่อของกรณี ก็ต่อเมื่อกรณีเชื่อมโยงกับการสนทนา
{queueId} รหัสเฉพาะของคิว สตริงตัวอักษรผสมตัวเลขนี้ แสดงใน URL ของหน้าคิว
{visitorLanguage} ภาษาของลูกค้าผู้เริ่มต้นการสนทนา
{visitorDevice} อุปกรณ์ของลูกค้าผู้เริ่มต้นการสนทนา
{entityRoutingLogicalName} ชื่อของเอนทิตี หากการแจ้งเตือนนั้นใช้สำหรับเรกคอร์ดเอนทิตี
{entityRoutingRecordId} รหัสเฉพาะของเรกคอร์ดเอนทิตี หากการแจ้งเตือนนั้นใช้สำหรับเรกคอร์ดเอนทิตี
{customerRecordId} รหัสเฉพาะของเอนทิตี (ผู้ติดต่อ หรือลูกค้าองค์กร) ถ้าลูกค้าได้รับการรับรองความถูกต้อง
{<name of the pre-chat survey questions>} คำถามแบบสำรวจก่อนการแชททั้งหมดที่กำหนดค่าสำหรับเวิร์กโฟลว์จะมีชื่อ Slug เป็นชื่อของคำถาม

รูปแบบสำหรับ slug สำหรับเทมเพลต

รูปแบบพารามิเตอร์ {Slug} ที่ดึงบริบทเทมเพลตจากผู้ให้บริการช่องทาง เซสชันผู้ใช้ปัจจุบัน หรือ Dataverse ตัวอย่าง: {caseId}

แบบสอบถาม OData

คุณสามารถใช้แบบสอบถาม OData เพื่อรับบริบทที่มีอยู่จาก Dataverse

รูปแบบการสอบถาม 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

จัดการเทมเพลตเซสชัน
จัดการเทมเพลตแท็บแอปพลิเคชัน
จัดการเทมเพลตการแจ้งเตือน
เชื่อมโยงเทมเพลตกับสตรีมงาน