ThunderPhone v3 yayında.Hemen kendiniz kullanmaya başlayın; dakikası 2 sentten başlayan fiyatlarla.Duyuruyu okuyun

Contact centers

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

  1. SBC'nizde ajan için +14155550188 gibi bir telefon numarası seçin.
  2. SBC'de, bu numaraya gelen çağrıları TLS üzerinden 5061 numaralı bağlantı noktasında uç noktanın sip_uri değerine yönlendirin; örneğin sip:agent-12-jhxmginwjx@sip.thunderphone.com. ThunderPhone, uç noktayı hem istek URI'sinde hem de To başlığında bulunması gereken kullanıcı bölümüne (agent-12-jhxmginwjx) göre bulur. X-header'ları değiştirmeden iletin.
  3. 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ın external_call_id değeri olarak saklar. Konuşma kimliğini hangi değişkenin tuttuğunu Copilot Studio'da doğrulayın.
    • X-Customer-Tier gibi 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.summary ile handoff.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.