แชร์ผ่าน

เพิ่มความสมบูรณ์ของแบบร่างอีเมลด้วยลิงก์ไฟล์จากแอปพลิเคชันของคุณ (พรีวิว)

สำคัญ

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

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

หมายเหตุ

ฟีเจอร์นี้รองรับเฉพาะแบบร่างของอีเมลที่สร้างขึ้นโดยใช้แอปการขายใน Outlook เท่านั้น

คำอธิบาย API

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

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

การดำเนินการ API

API นี้ใช้ประเภทการดำเนินการ: POST

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

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

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

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

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

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

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

สคีมาสำหรับการตอบกลับคำแนะนำเนื้อหาไฟล์หรือลิงก์

ชื่อ รูปแบบชนิดข้อมูล ต้องมี คำอธิบาย คำอธิบายที่จะเพิ่มในการดำเนินการ
ประเภทเนื้อหา สตริง ใข่ ชนิดเนื้อหาที่จะแสดง สำหรับข้อมูลเพิ่มเติม ไปที่ ค่าที่กำหนดไว้ล่วงหน้าสำหรับ contentType เอาต์พุตนี้ระบุชนิดของเนื้อหาที่รวมอยู่ในแบบร่างอีเมล
เนื้อหา สตริง ใข่ รวมเนื้อหาจริง อาจเป็นหน้าเว็บหรือ URL ของไฟล์ก็ได้ เอาต์พุตนี้ระบุเนื้อหาจริงที่รวมอยู่ในแบบร่างอีเมล อาจเป็นหน้าเว็บหรือ URL ก็ได้
เนื้อหาชื่อเรื่อง สตริง ใข่ ชื่อของเนื้อหาที่แนะนำที่แสดงต่อผู้ใช้ เอาต์พุตนี้ระบุคำชื่อของเนื้อหา
เนื้อหาคําอธิบาย สตริง ใข่ คำอธิบายของเนื้อหาที่แนะนำที่แสดงต่อผู้ใช้ เอาต์พุตนี้ระบุข้อความที่จะรวมไว้เมื่ออธิบายไฟล์
contentIconUrl สตริง ไม่ ไอคอนของเนื้อหาที่แนะนำที่แสดงต่อผู้ใช้ หากไม่มีให้ จะใช้ไอคอนทั่วไป เอาต์พุตนี้ระบุไอคอนที่จะรวมไว้สำหรับเนื้อหา
คุณสมบัติเพิ่มเติม ออบเจ็กต์ ไม่ ชุดของคู่ชื่อ-ค่าที่ระบุคุณสมบัติเพิ่มเติมของลิงก์ไฟล์ที่เกี่ยวข้องที่การดำเนินการส่งคืน เอาต์พุตนี้ระบุคุณสมบัติเพิ่มเติมเป็นคู่ชื่อ-ค่าของแต่ละลิงก์ที่เกี่ยวข้องซึ่งส่งคืนโดยการดำเนินการ

ค่าที่กำหนดไว้ล่วงหน้าสำหรับ contentType

ค่าสตริง ชนิดเนื้อหา
ไฟล์เนื้อหา ไฟล์ภายนอก (ทั่วไป)
เว็บเนื้อหา หน้าเว็บภายนอก
เอกสารเนื้อหา เอกสาร Microsoft Word
เนื้อหา-pdf เอกสาร Microsoft PDF
เนื้อหา-pptx งานนำเสนอ Microsoft PowerPoint
เนื้อหา-xlsx สเปรตชีต Microsoft Excel

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

{
  "value": [
    {
      "contentType": 0,
      "content": "https://www.bing.com",
      "contentTitle": "Purchase Contract",
      "contentDescription": "Purchase Contract Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Recipients": "Logan Edwards",
        "Sender Name": "Kenny Smith"
      }
    },
    {
      "contentType": 3,
      "content": "https://www.microsoft.com",
      "contentTitle": "Strategy Planning",
      "contentDescription": "Strategy Planning Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Recipients": "Gabriela Edwards",
        "Sender Name": "Maria Smith"
      }
    },
    {
      "contentType": 1,
      "content": "https://www.bing.com",
      "contentTitle": "Contoso Website",
      "contentDescription": "Contoso Website Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Total Views": "100",
        "Domain": "Contoso.com"
      }
    }
  ],
  "hasMoreResults": false
}

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

ภาพหน้าจอแสดงลิงก์ไฟล์จากแอปคู่ค้าในแบบร่างอีเมล

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

  1. ลิงก์ไฟล์จากแอปคู่ค้า

(ดูเพิ่มเติม )

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

  • Last updated on