Önemli satış bilgilerini 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 Outlook'ta e-postaları okuyup oluştururken, e-postayla ilgili kişiler, hesaplar ve fırsatlar hakkında önemli satış bilgilerini görüntülemek için Satış için Copilot'ı kullanabilirler. Önemli satış bilgileri aşağıdaki kaynaklardan birine dayanır:
- E-postaya bağlı olan fırsat
- E-postadaki ilgili kişilere ve firmalara göre en alakalı fırsat
Satış için Copilot tarafından sağlanan önemli satış bilgileri 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 sepetindeki C4S anahtar satış bilgileri kartında gösterilecek 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 | Müşteri ilişkileri yönetimindeki (CRM) kayıt türü. Kayıt, e-postayla ilişkili hesabı, fırsatı, potansiyel müşteriyi veya kişiyi belirtebilir. | Bu giriş, CRM'de önemli satış bilgilerinin istendiği kayıt türünü tanımlar. |
| recordId | Diize | Evet | CRM'deki kayıt kimliği. | Bu giriş, CRM kaydında önemli satış bilgilerinin istendiği 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ş, önemli satış bilgisi istenen CRM kaydının var olduğu CRM türünü belirtir. |
| crmOrgUrl | Diize | Hayır | CRM kuruluşu URL'si. | Bu giriş, önemli satış bilgisi istenen CRM kaydının var olduğu CRM ortamının URL'sini belirtir. |
| üst | Tam sayı | Hayır | Getirilecek içgörülerin sayısı. | Bu giriş, almak için önemli satış kısımlarının sayısını gösterir. |
| atla | Tam sayı | Hayır | Atlanacak içgörü sayısı. | Bu giriş, önemli satış kısımları 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. |
| 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 |
|---|---|---|---|---|
| başlık | Diize | Evet | Satış içgörüsü atıf kartının başlığı. Yalnızca iş ortağının adını içermelidir ve en fazla 20 karakterden oluşabilir. | Bu çıkış bu içgörü için atıf kartı başlığını gösterir. |
| Açıklama | Diize | Evet | Satış içgörüsü açıklaması. Önemli satış bilgileri bölmesinde madde işareti olarak gösterilir ve en fazla 130 karakterden oluşabilir. İşte bir örnek: Doğrulama: Sonraki adımlar: Zaman çizelgesi ve başarı ölçütleriyle uyumlu hale getirme. | Bu çıkış, temel satış bilgilerine dahil edilecek içgörü metnini gösterir. |
| url | Diize | Hayır | İş ortağı uygulamasında içgörü açmak için geçerli bir URL. | Bu çıkış, içgörü hakkında daha fazla bilgi edinmek için URL'yi gösterir. |
| dateTime | DateTime | Hayır | 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. |
| additionalProperties | Dize türünde Özellik Adı ve Özellik Değeri değerlerine sahip bir nesne | Hayır | Eylemin döndürdüğü ilgili içgörünün ek özelliklerini belirten bir ad-değer çiftleri kümesi. Bu bilgiler, kullanıcılar Önemli satış bilgileri bölmesinde içgörüleri seçtiğinde bir açılır kartta gösterilir. | Bu çıkış, eylem tarafından döndürülen ilgili içgörünün ad-değer çiftleri olarak ek özellikleri gösterir. |
Örnek
{
"value": [
{
"title": "Contract signed",
"description": "Kenny Smith sent Renewal Contract on 04/23/2023 related to 50 Cafe A-100 Automatic",
"dateTime": "2023-09-07T03:42:35.4662309Z",
"url": https://contosohub.com,
"additionalProperties": {
"Contract name": "Renewal contract for Fourth Coffee",
"Signed by": "Alberto Burgos, Tony Benis",
"Signed": "9/7/23",
"Related Opportunity": "50 CafeA-100 Automatic"
}
}
],
"hasMoreResults": false
}
Aşağıdaki görseldeki örnek, API çıktısının temel satış bilgilerine nasıl eşlendiğini göstermektedir.
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, 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
Satış için Copilot'ta önemli satış bilgilerini görüntüleme
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
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)
Satış için Copilot uzantıları oluşturma