CRM kayıt özetlerini uygulamanızdan gelen içgörülerle zenginleştirme (önizleme)
Önemli
- Bu bir üretime hazır önizleme özelliğidir.
- Üretime hazır önizlemeler, ek kullanım koşullarına tabidir.
[Bu makale, yayın öncesi belgelerine dahildir ve değiştirilebilir.]
Satıcılar, hazırlandıkları bir toplantının veya okudukları bir e-postanın bağlamını daha iyi anlayabilmek için müşteri soruları, endişeleri ve notları gibi ilgili müşteri ilişkileri yönetimi (CRM) bilgilerine ihtiyaç duyarlar. Satış için Copilot, her CRM kaydının bir özetini oluşturmak için yapay zekayı kullanır. Bu özet, satış aşaması, bütçe ve öngörülen kapanış tarihi gibi önemli ayrıntıları vurgular. Satış için Copilot tarafından sağlanan CRM kaydı özet yeteneğini kendi uygulamanızdan gelen içgörülerle genişletebilirsiniz.
API açıklaması
Eyleme aşağıdaki API açıklamasını eklemeniz gerekir. Bu şekilde, Satış için Copilot, özelliği zenginleştirmek için çağrılması gereken doğru API'yi tanımlayabilir.
Bu eylem, C4S kayıt özeti kartında gösterilecek bir CRM kaydıyla ilgili ek satış içgörüleri alır. Eylem, Satış için Copilot'ın mevcut becerilerini geliştirir.
API işlemi
Bu API İşlem Türü'nü kullanır: GET
Giriş parametreleri
Satış için Copilot API'lerinize aşağıdaki giriş parametrelerini sağlayacak şekilde tasarlanmıştır.
| Adı | Veri türü/biçimi | Zorunlu | Ayrıntılar | Eyleme eklenecek açıklama |
|---|---|---|---|---|
| recordType | Diize | Evet | CRM'de faaliyetler gibi ilgili içgörülerin talep edildiği varlık veya nesnenin türü. Değer, yerelleştirilebilen görünen adı değil, varlığın veya nesne türünün dilden bağımsız benzersiz adını içerir. Örnek olarak firma ve fırsat verilebilir. | Bu giriş, CRM'de haklarında içgörülerin istendiği varlık ya da nesne türünü belirtir. |
| recordId | Diize | Evet | CRM kaydının benzersiz tanımlayıcısı. | Bu giriş, CRM kaydında içgörülerin istendiği benzersiz tanıtıcıyı belirtir. |
| startDateTime | 'Tarih-saat' biçimindeki dize | Hayır | İçgörüleri aramak için başlangıç tarihi ve saati. Biçim, OpenAPI spesifikasyonunu takip eder. İşte bir örnek: 2017-07-21T17:32:28Z. | Bu giriş istenen içgörüler için başlangıç tarihini ve saatini gösterir. |
| endDateTime | 'Tarih-saat' biçimindeki dize | Hayır | İçgörüleri aramak için bitiş tarihi ve saati. Biçim, OpenAPI spesifikasyonunu takip eder. İşte bir örnek: 2017-07-21T17:32:28Z. | Bu giriş istenen içgörüler için bitiş tarihini ve saatini gösterir. |
| üst | Tam sayı | Hayır | Getirilecek içgörülerin sayısı. | Bu giriş, almak için içgörü sayısını gösterir. |
| atla | Tam sayı | Hayır | Atlanacak içgörü sayısı. | Bu giriş, atlamak için içgörü sayısını gösterir. |
| crmType | Diize | Hayır | Geçerli değerler Dynamics 365 ve Salesforce'tur. | Bu giriş, içgörüler istenen CRM kaydının var olduğu CRM türünü belirtir. |
| crmOrgUrl | Diize | Hayır | CRM kuruluşunun ana bilgisayar adı, örneğin contoso.crm.dynamics.com. | Bu giriş, içgörüler istenen CRM kaydının var olduğu CRM ortamının URL'sini belirtir. |
Çıkış parametreleri
Satış için Copilot, API'lerinizden içgörülerin (nesnelerin) bir listesini almayı bekler ve her içgörünün belirli parametrelere sahip olmasını bekler. Satış için Copilot'ın çıktıyı doğru şekilde ayrıştırabilmesini sağlamak için yanıt yapısının aşağıdaki tabloda yer alan yönergelere uyması gerekir.
| Parametre | Veri türü | Zorunlu | Ayrıntılar |
|---|---|---|---|
| değer | Dizi | Evet | İçgörüler için şema bölümünde açıklandığı gibi tanımlanan içgörülerin (nesnelerin) listesi. |
| hasMoreResults | Boole | Hayır | Daha fazla sonucun mevcut olup olmadığını gösteren bir değer. |
İçgörüler için şema
| Adı | Veri türü/Biçimi | Zorunlu | Ayrıntılar | Eylemde eklenecek açıklama |
|---|---|---|---|---|
| başlık | Diize | Evet | Atıf kartında içgörü başlığı.
Accept-Language istek başlığında belirtilen dilde içgörünün doğal dil başlığıdır. Burada bir örnek bulunmaktadır: Sözleşme imzalandı. |
Bu çıkış atıf kartında etkinlik başlığını gösterir. |
| Açıklama | Diize | Evet | İçgörü açıklaması. Kayıt özetinde madde işaretleri olarak gösterilir ve içgörünün Accept-Language üst bilgi aracılığıyla belirtilen dildeki doğal dil açıklamasıdır. İşte bir örnek: Kenny, Logan ve diğer iki kişi, 9/7/2023 tarihinde Contoso 2023 Yenileme Sözleşmesini imzaladı. |
Bu çıkış içgörü açıklamasını gösterir. |
| dateTime | 'Tarih-saat' biçimindeki dize | Evet | Etkinliğin UTC formatındaki tarih ve saati. Etkinliğin hem başlangıç hem de bitiş zamanı varsa, uygulamanın hangi saatin gösterileceğini belirlemesi gerekir. Biçim, OpenAPI spesifikasyonunu takip eder. İşte bir örnek: 2017-07-21T17:32:28Z. | Bu çıkış, içgörüyle ilişkilendirilen zamanı gösterir. |
| url | Diize | Hayır | İş ortağı uygulamasında etkinliği açmak için geçerli bir URL. | Bu çıkış içgörü açmak için URL'yi gösterir. |
| additionalProperties | Dize türünde Özellik Adı ve Özellik Değeri değerlerine sahip bir nesne | Hayır | Ayrıntılı görünümde gösterilen ek özellikler. Özellik adları ve değerleri, { |
Bu çıkış, içgörü ayrıntılı görünümünde görüntülenen ek özellikleri gösterir. |
Not
E-posta özeti yeteneklerini ve kayıt özeti yeteneklerini genişletmeye yönelik API gereksinimleri benzer görünse de, bağlayıcıda ayrı eylemler olarak eklenmeleri gerekir.
Örnek
{
"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
}
Aşağıdaki görüntüde, API çıkışının kayıt özetine nasıl eşlendiğinin bir örneği gösterilmektedir.
Açıklama:
- Ortak uygulamadan gelen içgörüleri gösteren bölüm. Bölüm başlığı Microsoft Power Platform bağlayıcısının adından türetilir.
- API yanıtından elde edilen içgörünün açıklamaları.
- İçgörü ile ilgili ayrıntıları görüntülemek için seçilebilen alıntı numaraları.
- İçgörü hakkında ayrıntıları gösteren atıf kartı.
- İçgörünün simgesi ve başlığı. Simge Microsoft Power Platform bağlayıcı meta verilerinden alınır. Başlık metni, API yanıtındaki içgörü başlığıdır.
- API yanıtından alınan içgörülerin ek özellikleri.
- İş ortağı uygulamasının adı. Gösterilen isim Microsoft Power Platform konnektörünün ismidir.
- İş ortağı uygulamasında içgörü ayrıntılarını görüntülemek için seçilebilen bağlantı. Bu, API yanıtındaki içgörü URL'sini temel alır.
İlgili bilgiler
Kayıt özetini görüntüle
Uygulamanızdan gelen içgörülerle e-posta özetlerini zenginleştirme
E-posta taslaklarını uygulamanızdaki dosya bağlantılarıyla zenginleştirin
Önemli satış bilgilerini uygulamanızdan gelen içgörülerle zenginleştirme
CRM kayıt bilgilerini uygulamanızdan gelen içgörülerle zenginleştirme
İş ortağı uygulamalarıyla Microsoft 365 Satış için Copilot'u genişletme (önizleme)
Satış için Copilot uzantıları oluşturma