Open in
Microsoft Dynamics 365
Dynamics 365 Contact Center ve Copilot Studio çağrılarını X-başlıklarıyla SBC
Dynamics 365 Contact Center, arayanı konuşma kimliği dahil en fazla beş X-header ile oturum sınır denetleyiciniz (SBC) üzerinden ajana gönderir. Ajan işi tamamladığında aramayı sonlandırır, SBC'niz arayanı Dynamics 365'e geri getirir ve bir HTTP İsteği düğümü aktarmayı alır.
Başlamadan önce
- Bir ThunderPhone ajanı ve bir kuruluş API anahtarı.
- Azure Communication Services Doğrudan Yönlendirme aracılığıyla işlettiğiniz bir SBC'ye bağlı Dynamics 365 Contact Center ses kanalı (SBC gereksinimleri): genel sertifikalı desteklenen bir SBC, 5061 numaralı bağlantı noktasında TLS 1.2 ve Microsoft'a yönelik SRTP.
- Konuşmayı aktar düğümünde SIP X-header desteği (Copilot Studio). Ortamınızda kullanılabilir olduğunu doğrulayın.
Dynamics 365 yalnızca bir telefon numarasına aktarım yapar ve Microsoft, Doğrudan Yönlendirme kimlik doğrulamasını parolayla değil sertifikayla yapar. SBC'niz Microsoft ile ThunderPhone arasında yer alır ve bu numarayı ajanın SIP adresine dönüştürür.
1. SIP uç noktasını oluşturun
Çağrı ThunderPhone'a SBC'nizden ulaşır; bu nedenle SBC'nin kullanması için standart bir uç nokta oluşturun:
curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"agent_id": 12, "name": "Dynamics 365 SBC"}'Yanıttaki password değerini hemen kaydedin; yalnızca bir kez gösterilir ve
SBC'niz ThunderPhone'un sorgusuna bu değerle yanıt verir. SBC'niz özet
kimlik doğrulaması yapamıyorsa, bunun yerine uç noktayı auth değeri
ip_allowlist olacak şekilde ve SBC'nizin genel adresiyle oluşturun; bkz.
Kaynak IP ile kimlik doğrulayan platformlar.
2. Çağrıları bağlamla gönderin
- SBC'nizde ajan için
+14155550188gibi bir telefon numarası seçin. - SBC'de, bu numaraya gelen çağrıları TLS üzerinden
5061numaralı bağlantı noktasında uç noktanınsip_urideğerine yönlendirin; örneğinsip:agent-12-jhxmginwjx@sip.thunderphone.com. ThunderPhone, uç noktayı hem istek URI'sinde hem deTobaşlığında bulunması gereken kullanıcı bölümüne (agent-12-jhxmginwjx) göre bulur. X-header'ları değiştirmeden iletin. - Copilot Studio'da, bu numaraya Harici telefon numarasına aktarım içeren
bir Konuşmayı aktar düğümü ekleyin ve X-header'ları ekleyin:
X-Call-ID: Dynamics 365 konuşma kimliği. Hiçbir Microsoft başlığı bunu taşımaz; bu nedenle burada ekleyin. ThunderPhone bunu çağrınınexternal_call_iddeğeri olarak saklar. Konuşma kimliğini hangi değişkenin tuttuğunu Copilot Studio'da doğrulayın.X-Customer-Tiergibi en fazla dört ek başlık.
Microsoft; adları en fazla 64 karakter, değerleri en fazla 256 karakter olan ve
harfler, rakamlar ile = ; . ! % * _ + ~ - kullanılan en fazla beş X-header
gönderir. Ön eki küçük harfli x- olarak yazar; ThunderPhone başlık adlarını
büyük/küçük harfe duyarsız olarak eşleştirir; dolayısıyla x-customer-tier,
isteme {{sip_x_customer_tier}} olarak ulaşır.
Bunun yerine çağrıyı Azure Communication Services Call Automation ile
oluşturuyorsanız, AddSipX varsayılan olarak X-MS-Custom- adlarını yazar.
X-Call-ID adının korunması için SipHeaderPrefix.X aktarın
(özel bağlam).
3. Çağrıyı geri alın
Ajan çağrıyı geri döndürür: vedalaşır ve bağlantıyı kapatır. Bu aktarım numarasını ekleyin (bkz. Aktarım numarasını ekleme):
{"name": "Dynamics 365", "action": "return"}Arayan kişiyi Dynamics 365'e geri getirmek SBC'nizin görevidir. Microsoft,
bağlam içeren bir çağrının giriş yöntemlerinden birini belgeler: Dynamics
365'te kayıtlı bir numaraya SBC üzerinden yapılan yeni bir çağrı ve
İş akışları → Gelişmiş ayarlar altında ayarladığınız bağlam değişkenleriyle
anahtarları eşleşen UUI
(üçüncü taraf IVR aktarımı).
ThunderPhone bağlantıyı kapattığında arayan kişinin bu numaraya nasıl
ulaşacağını SBC sağlayıcınızla belirleyin ve akışın çağrıyı bulabilmesi için
X-Call-ID içinde gönderdiğiniz konuşma kimliğini taşıyın.
Ardından Copilot Studio'daki bir HTTP İsteği düğümüyle aktarımı alın:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=ardından konuşma kimliği.Authorization: Bearer sk_live_…üst bilgisi.- Yanıtı bir değişkene ayrıştırın ve
handoff.summaryilehandoff.intentöğelerini kullanın.
Bkz. Aktarılan bir çağrıyı arama.
Test edin
Aktarım düğümüne ulaşan bir Dynamics 365 numarasını arayın, ajandan bir insana
aktarılmanızı isteyin ve arayan kişinin Dynamics 365'e geri döndüğünü kontrol
edin. Ardından çağrıyı GET /v1/calls/{call_id} ile açın: sip_headers,
x-call-id öğesini listelemeli ve external_call_id konuşma kimliği olmalıdır.
Çağrı ajana hiç ulaşmıyorsa ve SBC günlükleriniz SIP 404 gösteriyorsa, istek
URI'si veya To üst bilgisi uç noktanın kullanıcı bölümünü taşımıyordur.
Sınırlar
- Bir SBC gereklidir. Microsoft bir SIP adresini arayamaz veya bir özet doğrulama isteğine yanıt veremez.
- Microsoft en fazla beş X üst bilgisi gönderir ve gelen bir çağrıda yalnızca ilk beşini korur. Dynamics 365 en fazla 128 karakter UUI alır.
- Microsoft,
BYEüzerindeki üst bilgilerin okunmasını belgelemez; bu nedenle aktarım yalnızca arama yoluyla geri alınır.