Aracılığıyla paylaş


Uygulamanızdan gelen içgörülerle e-posta özetlerini zenginleştirme (önizleme)

Önemli

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

Outlook'ta Copilot ve Satış için Copilot birlikte kullanıldığında, Outlook'ta gösterilen e-posta özetleri, Dynamics 365 veya Salesforce CRM gibi müşteri ilişkileri yönetimi (CRM) sisteminizden alınan satış bilgilerini içerir. Satış için Copilot tarafından sağlanan e-posta ö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, Outlook özeti içindeki C4S e-posta özeti deneyiminde gösterilecek ek satış içgörüleri sağlar. 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 Hayır CRM'deki kayıt türü. Kayıt, e-postayla ilişkili hesabı, fırsatı, potansiyel müşteriyi veya kişiyi belirtebilir. Bu giriş, CRM'deki özetlenmiş e-postayla ilişkili kayıt türü tanımlar.
recordId Diize Hayır İlgili kayıtların talep edildiği CRM'deki kayıt kimliği. Bu giriş, CRM'deki özetlenmiş e-postayla ilişkili benzersiz tanıtıcıyı sağlar.
crmType Diize Hayır CRM sisteminin türü. Geçerli değerler Salesforce ve Dynamics 365'tir. Bu giriş, özetlenmiş e-postayla ilişkili kayıt türüne ait CRM türünü belirtir.
crmOrgUrl Diize Hayır CRM kuruluşu URL'si. Bu giriş, özetlenmiş e-postayla ilişkili kayıt türüne ait CRM ortamının URL'sini belirtir.
emailContacts Diize Evet E-posta adreslerinin virgülle ayrılmış listesi, örneğin kenny@contoso.com,logan@contoso.com. Bu giriş geçerli e-posta ileti dizisindeki ilgili tüm katılımcı e-postalarının bir listesini 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ş, içgörüler alırken atlanacak öğe sayısını gösterir.

Çı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.

Not: Değer parametresi bir içgörüler listesi içermesine rağmen, e-posta zenginleştirme özetinde yalnızca ilk içgörü kullanılır.

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
Title En fazla 20 karakter uzunluğunda dize Evet Satış içgörüsünün başlığı. Bu çıkış, iş ortağı bölümünün başlığını gösterir ve yalnızca iş ortağının adını içermelidir.
Açıklama Diize Evet Meslektaşlarınız Mona Kane, Ray Tanaka ve Daniela Smith daha önce onlarla çalışmıştı gibi kullanıcılara sunulan içgörü. Bu çıkış, e-posta özetinde yer almasını istediğiniz metni 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": "From Contoso Customer Insights",
            "description": "Your colleagues Mona Kane, Ray Tanaka, and Daniela Smith have worked with them before."
        }
    ],
    "hasMoreResults": false
}

Aşağıdaki görüntüde, API çıkışının e-posta özetine nasıl eşlendiğinin bir örneği gösterilmektedir.

İş ortağı uygulamalarından gelen içgörüleri e-posta özetinde gösteren ekran görüntüsü.

Açıklama:

  1. İçgörünün başlığı. Aynı başlığa sahip içgörüler birlikte gruplandırılır.
  2. İçgörülerin açıklaması. Her bir içgörünün bir açıklaması vardır.

Outlook'ta Copilot ile satış bilgilerini kullanarak e-posta ileti dizilerini özetleme
Ö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
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)
E-posta taslaklarını uygulamanızdaki dosya bağlantılarıyla zenginleştirin
Satış için Copilot uzantıları oluşturma