---
title: "Microsoft Dynamics 365'ten bağlanın"
description: "Dynamics 365 Contact Center ve Copilot Studio çağrılarını X-başlıklarıyla SBC'niz üzerinden bir ThunderPhone ajanına gönderin ve ajanın aktarımını HTTP üzerinden sorgulayın."
---

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ı](/tr/guides/api-keys).
- 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](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  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](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  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:

```bash
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](/tr/guides/sip-addresses).

## 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](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 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](/tr/guides/contact-centers/overview)):

```json
{"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ı](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
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](/api-reference/calls#look-up-a-handed-off-call).

## 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.
