Perkayakan draf e-mel dengan pautan fail daripada permohonan anda (pratonton)

Penting

• Ini ialah ciri pratonton yang bersedia untuk pengeluaran.
• Pratonton sedia pengeluaran tertakluk kepada syarat penggunaan tambahan.

[Artikel ini merupakan dokumentasi prakeluaran dan tertakluk pada perubahan.]

Apabila anda menggunakan Copilot for Sales untuk merangka e-mel, ia mempertimbangkan niat e-mel dan menggunakan maklumat CRM daripada Salesforce atau Dynamics 365 untuk mencipta draf. Anda boleh memperluaskan keupayaan penggubalan e-mel yang disediakan oleh Copilot for Sales dengan fail yang disyorkan daripada aplikasi anda sendiri.

Nota

Ciri ini disokong hanya untuk draf e-mel yang dicipta menggunakan anak tetingkap sisi Copilot for Sales dalam Outlook.

Penerangan API

Anda mesti menambah perihalan API berikut pada tindakan. Dengan cara ini, Copilot for Sales boleh mengenal pasti API yang betul yang mesti digunakan untuk memperkayakan keupayaan.

Tindakan ini mendapat fail yang berkaitan dengan perbualan e-mel, yang akan ditunjukkan dalam draf e-mel C4S dalam Outlook. Tindakan ini meningkatkan kemahiran sedia ada copilot untuk jualan.

Operasi API

API ini menggunakan Jenis Operasi: POST

Muat beban input

Muatan ini digunakan sebagai badan permintaan permintaan API.

Nama	Jenis Data	Wajib	Butiran	Penerangan untuk ditambah dalam tindakan
sumberData	Objek	Ya	Data sumber yang akan digunakan untuk mengambil kandungan yang dicadangkan. Untuk struktur data, pergi ke Model data e-mel Kebolehlanjutan.	Input ini mengenal pasti kandungan e-mel yang merupakan koleksi utas e-mel, subjek dan butiran lain.
resourceType	Rentetan	Ya	Jenis sumber untuk mendapatkan cadangan kandungan. Contohnya, 'email-thread' atau 'teams-chat'.	Input ini mengenal pasti jenis sumber yang dikongsi untuk mengambil pautan fail yang dicadangkan yang dalam kes ini ialah 'email-thread'.
recordType	Rentetan	Tidak	Jenis rekod CRM seperti akaun atau peluang.	Input ini mengenal pasti jenis rekod dalam CRM, yang berkaitan dengan jaluran e-mel.
rekodId	Rentetan	Tidak	Pengecam unik rekod CRM untuk digunakan untuk kandungan yang dicadangkan.	Input ini menyediakan pengecam unik rekod CRM yang berkaitan dengan jaluran e-mel.
crmType	Rentetan	Tidak	Jenis sistem CRM, jika disambungkan. Nilai yang sah ialah Salesforce dan Dynamics 365.	Input ini menunjukkan jenis CRM di mana rekod yang berkaitan dengan utas e-mel wujud.
crmOrgUrl	Rentetan	Tidak	URL organisasi CRM.	Input ini menunjukkan URL persekitaran CRM di mana rekod yang berkaitan dengan jaluran e-mel wujud.
inputPrompt	Rentetan	Tidak	Gesaan yang dicadangkan yang digunakan pada masa ini yang diberikan oleh pengguna untuk menjana draf e-mel. Contohnya, "Balas kepada Kebimbangan" atau "Buat Cadangan".	Input ini menunjukkan gesaan yang diberikan oleh pengguna semasa merangka e-mel.
atas	Integer	Tidak	Bilangan item yang hendak diambil.	Input ini menunjukkan bilangan pautan fail untuk diambil.
langkau	Integer	Tidak	Bilangan item yang perlu dilangkau.	Input ini menunjukkan bilangan item yang perlu dilangkau semasa mengambil pautan fail yang dicadangkan.

Model data e-mel kebolehlanjutan

Sifat	Taip	Butiran	Penerangan untuk ditambah dalam tindakan
Teks biasaBadan	Rentetan	Badan e-mel lengkap termasuk semua mesej sebelumnya bagi jaluran e-mel di dalamnya.	Input ini menyediakan semua kandungan daripada jaluran e-mel dalam format teks.
penuhHtmlBadan	Rentetan	Versi HTML penuh badan e-mel yang merangkumi semua mesej sebelumnya bagi jaluran e-mel di dalamnya.	Input ini menyediakan semua kandungan daripada jaluran e-mel dalam format HTML.
subjek	Rentetan	Subjek e-mel.	Input ini menyediakan subjek e-mel.
daripada	Rentetan	Alamat e-mel pengirim.	Input ini menyediakan alamat e-mel pengirim.
kepada:	Rentetan	Alamat e-mel penerima.	Input ini menyediakan alamat e-mel penerima.
Cc	Rentetan	Alamat e-mel penerima ditambah dalam medan Cc e-mel.	Input ini menyediakan semua alamat e-mel penerima yang disertakan dalam medan Cc e-mel.
Bcc	Rentetan	Alamat e-mel penerima ditambah dalam medan Bcc e-mel.	Input ini menyediakan semua alamat e-mel penerima yang ditambahkan dalam medan Bcc e-mel.
sentDateTime	DateTimeOffset	Tarikh dan masa e-mel dalam format UTC bersama-sama dengan sifat Offset. Untuk maklumat lanjut, pergi ke DateTimeOffset Struct (Sistem)	Input ini menyediakan cap masa e-mel.
messageId	Rentetan	Id mesej Graf e-mel.	Input ini menyediakan ID mesej e-mel.
perbualanId	Rentetan	Id perbualan Graf bagi jaluran e-mel.	Input ini menyediakan ID perbualan jaluran e-mel.

Parameter output

Sifat	Jenis Data	Wajib	Butiran
nilai	Tatasusunan	Ya	Senarai pautan fail (objek) yang ditakrifkan seperti yang diterangkan dalam respons Skema untuk cadangan kandungan fail atau pautan.
mempunyaiLagiKeputusan	Boolean	Tidak	Nilai yang menunjukkan sama ada lebih banyak hasil carian tersedia.

Skema untuk respons cadangan kandungan fail atau pautan

Nama	Format Jenis Data	Wajib	Butiran	Penerangan untuk ditambah dalam tindakan
contentType	rentetan	Ya	Jenis kandungan yang hendak dipaparkan. Maklumat lanjut, pergi ke Nilai yang telah ditetapkan untuk contentType	Output ini menunjukkan jenis kandungan yang disertakan dengan draf e-mel.
kandungan	rentetan	Ya	Kandungan sebenar disertakan. Ia boleh sama ada halaman web atau URL fail.	Output ini menunjukkan kandungan sebenar yang disertakan dengan draf e-mel. Ia boleh sama ada halaman web atau URL.
kandunganTajuk	rentetan	Ya	Tajuk kandungan yang dicadangkan ditunjukkan kepada pengguna.	Output ini menunjukkan tajuk kandungan.
kandunganPenerangan	rentetan	Ya	Penerangan kandungan yang dicadangkan ditunjukkan kepada pengguna.	Output ini menunjukkan teks yang akan disertakan semasa menerangkan fail.
contentIconUrl	rentetan	Tidak	Ikon kandungan yang dicadangkan ditunjukkan kepada pengguna. Jika tidak disediakan, ikon generik digunakan.	Output ini menunjukkan ikon yang akan disertakan untuk kandungan.
Sifat tambahan	Objek	Tidak	Satu set pasangan nama-nilai yang menunjukkan sifat tambahan pautan fail berkaitan yang dikembalikan oleh tindakan tersebut.	Output ini menunjukkan sifat tambahan sebagai pasangan nama-nilai bagi setiap pautan berkaitan yang dikembalikan oleh tindakan.

Nilai yang telah ditetapkan untuk contentType

Nilai rentetan	Jenis kandungan
Fail kandungan	Fail Luaran (Generik)
kandungan-web	Laman Web Luaran
dokumen-kandungan	Microsoft Word Dokumen
kandungan-pdf	Dokumen PDF Microsoft
kandungan-pptx	Pembentangan Microsoft PowerPoint
kandungan-xlsx	Hamparan Microsoft Excel

Contoh

{
  "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
}

Contoh dalam imej berikut menunjukkan cara output API dipetakan kepada draf e-mel.

Petunjuk:

1. Pautan fail daripada apl rakan kongsi.

Lihat juga

Ringkaskan jaluran e-mel menggunakan maklumat jualan dengan Copilot dalam Outlook
Perkayakan ringkasan e-mel dengan cerapan daripada aplikasi anda
Perkayakan maklumat jualan utama dengan cerapan daripada aplikasi anda
Perkayakan butiran rekod CRM dengan cerapan daripada aplikasi anda
Perkayakan ringkasan rekod CRM dengan cerapan daripada aplikasi anda
Lanjutkan Microsoft 365 Copilot untuk Jualan dengan aplikasi rakan kongsi
Bina Copilot untuk sambungan Jualan