Bagikan melalui

Perkaya detail rekaman CRM dengan wawasan dari aplikasi Anda (pratinjau)

  • Artikel

Penting

[Artikel ini adalah dokumentasi prarilis dan dapat berubah.]

Penjual dapat melihat detail tentang kontak yang disimpan, bersama dengan rekaman terkait seperti akun dan peluang. Anda dapat memperluas kemampuan detail rekaman manajemen hubungan pelanggan (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 rekaman yang terkait dengan rekaman CRM. Tindakan ini meningkatkan keterampilan Copilot untuk Penjualan yang ada.

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 rekaman terkait. 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 mengidentifikasi jenis rekaman di CRM yang rekaman terkait diminta.
recordId String Ya Pengidentifikasi unik rekaman CRM. Input ini memberikan pengidentifikasi unik dari catatan CRM yang diminta rekaman terkait.
atas Bilangan bulat No Jumlah aktivitas yang akan diambil. Input ini menunjukkan jumlah rekaman terkait yang akan diambil.
skip Bilangan bulat No Jumlah aktivitas yang harus dilewati. Input ini menunjukkan jumlah rekaman yang harus dilewati saat mengambil rekaman terkait.
Tipe crm String No Jenis sistem CRM. Nilai yang valid adalah Dynamics 365 dan Salesforce. Input ini menunjukkan jenis CRM dari mana rekaman terkait diambil.
crmOrgUrl String No Nama host organisasi CRM, seperti contoso.crm.dynamics.com. Input ini menunjukkan URL lingkungan CRM tempat rekaman terkait diambil.

Catatan

Titik ekstensi ini mendukung rendering wawasan dari hingga lima ekstensi konektor di sidecar Outlook.

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/format data Wajib Detail Deskripsi untuk ditambahkan dalam tindakan
recordId String Ya Pengidentifikasi unik rekaman. Output ini secara unik mengidentifikasi setiap rekaman terkait yang dikembalikan oleh tindakan.
recordTypeDisplayName String Ya Nama tampilan jenis rekaman, seperti Kontrak. Ini harus dilokalkan dalam bahasa yang ditentukan melalui Accept-Language header. Output ini menunjukkan nama tampilan jenis rekaman dari setiap rekaman terkait yang dikembalikan oleh tindakan.
recordTypePluralDisplayName String Ya Nama tampilan jamak dari jenis rekaman, seperti Kontrak. Ini harus dilokalkan dalam bahasa yang ditentukan melalui Accept-Language header. Output ini menunjukkan nama tampilan jamak dari jenis rekaman dari setiap rekaman terkait yang dikembalikan oleh tindakan.
Jenis rekaman String Ya Nama sistem jenis rekaman, seperti kontrak. Output ini menunjukkan jenis setiap rekaman terkait yang dikembalikan oleh tindakan.
Judul rekaman String Ya Nama rekaman, seperti Kontrak Perpanjangan Contoso 2023. Output ini menunjukkan judul setiap rekaman terkait yang dikembalikan oleh tindakan.
url String No URL yang valid untuk membuka rekaman di aplikasi mitra. Output ini menunjukkan URL setiap rekaman terkait yang dikembalikan oleh tindakan.
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 sebagai pasangan nama-nilai dari setiap rekaman terkait yang dikembalikan oleh tindakan.

Contoh

{
    "value": [
        {
            "recordId": "ID1",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "50 Cafe A-100 Automatic Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id1",
            "additionalProperties": {
                "Status": "Signed",
                "Date": "9/7/23",
                "Signed by": "Alberto Burgos, Tony [last name]"
            }
        },
        {
            "recordId": "ID2",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "ABC Company 2023 Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id2",
            "additionalProperties": {
                "Status": "Delivered",
                "Date": "9/3/23",
                 "Signed by": "Alberto Burgos"
            }
        }
    ],
    "hasMoreResults": false
}

Contoh dalam gambar berikut menunjukkan bagaimana output API dipetakan ke rekaman terkait.

Cuplikan layar yang menunjukkan anatomi rekaman terkait dari aplikasi mitra.

Legenda:

  1. Kartu yang memperlihatkan rekaman terkait dari aplikasi mitra.
  2. Ikon dan judul kartu. Ikon diambil dari metadata konektor Microsoft Power Platform . Judul adalah nama konektor Microsoft Power Platform .
  3. Judul rekaman terkait dari respons API. Dua properti tambahan dari respons API dirender sebagai bidang kunci dari setiap rekaman terkait.
  4. Tombol "Tindakan lainnya" yang dapat digunakan baik untuk menyalin tautan ke rekaman atau untuk melihat detail rekaman di aplikasi mitra. Tautan didasarkan pada URL rekaman terkait dalam respons API.
  5. Properti tambahan dari rekaman terkait dari respons API.

Melihat detail 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 ringkasan catatan CRM dengan wawasan dari aplikasi Anda
Perluas Microsoft 365 Copilot untuk Penjualan dengan aplikasi mitra
Bangun ekstensi Copilot untuk Penjualan