Aracılığıyla paylaş

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

  • Makale

Önemli

[Bu makale, yayın öncesi belgelerine dahildir ve değiştirilebilir.]

Satıcılar kaydedilmiş bir ilgili kişiyle ilgili ayrıntıların yanı sıra firma ve fırsatlar gibi ilişkili kayıtları da görüntüleyebilir. Satış için Copilot'ın sağladığı müşteri ilişkileri yönetimi (CRM) kayıt ayrıntılarını kendi uygulamanızdan elde ettiğiniz bilgilerle 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, bir CRM kaydıyla ilgili kayıtları 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 ilgili kayıtların istendiği varlık veya nesne 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 ilgili kayıtların istendiği kayıt türünü tanımlar.
recordId Diize Evet CRM kaydının benzersiz tanımlayıcısı. Bu giriş, CRM kaydında ilgili kayıtların istendiği benzersiz tanıtıcıyı sağlar.
üst Tam sayı Hayır Getirilecek etkinliklerin sayısı. Bu giriş, almak için ilgili kayıtların sayısını gösterir.
atla Tam sayı Hayır Atlanacak etkinliklerin sayısı. Bu giriş, ilgili kayıtlar alınırken atlanacak kayıt sayısını gösterir.
crmType Diize Hayır CRM sisteminin türü. Geçerli değerler Dynamics 365 ve Salesforce'tur. Bu giriş, ilgili kayıtların getirildiği CRM türünü gösterir.
crmOrgUrl Diize Hayır CRM kuruluşunun ana bilgisayar adı, örneğin contoso.crm.dynamics.com. Bu giriş, ilgili kayıtların getirildiği CRM ortamının URL'sini gösterir.

Not

Bu uzantı noktası, Outlook yan bölmesindeki beş adede kadar bağlayıcı uzantısından gelen içgörülerin işlenmesini destekler.

Çı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 Eyleme eklenecek açıklama
recordId Diize Evet Kaydın benzersiz tanımlayıcısı. Bu çıkış, eylem tarafından döndürülen her ilgili kaydı benzersiz şekilde tanımlar.
recordTypeDisplayName Diize Evet Kayıt türünün görünen adı, örneğin Sözleşme. Accept-Language üst bilgisi aracılığıyla belirtilen dilde yerelleştirilmelidir. Bu çıkış, eylem tarafından döndürülen her ilgili kaydın kayıt türünün görünen adını belirtir.
recordTypePluralDisplayName Diize Evet Sözleşmeler gibi kayıt türünün çoğul görüntü adı. Accept-Language üst bilgisi aracılığıyla belirtilen dilde yerelleştirilmelidir. Bu çıkış, eylem tarafından döndürülen her ilgili kaydın kayıt türünün çoğul görünen adını belirtir.
recordType Diize Evet Kayıt türünün sistem adı, örneğin sözleşme. Bu çıkış, eylem tarafından döndürülen her ilgili kaydın türünü belirtir.
recordTitle Diize Evet Kayıt türünün görünen adı, örneğin Contoso 2023 Yenileme Sözleşme. Bu çıkış, eylem tarafından döndürülen her ilgili kaydın adını belirtir.
url Diize Hayır İş ortağı uygulamasında kayıt açmak için geçerli bir URL. Bu çıkış, eylem tarafından döndürülen her ilgili kaydın URL'sini belirtir.
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, Accept-Language üstbilgi aracılığıyla belirtilen dilde doğal dildedir. İşte bir örnek.

{
 “Durum nedeni”: “İmzalandı”,
 "Sahibi": "Kenny Smith"
}
 Bu çıkış, eylem tarafından döndürülen ilgili kaydın ad-değer çiftleri olarak ek özellikleri gösterir.

Örnek

{
    "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
}

Aşağıdaki resimde, API çıktısının ilgili kayıtlarla nasıl eşlendiğine ilişkin bir örnek gösterilmektedir.

Bir iş ortağı uygulamasından ilgili kayıtların anatomisini gösteren ekran görüntüsü.

Açıklama:

  1. İş ortağı uygulamasındaki ilgili kayıtları gösteren kart.
  2. Kartın simgesi ve başlığı. Simge Microsoft Power Platform bağlayıcı meta verilerinden alınır. Başlık Microsoft Power Platform konnektörünün adıdır.
  3. API yanıtındaki ilgili kayıt başlıkları. API yanıtından iki ek özellik, ilgili her kaydın anahtar alanları olarak işlenir.
  4. Kaydın bağlantısını kopyalamak veya iş ortağı uygulamasında kayıt ayrıntılarını görüntülemek için kullanılabilen "Diğer eylemler" düğmesi. Bağlantı, API yanıtındaki ilgili kaydın URL'sini temel alır.
  5. API yanıtından alınan ilgili kayıt ek özellikleri.

Kayıt ayrıntılarını 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 özetlerini 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