CCaaS_CreateProactiveVoiceDelivery API'yi kullanma (önizleme)

2025-06-03

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

API'yi CCaaS_CreateProactiveVoiceDelivery kullanarak müşterilere proaktif giden sesli aramalar başlatabilir veya müşterilerin Proaktif Etkileşim Hizmeti aracılığıyla geri aramalar planlamasına izin verebilirsiniz.

Önemli

Bir kuruluş, giden bir sesli arama başlatmak için API'yi CCaaS_CreateProactiveVoiceDelivery kullanıyorsa, müşteri iletişimi için sessiz saatler ayarlamak için "arama yapma listeleri"nin manuel olarak güncellenmesi de dahil olmak üzere onay yönetiminden kuruluş sorumludur. Aşağıdaki koşulların karşılandığından emin olun:

Müşterilerle iletişime geçmeden önce uygun onay alınır
Müşterilerle yalnızca izin verilen saatlerde iletişime geçilir.

Önemli

Bu bir önizleme özelliğidir.
Önizleme özellikleri, üretimde kullanıma yönelik değildir ve sınırlı işlevselliğe sahip olabilir. Bu özellikler, ek kullanım koşullarına tabidir ve müşterilerin önceden erişmesi ve geri bildirim sağlaması amacıyla resmi sürümden önce kullanıma sunulur.

Önkoşullar

Bu API'yi çağırabilmek için Omnichannel Agent veya Omnichannel Supervisor rolüne sahip olmanız gerekir.
Proaktif katılım yapılandırılır. Proaktif etkileşimi yapılandırma (önizleme) bölümünde daha fazla bilgi edinin.

Proaktif giden çağrılar başlatın

Proaktif etkileşim, kuruluşların ses kanalı aracılığıyla giden iletişimleri başlatarak müşteri etkileşimlerini geliştirmelerini sağlar. Bir Customer Insights yolculuğu veya CCaaS_CreateProactiveVoiceDelivery.

API, CCaaS_CreateProactiveVoiceDelivery kuruluşların Proaktif Etkileşim Hizmeti aracılığıyla müşterilere proaktif giden sesli aramalar başlatmasına olanak tanır. API, Voice Runtime sistemi aracılığıyla giden sesli aramaları tetikler. Aramalar, yapılandırılan arama moduna göre hemen (herhangi bir zaman penceresi belirtilmemişse) veya sağladığınız belirlenen zaman aralıklarında yapılır.

Bu API, iletişim merkezlerinin ilgili bilgiler, hatırlatıcılar veya bildirimlerle müşterilere doğru zamanda ulaşmasına olanak tanıyarak operasyonel verimliliği optimize ederken müşteri deneyimini geliştirir.

İstek Ayrıntıları

Erişim Adresi: https://<orgurl>/api/data/v9.2/CCaaS_CreateProactiveVoiceDelivery
Yöntem: POST
Sürüm: 1.0
OData İşlemi: Eylem
OData Türü: İlişkisiz
İstek Yetkilendirmesi: Gerekli. API çağrısını yapan kullanıcı için geçerli bir Azure AD Taşıyıcı belirteci içermelidir. Bu belirteç, Müşteri Hizmetleri örneğiyle aynı Azure AD kiracısından verilmelidir.

İstek başlıkları

Anahtar	Türü	Açıklama
ApiVersion (ApiSürümü)	Dize	CCaaS API sürümü.
ProactiveEngagementConfigId	Dize	Kullanılacak Proaktif Etkileşim Yapılandırması'nın kimliği. Bu, kullanılacak arama modu türünü, iş akışını ve giden profilini belirtir. Bu kimliği almak için aşağıdakileri yapın: Power Apps'e gidin ve gerekli ortamı seçin. Seçme Tabloları>Proaktif Etkileşim Yapılandırması Gerekli kaydın kimliğini seçin.
Hedef Telefon Numarası	Dize	Aranacak müşterinin telefon numarası.
İletişim Kimliği	Dize	Dynamics CRM'deki müşteri ilgili kişisinin kimliği.
Windows	Window nesnelerinin JSON dizisi	Giden çağrının yapılabileceği geçerli zaman aralıklarını belirtir. Sağlanmazsa, sistem varsayılan olarak hemen başlayan 24 saatlik bir pencereye ayarlanır (geçerli saatten 24 saat sonrasına kadar).
InputAttributes	Anahtar-değer dizelerinin JSON nesnesi	Opsiyonel. Davranışı özelleştirmek, koşullu mantığı yönlendirmek veya Dataverse kayıtlarından kişiselleştirilmiş bilgileri almak için Copilot aracı akışlarında başvurulabilecek değişkenler.

Windows nesnesi

Anahtar	Türü	Açıklama
Başlangıç	Dize	Bu pencerenin başlangıç zaman damgası. Biçiminde UTC `yyyy-MM-ddTHH:mm:ss.fffZ` olarak belirtilmelidir.
Son	Dize	Bu pencerenin bitiş zaman damgası. Biçiminde UTC `yyyy-MM-ddTHH:mm:ss.fffZ` olarak belirtilmelidir.

Numune isteği


{
  "ApiVersion": "1.0",
  "ProactiveEngagementConfigId": "cbbac510-3e66-ef11-a671-6045bd03d9d8",
  "DestinationPhoneNumber": "+123456798",
  "ContactId": "761e062f-c734-ef11-8e4f-00224808a166",
  "Windows": [
    {
      "Start": "2024-09-10T13:00:00.000Z",
      "End": "2024-09-10T15:59:59.999Z"
    },
    {
      "Start": "2024-09-11T13:00:00.000Z",
      "End": "2024-09-11T15:59:59.999Z"
    }
  ],
  "InputAttributes": {
    "orderNumber": "ORD123456789",
    "type": "callback",
    "isFinalAttempt": "false"
  }
}

Yanıt ayrıntıları

Başarılı olursa, bu yöntem döndürür DeliveryId. Teslim Kimliği, API aracılığıyla kabul edilen ve msdyn_proactive_delivery tabloda depolanan her proaktif etkileşim isteğine atanan benzersiz bir tanımlayıcıdır.

Örnek yanıt aşağıdaki gibidir:


{
	"@odata.context": "[Organization URI]api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.CCaaS_CreateProactiveVoiceDeliveryResponse",
	"DeliveryId": "9838deee-0b4e-4116-bf73-ecb80474568d"
}

Herhangi bir platformdan geri aramaları planlayın

Web, mobil uygulamalar, ses ve sohbet aracıları dahil olmak üzere çeşitli platformlardan geri aramalar planlamak için Proaktif Etkileşim çözümünü kullanabilirsiniz. Bunu şu şekillerde yapabilirsiniz:

Copilot Studio aracısından bir Power Automate akışı oluşturun.
Zamanlama geri arama API'sini web sitenizle entegre edin.

Copilot aracısından bir Power Automate akışı oluşturma

Geri çağırmaları zamanlamak için Copilot aracısından bir Power Automate akışı oluşturabilirsiniz. Aşağıdaki adımları gerçekleştirin:

Aşağıdaki parametrelerle bir aracıyla kullanabileceğiniz bir akış oluşturma bölümündeki adımları uygulayın:

İlişkisiz bir eylem gerçekleştir'i eylem olarak belirtin.
Eylem Adı olarak CCaaS_CreateProactiveVoiceDelivery'yi seçin.
Gelişmiş parametreler'de, aşağıdaki zorunlu alanları belirtin:
- Item/DestinationPhoneNumber: Aranacak müşterinin telefon numarası.
- Item/ProactiveEngagementConfigId: Kullanılacak proaktif etkileşim yapılandırmasının kimliği. Bu, müşteriyle iletişim kurarken kullanılacak arama modu türünü, iş akışını ve giden profili gösterir. Bu kimliği Power Apps >Tabloları>Proaktif Etkileşim Yapılandırması tablosundan kopyalayabilirsiniz.
- Öğe/ApiVersion: 1.0
- Item/ContactId: Dynamics CRM'deki müşteri ilgili kişisinin kimliği.
- İsteğe bağlı olarak, Item/InputAttributes belirtebilirsiniz. Bu alan, Copilot aracısı tarafından kullanılan bir JSON nesnesi içermelidir. Örneğin, { "msdyn_CaseTitle" : "Vitre cassée", "msdyn_CustomerName" : "Sarah", "msdyn_CustomerPhone" : "+1234567890", "msdyn_CustomerId" : "cfaa617b-2fc1-ef11-b8e8-000d3a5bcd16" }.

Geri aramaları planlamak için API'yi kullanın

Müşterilerin kendileri için en uygun zamanlarda yardım istemelerine izin vermek için API'yi web sitenize entegre CCaaS_CreateProactiveVoiceDelivery edin.

Örnek İstek

{
  "ApiVersion": "1.0",
  "ProactiveEngagementConfigId": "cbbac510-3e66-ef11-a671-6045bd03d9d8",
  "DestinationPhoneNumber": "+123456798",
  "ContactId": "761e062f-c734-ef11-8e4f-00224808a166",
  "Windows": [
    {
      "Start": "2024-09-10T13:00:00.000Z",
      "End": "2024-09-10T15:59:59.999Z"
    },
    {
      "Start": "2024-09-11T13:00:00.000Z",
      "End": "2024-09-11T15:59:59.999Z"
    }
  ],
  "InputAttributes": {
     "type": "callback"
    "isLastAttempt": "false"
  }
}

Raporlama için proaktif etkileşim tablolarını kullanın