แชร์ผ่าน


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

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

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

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

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

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

เคนนี สมิธ ลูกค้าได้เริ่มการสนทนาและเมื่อเจ้าหน้าที่ฝ่ายบริการลูกค้า (ตัวแทนหรือตัวแทนฝ่ายสนับสนุน) เห็นการแจ้งเตือน ซึ่งจะแสดงชื่อลูกค้าเป็นเคนนี สมิธ

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

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

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

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

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

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

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

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

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

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

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

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

ข้อมูลบริบทนี้มาจากผู้ให้บริการช่องทางของบุคคลที่หนึ่ง เช่น ศูนย์ผู้ติดต่อ Dynamics 365 หรือผู้ให้บริการช่องทางของบุคคลที่สามที่ใช้วิดเจ็ตที่เปิดเผยโดยเฟรมเวิร์กการรวมช่องทาง Dynamics 365 ข้อมูลบริบทสามารถเป็นแบบสํารวจก่อนการสนทนาและการนําทางพอร์ทัลผู้เยี่ยมชมได้

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

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

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

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

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

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

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

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

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

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

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

หมายเหตุ

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

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

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

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

Slugs

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

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

แมโครและสคริปต์สนับสนุน slug ต่อไปนี้:

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

หมายเหตุ

เฉพาะ slug ${anchor.<attribute_name>} เท่านั้นที่ได้รับการสนับสนุนในแมโครและสคริปต์สําหรับพื้นที่ทํางานของบริการ Copilot

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

บุ้ง Description
{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 ในบริบทของ omnichannel คุณต้องใช้รูปแบบ ${$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 ที่สนับสนุนมีดังนี้:

บุ้ง Description
{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 - เสมอ คุณใช้การดำเนินการ เปิดฟอร์มใหม่เพื่อสร้างเรกคอร์ด ด้วยฟิลด์ต่อไปนี้

พารามิเตอร์ มูลค่า
ชื่อตรรกะของเอนทิตี เหตุการณ์
ชื่อแอตทริบิวต์ ชื่อของกรณี
ค่าแอตทริบิวต์ Contoso - {caseTitle}

ที่นี่ Contoso - เป็นค่าคงที่ตายตัว

ตัวอย่าง (เทมเพลต)

สําหรับคําขอแชทขาเข้า คุณต้องการใส่ชื่อแบบคงที่ให้กับเซสชันและเทมเพลตการแจ้งเตือนที่ตัวแทนจะเห็นในขณะทํางาน

หัวข้อการแจ้งเตือน = New chat request

หัวข้อเซสชัน = Chat conversation

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