Perkaya draf email dengan tautan file dari aplikasi Anda (pratinjau)
Penting
- Ini adalah fitur pratinjau siap produksi.
- Pratinjau siap produksi tunduk pada persyaratan penggunaan tambahan.
[Artikel ini adalah dokumentasi prarilis dan dapat berubah.]
Saat Anda menggunakan Copilot for Sales untuk menyusun email, Copilot untuk Sales mempertimbangkan maksud email dan menggunakan informasi CRM dari Salesforce atau Dynamics 365 untuk membuat draf. Anda dapat memperluas kemampuan penyusunan email yang disediakan Copilot for Sales dengan file yang direkomendasikan dari aplikasi Anda sendiri.
Catatan
Fitur ini hanya didukung untuk draf email yang dibuat menggunakan panel samping Copilot untuk Penjualan di Outlook.
Deskripsi API
Anda harus menambahkan deskripsi API berikut ke tindakan. Dengan cara ini, Copilot for Sales dapat mengidentifikasi API yang benar yang harus dipanggil untuk memperkaya kemampuan.
Tindakan ini mendapatkan file yang relevan dengan percakapan email, yang akan ditampilkan dalam draf email C4S di Outlook. Tindakan ini meningkatkan keterampilan copilot yang ada untuk penjualan.
Operasi API
API ini menggunakan Jenis Operasi: POST
Payload input
Payload ini berfungsi sebagai isi permintaan permintaan API.
| Nama | Jenis Data | Wajib | Detail | Deskripsi untuk ditambahkan dalam tindakan |
|---|---|---|---|---|
| Sumber Daya Data | Objek | Ya | Data resource yang akan digunakan untuk mengambil konten yang disarankan. Untuk struktur data, buka Model data email ekstensibilitas. | Input ini mengidentifikasi konten email yang merupakan kumpulan utas email, subjek, dan detail lainnya. |
| Tipe sumber daya | String | Ya | Jenis resource yang akan mengambil saran konten. Misalnya, 'utas email' atau 'obrolan tim'. | Input ini mengidentifikasi jenis sumber daya yang dibagikan untuk mengambil tautan file yang disarankan yang dalam hal ini adalah 'email-thread'. |
| Jenis rekaman | String | No | Jenis rekaman CRM seperti akun atau peluang. | Input ini mengidentifikasi jenis rekaman di CRM, yang terkait dengan utas email. |
| recordId | String | No | Pengidentifikasi unik rekaman CRM yang akan digunakan untuk konten yang disarankan. | Input ini memberikan pengidentifikasi unik dari rekaman CRM yang terkait dengan utas email. |
| Tipe crm | String | No | Jenis sistem CRM, jika terhubung. Nilai yang valid adalah Salesforce dan Dynamics 365. | Input ini menunjukkan jenis CRM di mana rekaman yang terkait dengan utas email ada. |
| crmOrgUrl | String | No | URL organisasi CRM. | Input ini menunjukkan URL lingkungan CRM tempat rekaman yang terkait dengan utas email ada. |
| Prompt input | String | No | Perintah yang disarankan yang saat ini digunakan yang diberikan oleh pengguna untuk membuat draf email. Misalnya, "Balas Kekhawatiran" atau "Buat Proposal". | Input ini menunjukkan perintah yang diberikan oleh pengguna saat menyusun email. |
| atas | Bilangan bulat | No | Jumlah item yang akan diambil. | Input ini menunjukkan jumlah tautan file yang akan diambil. |
| skip | Bilangan bulat | No | Jumlah item yang harus dilewati. | Input ini menunjukkan jumlah item yang harus dilewati saat mengambil tautan file yang disarankan. |
Model data email ekstensibilitas
| Properti | Tipe | Detail | Deskripsi untuk ditambahkan dalam tindakan |
|---|---|---|---|
| Tubuh teks biasa | String | Isi email lengkap mencakup semua pesan sebelumnya dari utas email di dalamnya. | Input ini menyediakan semua konten dari utas email dalam format teks. |
| FullHtmlBody | String | Versi HTML lengkap dari isi email yang menyertakan semua pesan sebelumnya dari utas email di dalamnya. | Input ini menyediakan semua konten dari utas email dalam format HTML. |
| subjek | String | Subjek email. | Input ini memberikan subjek email. |
| dari | String | Alamat email pengirim. | Input ini memberikan alamat email pengirim. |
| kepada | String[] | Alamat email penerima. | Input ini memberikan alamat email penerima. |
| Cc | String[] | Alamat email penerima ditambahkan di bidang Cc email. | Input ini memberikan semua alamat email penerima yang disertakan dalam bidang Cc email. |
| Bcc | String[] | Alamat email penerima ditambahkan di kolom Bcc email. | Input ini menyediakan semua alamat email penerima yang ditambahkan di bidang Bcc email. |
| sentDateTime | DateTimeOffset | Tanggal dan waktu email dalam format UTC bersama dengan properti Offset. Untuk informasi selengkapnya, buka DateTimeOffset Struct (Sistem) | Input ini memberikan stempel waktu email. |
| Id pesan | String | Id pesan Grafik email. | Input ini memberikan ID pesan email. |
| conversationId | String | Id percakapan Grafik dari utas email. | Input ini menyediakan ID percakapan utas email. |
Parameter output
| Properti | Jenis Data | Wajib | Detail |
|---|---|---|---|
| nilai | Array | Ya | Daftar tautan file (objek) yang ditentukan seperti yang dijelaskan dalam respons Skema untuk saran konten file atau tautan. |
| Memiliki Lebih Banyak Hasil | Boolean | No | Nilai yang menunjukkan apakah lebih banyak hasil tersedia. |
Skema untuk respons saran konten file atau tautan
| Nama | Format Tipe Data | Wajib | Detail | Deskripsi untuk ditambahkan dalam tindakan |
|---|---|---|---|---|
| Jenis konten | string | Ya | Jenis konten yang akan ditampilkan. Informasi selengkapnya, buka Nilai yang telah ditentukan sebelumnya untuk contentType | Output ini menunjukkan jenis konten yang disertakan dengan draf email. |
| konten | string | Ya | Termasuk konten aktual. Ini bisa berupa halaman web atau URL file. | Output ini menunjukkan konten aktual yang disertakan dengan draf email. Ini bisa berupa halaman web atau URL. |
| contentTitle | string | Ya | Judul konten yang disarankan yang ditampilkan kepada pengguna. | Output ini menunjukkan judul konten. |
| contentDescription | string | Ya | Deskripsi konten yang disarankan yang ditampilkan kepada pengguna. | Output ini menunjukkan teks yang akan disertakan saat mendeskripsikan file. |
| Konten IconUrl | string | No | Ikon konten yang disarankan ditampilkan kepada pengguna. Jika tidak disediakan, ikon generik digunakan. | Output ini menunjukkan ikon yang akan disertakan untuk konten. |
| Properti tambahan | Objek | No | Sekumpulan pasangan nama-nilai yang menunjukkan properti tambahan dari tautan file terkait yang dikembalikan tindakan. | Output ini menunjukkan properti tambahan sebagai pasangan nama-nilai dari setiap tautan terkait yang dikembalikan oleh tindakan. |
Nilai yang telah ditentukan sebelumnya untuk contentType
| Nilai string | Jenis konten |
|---|---|
| File konten | File Eksternal (Umum) |
| konten-web | Halaman Web Eksternal |
| konten-doc | Microsoft Word Surat |
| Konten-pdf | Dokumen PDF Microsoft |
| konten-pptx | Presentasi Microsoft PowerPoint |
| konten-xlsx | Microsoft Excel Spreadsheet |
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 gambar berikut menunjukkan bagaimana output API dipetakan ke draf email.
Legenda:
- Tautan file dari aplikasi mitra.
Baca juga
Meringkas utas email menggunakan informasi penjualan dengan Copilot di Outlook
Perkaya ringkasan email dengan wawasan dari aplikasi Anda
Perkaya informasi penjualan utama dengan wawasan dari aplikasi Anda
Perkaya detail catatan CRM dengan wawasan dari aplikasi Anda
Perkaya ringkasan catatan CRM dengan wawasan dari aplikasi Anda
Perluas Microsoft 365 Copilot untuk Penjualan dengan aplikasi mitra
Bangun ekstensi Copilot untuk Penjualan