แชร์ผ่าน

เพิ่มข้อมูลสรุปอีเมลด้วยคำแนะนำเนื้อหาจากแอปพลิเคชันของคุณ (พรีวิว)

สำคัญ

[บทความนี้เป็นคู่มือรุ่นก่อนวางจำหน่าย และอาจจะมีการเปลี่ยนแปลงในอนาคต]

เมื่อมีการใช้ Copilot ใน Outlook และแอปการขายร่วมกัน สรุปอีเมลที่แสดงใน Outlook รวมถึงข้อมูลการขายที่มาจากระบบการจัดการความสัมพันธ์กับลูกค้า (CRM) ของคุณ เช่น Dynamics 365 หรือ Salesforce CRM คุณสามารถขยายความสามารถในการสรุปอีเมลที่แอปการขายให้ข้อมูลเชิงลึกจากแอปพลิเคชันของคุณเอง

หมายเหตุ

API นี้จะแทนที่ API ทักษะสรุปอีเมล (Operation Id: scp-get-email-insights) ที่มีอยู่ด้วยเวอร์ชันใหม่

คำอธิบาย API

คุณต้องเพิ่มคำอธิบาย API ต่อไปนี้ลงในการดำเนินการ ซึ่งช่วยให้แอปการขายระบุ API ที่ถูกต้องเพื่อเรียกใช้เพื่อเพิ่มประสิทธิภาพความสามารถ

การดำเนินการนี้จะได้รับข้อมูลเชิงลึกด้านการขายเพิ่มเติมที่จะแสดงในประสบการณ์สรุปอีเมล C4S ในสรุป Outlook การดำเนินการช่วยเพิ่มทักษะที่มีอยู่ของ Copilot สำหรับฝ่ายขาย

รายละเอียด API

  • ชื่อ API: ทักษะสรุปอีเมลเวอร์ชัน 2
  • รหัสการดำเนินการ Swagger: scp-get-email-insights-v2
  • วิธีการดำเนินการ Swagger: post
  • พาธ: <PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2

ส่วนข้อมูลอินพุต

เพย์โหลดนี้จะไปเป็นเนื้อหาของคำขอ API

ชื่อ ชนิดข้อมูล ต้องมี คำอธิบาย คำอธิบายที่จะเพิ่มในการดำเนินการ
แหล่งข้อมูล ออบเจ็กต์ ใข่ ข้อมูลทรัพยากรที่จะใช้สำหรับการดึงเนื้อหาที่แนะนำ สำหรับโครงสร้างข้อมูล ให้ไปที่ โมเดลข้อมูลอีเมลความสามารถในการขยาย อินพุตนี้ระบุเนื้อหาอีเมลซึ่งเป็นชุดของเธรดอีเมล หัวเรื่อง และรายละเอียดอื่นๆ
เอนทิตีที่เกี่ยวข้อง อาร์เรย์ ไม่ อาร์เรย์ของเอนทิตีที่เกี่ยวข้อง สำหรับโครงสร้างข้อมูล ให้ไปที่โมเดล ข้อมูลเอนทิตีที่เกี่ยวข้อง อินพุตนี้ระบุอาร์เรย์ของเรกคอร์ด CRM ซึ่งเกี่ยวข้องกับกลุ่มข้อความสนทนาของอีเมล
ประเภท crm สตริง ไม่ ชนิดของระบบ CRM หากเชื่อมต่อ ค่าที่ถูกต้องคือ Salesforce และ Dynamics 365 อินพุตนี้ระบุชนิดของ CRM ที่มีเรกคอร์ดเกี่ยวข้องกับเธรดอีเมล
crmOrgUrl สตริง ไม่ URL องค์กร CRM อินพุตนี้ระบุ URL ของสภาพแวดล้อม CRM ที่มีเรกคอร์ดเกี่ยวข้องกับเธรดอีเมล
อันดับสูงสุด Integer ไม่ จำนวนของรายการที่จะดึง อินพุตนี้ระบุจำนวนลิงก์ของไฟล์ที่จะดึงข้อมูล
ข้าม Integer ไม่ จำนวนของรายการที่จะข้าม อินพุตนี้ระบุจำนวนรายการที่จะข้ามเมื่อดึงลิงก์ไฟล์ที่แนะนำ

โมเดลข้อมูลอีเมลความสามารถในการขยาย

คุณสมบัติ ขนิด คำอธิบาย คำอธิบายที่จะเพิ่มในการดำเนินการ
plaintextBody สตริง เนื้อหาอีเมลที่สมบูรณ์ประกอบด้วยข้อความก่อนหน้าทั้งหมดของเธรดอีเมลในนั้น อินพุตนี้แสดงเนื้อหาทั้งหมดจากเธรดอีเมลในรูปแบบข้อความ
fullHtmlBody สตริง เวอร์ชัน HTML แบบเต็มของเนื้อหาอีเมลที่ประกอบด้วยข้อความก่อนหน้าทั้งหมดของเธรดอีเมลในนั้น อินพุตนี้แสดงเนื้อหาทั้งหมดจากเธรดอีเมลในรูปแบบ HTML
subject สตริง หัวเรื่องอีเมล อินพุตนี้ระบุหัวเรื่องของอีเมล
จาก สตริง ที่อยู่อีเมลของผู้ส่ง อินพุตนี้ระบุที่อยู่อีเมลของผู้ส่ง
to สตริง[] ที่อยู่อีเมลของผู้รับ อินพุตนี้ระบุที่อยู่อีเมลของผู้รับ
สำเนาถึง สตริง[] ที่อยู่อีเมลของผู้รับที่เพิ่มในช่องสำเนาถึงของอีเมล อินพุตนี้จะระบุที่อยู่อีเมลของผู้รับทั้งหมดที่รวมอยู่ในช่องสำเนาถึงของอีเมล
สำเนาลับถึง สตริง[] ที่อยู่อีเมลของผู้รับที่เพิ่มในช่องสำเนาลับถึงของอีเมล อินพุตนี้จะระบุที่อยู่อีเมลของผู้รับทั้งหมดที่เพิ่มอยู่ในช่องสำเนาลับถึงของอีเมล
sentDateTime DateTimeOffset วันที่และเวลาของอีเมลในรูปแบบ UTC พร้อมกับคุณสมบัติออฟเซ็ต สำหรับข้อมูลเพิ่มเติม ไปที่ DateTimeOffset Struct (ระบบ) อินพุตนี้ระบุประทับเวลาของอีเมล
รหัสข้อความ สตริง ID ข้อความ Graph ของอีเมล อินพุตนี้ระบุ ID ข้อความของอีเมล
conversationId สตริง ID การสนทนา Graph ของเธรดอีเมล อินพุตนี้ระบุ ID การสนทนาของเธรดอีเมล
คุณสมบัติ ขนิด ต้องมี คำอธิบาย คำอธิบายที่จะเพิ่มในการดำเนินการ
entityId สตริง ใข่ ชนิดของเรกคอร์ด CRM เช่น บัญชีหรือโอกาสทางการขาย อินพุตนี้มีรหัสเฉพาะของเรกคอร์ด CRM ซึ่งเกี่ยวข้องกับเธรดอีเมล
ประเภทเอนทิตี้ สตริง ใข่ รหัสเฉพาะของเรกคอร์ด CRM ที่จะใช้สำหรับเนื้อหาที่แนะนำ อินพุตนี้ระบุชนิดของเรกคอร์ดใน CRM ซึ่งเกี่ยวข้องกับเธรดอีเมล
entitySource สตริง ไม่ อินพุตนี้ระบุแหล่งที่มาของเอนทิตี ซึ่งปัจจุบันมีค่า "เชื่อมต่อแล้ว" หรือค่าว่าง อินพุตนี้ระบุชนิดแหล่งที่มาของเอนทิตี

พารามิเตอร์เอาต์พุต

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

พารามิเตอร์ ชนิดข้อมูล ต้องมี คำอธิบาย
value อาร์เรย์ ใข่

รายการข้อมูลเชิงลึก (ออบเจ็กต์) ที่กำหนดไว้ตามที่อธิบายไว้ในส่วน สคีมาสำหรับข้อมูลเชิงลึก

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

สคีมาสำหรับข้อมูลเชิงลึก

ชื่อ ชนิดข้อมูล/รูปแบบ ต้องมี คำอธิบาย คำอธิบายที่จะเพิ่มในการดำเนินการ
ข้อมูลเชิงลึก สตริง ใข่ ข้อมูลเชิงลึกที่ส่งถึงผู้ใช้ เช่น เพื่อนร่วมงานของคุณ Mona Kane, Ray Tanaka และ Daniela Smith เคยร่วมงานกับพวกเขามาก่อน เอาต์พุตนี้ระบุข้อความที่คุณต้องการรวมไว้ในสรุปอีเมล

ตัวอย่างเช่น

{
    "value": [
        {
            "insight": "Your colleagues Mona Kane, Ray Tanaka and Daniela Smith have worked with them before."
        },
        {
            "insight": "The email was opened three times in the last month."
        }
    ],
    "hasMoreResults": false
}

ตัวอย่างในรูปภาพต่อไปนี้แสดงวิธีการแมปเอาต์พุตของ API กับสรุปอีเมลในบานหน้าต่างด้านข้าง

ภาพหน้าจอแสดงข้อมูลเชิงลึกจากแอปคู่ค้าในสรุปอีเมล

คำอธิบายสัญลักษณ์:

  1. ชื่อของข้อมูลเชิงลึก ข้อมูลเชิงลึกที่มีชื่อเดียวกันจะจัดกลุ่มไว้ด้วยกัน
  2. คำอธิบายของข้อมูลเชิงลึก ข้อมูลเชิงลึกแต่ละรายการมีคำอธิบายหนึ่งรายการ

ตัวอย่างในรูปภาพต่อไปนี้แสดงวิธีการแมปเอาต์พุตของ API กับสรุปอีเมลในเนื้อความอีเมล

ภาพหน้าจอแสดงข้อมูลเชิงลึกจากแอปของคู่ค้าในเนื้อความอีเมล

คำอธิบายสัญลักษณ์:

  1. ชื่อของข้อมูลเชิงลึก ข้อมูลเชิงลึกที่มีชื่อเดียวกันจะจัดกลุ่มไว้ด้วยกัน
  2. คำอธิบายของข้อมูลเชิงลึก ข้อมูลเชิงลึกแต่ละรายการมีคำอธิบายหนึ่งรายการ

สรุปชุดข้อความอีเมลโดยใช้ข้อมูลการขายด้วย Copilot ใน Outlook
เพิ่มข้อมูลเชิงลึกของโอกาสด้วยข้อมูลจากแอปพลิเคชันของคุณ
เพิ่มข้อมูลรายละเอียดเรกคอร์ด CRM ด้วยข้อมูลเชิงลึกจากแอปพลิเคชันของคุณ
เพิ่มข้อมูลสรุปเรกคอร์ด CRM ด้วยข้อมูลเชิงลึกจากแอปพลิเคชันของคุณ
ขยายยอดขายใน Microsoft 365 Copilot ด้วยแอปพลิเคชันคู่ค้า
เพิ่มความสมบูรณ์ของแบบร่างอีเมลด้วยลิงก์ไฟล์จากแอปพลิเคชันของคุณ
สร้างส่วนขยายสําหรับการขายใน Microsoft 365 Copilot

  • Last updated on