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

สําคัญ

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

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

โน้ต

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

คําอธิบาย API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Last updated on