Aracılığıyla paylaş

CRM kayıt özetlerini uygulamanızdan gelen içgörülerle zenginleştirme (önizleme)

Önemli

[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. Sales uygulaması, her CRM kaydının özetini oluşturmak için yapay zeka kullanır. Bu özet, satış aşaması, bütçe ve öngörülen kapanış tarihi gibi önemli ayrıntıları vurgular. Sales uygulamasının kendi uygulamanızdan elde ettiğiniz içgörülerle sağladığı CRM kaydı özet özelliğini genişletebilirsiniz.

API açıklaması

Eyleme aşağıdaki API açıklamasını eklemeniz gerekir. Bu şekilde Sales uygulaması, ö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

Sales uygulaması, API'lerinize aşağıdaki giriş parametrelerini sağlayacak şekilde tasarlanmıştır.

Adı Veri türü/biçimi Zorunlu Details Eyleme eklenecek açıklama
kayıt türü 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.
CRM Türü 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

Sales uygulaması API'lerinizden içgörüler (nesneler) listesi almayı bekler ve her içgörüde belirli parametreler olmasını bekler. Sales uygulamasının çıkışı doğru ayrıştıradığından emin olmak için yanıt yapısının aşağıdaki tabloda yer alan yönergelere uyması gerekir.

Parametre Veri türü Zorunlu Details
value Dizi Evet İçgörüler için şema bölümünde açıklandığı gibi tanımlanan içgörülerin (nesnelerin) listesi.
dahaFazlaSonuçVar Boolean 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 Details 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.
tarih ve saat '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.
ekÖzellikler 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, Accept-Language üstbilgi aracılığıyla belirtilen dilde doğal dildedir. İşte bir örnek.

{
 “Durum nedeni”: “İmzalandı”,
 "Sahibi": "Kenny Smith"
}
 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.

Bir iş ortağı uygulamasından son etkinliklerin anatomisini gösteren ekran görüntüsü.

Açıklama:

  1. 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.
  2. API yanıtından elde edilen içgörünün açıklamaları.
  3. İçgörü ile ilgili ayrıntıları görüntülemek için seçilebilen alıntı numaraları.
  4. İçgörü hakkında ayrıntıları gösteren atıf kartı.
  5. İç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.
  6. API yanıtından alınan içgörülerin ek özellikleri.
  7. İş ortağı uygulamasının adı. Gösterilen isim Microsoft Power Platform konnektörünün ismidir.
  8. İş 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.

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
Fırsat içgörülerini uygulamanızdaki verilerle zenginleştirme
CRM kayıt bilgilerini uygulamanızdan gelen içgörülerle zenginleştirme
İş ortağı uygulamalarıyla Microsoft 365 Copilot'ta Satışları Genişletme
Microsoft 365 Copilot'ta Satış için uzantılar oluşturma

  • Last updated on