Bagikan melalui

Perkaya ringkasan catatan CRM dengan wawasan dari aplikasi Anda (pratinjau)

  • Artikel

Penting

[Artikel ini adalah dokumentasi prarilis dan dapat berubah.]

Untuk lebih memahami konteks rapat yang sedang mereka persiapkan atau email yang sedang mereka baca, penjual menginginkan informasi manajemen hubungan pelanggan (CRM) yang relevan, seperti pertanyaan, kekhawatiran, dan catatan pelanggan. Copilot untuk Penjualan menggunakan AI untuk menghasilkan ringkasan setiap catatan CRM. Ringkasan ini menyoroti detail penting, seperti tahap penjualan, anggaran, dan tanggal penutupan yang diproyeksikan. Anda dapat memperluas kemampuan ringkasan rekaman CRM yang disediakan Copilot untuk Penjualan dengan wawasan dari aplikasi Anda sendiri.

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 wawasan penjualan tambahan yang terkait dengan rekaman CRM yang akan ditampilkan di kartu ringkasan rekaman C4S. Tindakan ini meningkatkan keterampilan copilot yang ada untuk penjualan.

Operasi API

API ini menggunakan Jenis Operasi: GET

Parameter input

Copilot untuk Penjualan dirancang untuk memberikan parameter input berikut ke API Anda.

Nama Jenis/format data Wajib Detail Deskripsi untuk ditambahkan dalam tindakan
Jenis rekaman String Ya Jenis entitas atau objek di CRM yang diminta wawasan terkait seperti aktivitas. Nilai tersebut mencakup nama unik agnostik bahasa dari entitas atau jenis objek, bukan nama tampilan yang dapat dilokalkan. Contohnya termasuk akun dan peluang . Input ini menunjukkan entitas atau jenis objek di CRM yang wawasannya diminta.
recordId String Ya Pengidentifikasi unik rekaman CRM. Input ini menunjukkan pengidentifikasi unik rekaman CRM yang dimintanya wawasan.
Mulai TanggalWaktu String dalam format 'tanggal-waktu' No Tanggal dan waktu mulai untuk mencari wawasan. Formatnya mengikuti OpenAPI spesifikasi. Berikut contohnya: 2017-07-21T17:32:28Z. Input ini menunjukkan tanggal dan waktu mulai untuk wawasan yang diminta.
endDateTime String dalam format 'tanggal-waktu' No Tanggal dan waktu akhir untuk mencari wawasan. Formatnya mengikuti OpenAPI spesifikasi. Berikut contohnya: 2017-07-21T17:32:28Z. Input ini menunjukkan tanggal dan waktu akhir untuk wawasan yang diminta.
atas Bilangan bulat No Jumlah insight yang akan diambil. Input ini menunjukkan jumlah insight yang akan diambil.
skip Bilangan bulat No Jumlah wawasan yang harus dilewati. Input ini menunjukkan jumlah wawasan yang harus dilewati.
Tipe crm String No Nilai yang valid adalah Dynamics 365 dan Salesforce. Input ini menunjukkan jenis CRM di mana rekaman CRM ada, yang mana wawasan diminta.
crmOrgUrl String No Nama host organisasi CRM, seperti contoso.crm.dynamics.com. Input ini menunjukkan URL lingkungan CRM tempat rekaman CRM ada, yang mana wawasan diminta.

Parameter output

Copilot untuk Penjualan mengharapkan untuk menerima daftar wawasan (objek) dari API Anda, dan mengharapkan setiap wawasan memiliki parameter tertentu. Untuk memastikan bahwa Copilot for Sales dapat mengurai output dengan benar, struktur respons harus mematuhi pedoman dalam tabel berikut.

Parameter Tipe data Wajib Detail
nilai Array Ya Daftar wawasan (objek) yang didefinisikan seperti yang dijelaskan di bagian Skema untuk wawasan .
Memiliki Lebih Banyak Hasil Boolean No Nilai yang menunjukkan apakah lebih banyak hasil tersedia.

Skema untuk wawasan

Nama Jenis data/Format Wajib Detail Deskripsi yang akan ditambahkan dalam tindakan
title String Ya Judul wawasan pada kartu kutipan. Ini adalah judul bahasa alami dari wawasan dalam bahasa yang ditentukan melalui Accept-Language header permintaan. Berikut adalah contoh: Kontrak ditandatangani. Output ini menunjukkan judul aktivitas di kartu kutipan.
deskripsi String Ya Deskripsi wawasan. Ini ditampilkan sebagai poin-poin dalam ringkasan rekaman dan merupakan deskripsi bahasa alami dari wawasan dalam bahasa yang ditentukan melalui Accept-Language header. Berikut contohnya: Kenny, Logan, dan dua lainnya menandatangani Kontrak Perpanjangan Contoso 2023 pada 7/9/2023. Output ini menunjukkan deskripsi wawasan.
tanggalWaktu String dalam format 'tanggal-waktu' Ya Tanggal dan waktu aktivitas dalam format UTC. Jika aktivitas memiliki waktu mulai dan waktu berakhir, aplikasi harus menentukan waktu yang akan ditampilkan. Formatnya mengikuti OpenAPI spesifikasi. Berikut contohnya: 2017-07-21T17:32:28Z. Output ini menunjukkan waktu yang terkait dengan wawasan.
url String No URL yang valid untuk membuka aktivitas di aplikasi mitra. Output ini menunjukkan URL untuk membuka wawasan.
Properti tambahan Objek yang memiliki nilai Nama Properti dan Nilai Properti dari jenis String No

Properti tambahan yang ditampilkan dalam tampilan terperinci. Nama dan nilai properti dalam bahasa alami dalam bahasa yang ditentukan melalui Accept-Language header. Berikut adalah contohnya.

{
 "Alasan status": "Ditandatangani",
 "Pemilik": "Kenny Smith"
}
 Output ini menunjukkan properti tambahan yang ditampilkan dalam tampilan terperinci wawasan.

Catatan

Meskipun persyaratan API untuk memperluas kemampuan ringkasan email dan kemampuan ringkasan rekaman mungkin terlihat serupa, persyaratan tersebut harus ditambahkan sebagai tindakan terpisah di konektor.

Contoh

{
    "value": [
        {
            "title": "Contract signed",
            "description": "You have 5 connections in Fourth Coffee Inc",
            "dateTime": "2024-05-07T03:28:38.0667701Z",
            "url": null,
            "additionalProperties": {
                "Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
                "Signed by": "Alberto Burgos, Tony",
                "Signed": "9/7/23"
            }
        },
        {
            "title": "Contract signed",
            "description": "Multiple stakeholders from Fourth Coffee have visited the Contoso website four times in the last four months",
            "dateTime": "2024-05-07T03:28:38.0669445Z",
            "url": null,
            "additionalProperties": {
                "Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
                "Signed by": "Alberto Burgos, Tony",
                "Signed": "9/7/23"
            }
        }
    ],
    "hasMoreResults": false
}

Contoh pada gambar berikut menunjukkan bagaimana output API dipetakan ke ringkasan rekaman.

Cuplikan layar yang menunjukkan anatomi aktivitas terbaru dari aplikasi mitra.

Legenda:

  1. Bagian yang menunjukkan wawasan dari aplikasi mitra. Judul bagian berasal dari nama Microsoft Power Platform konektor.
  2. Deskripsi wawasan dari respons API.
  3. Nomor kutipan yang dapat dipilih untuk melihat detail tentang wawasan.
  4. Kartu kutipan yang menunjukkan detail tentang wawasan.
  5. Ikon dan judul wawasan. Ikon diambil dari metadata konektor Microsoft Power Platform . Teks judul adalah judul wawasan dari respons API.
  6. Properti tambahan wawasan dari respons API.
  7. Nama aplikasi mitra. Nama yang ditampilkan adalah nama konektor Microsoft Power Platform .
  8. Tautan yang dapat dipilih untuk melihat detail wawasan di aplikasi mitra. Ini didasarkan pada URL wawasan dalam respons API.

Melihat ringkasan rekaman
Perkaya ringkasan email dengan wawasan dari aplikasi Anda
Perkaya draf email dengan tautan file dari aplikasi Anda
Perkaya informasi penjualan utama dengan wawasan dari aplikasi Anda
Perkaya detail catatan CRM dengan wawasan dari aplikasi Anda
Perluas Microsoft 365 Copilot untuk Penjualan dengan aplikasi mitra
Bangun ekstensi Copilot untuk Penjualan