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

สําคัญ

[บทความนี้เป็นเอกสารก่อนการนำออกใช้ และอาจเปลี่ยนแปลงได้]

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

โน้ต

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

คําอธิบาย API

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

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

รายละเอียด 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 ที่มีเรกคอร์ดเกี่ยวข้องกับเธรดอีเมล
บนสุด เลขจำนวนเต็ม ไม่ จำนวนของรายการที่จะดึง อินพุตนี้ระบุจำนวนลิงก์ของไฟล์ที่จะดึงข้อมูล
ข้าม เลขจำนวนเต็ม ไม่ จำนวนของรายการที่จะข้าม อินพุตนี้ระบุจำนวนรายการที่จะข้ามเมื่อดึงลิงก์ไฟล์ที่แนะนำ

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

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

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

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

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

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

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

Schema สําหรับข้อมูลเชิงลึก

ชื่อ ชนิดข้อมูล/รูปแบบ ต้องระบุ รายละเอียด คำอธิบายสำหรับเพิ่มในการดำเนินการ
ข้อมูลเชิงลึก สตริง ใช่ ข้อมูลเชิงลึกที่ส่งถึงผู้ใช้ เช่น เพื่อนร่วมงานของคุณ 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 ด้วยข้อมูลเชิงลึกจากแอปพลิเคชันของคุณ
ขยายตัวแทนการขายด้วยแอปพลิเคชันของคู่ค้า
เติมแต่งอีเมลร่างด้วยลิงก์ไฟล์จากแอปพลิเคชันของคุณ
สร้างส่วนขยายสําหรับตัวแทนขาย

  • Last updated on