---
title: "Hubungkan dari Microsoft Dynamics 365"
description: "Kirim panggilan Dynamics 365 Contact Center dan Copilot Studio ke agen ThunderPhone melalui SBC Anda dengan X-header, dan cari hand-off agen melalui HTTP."
---

Dynamics 365 Contact Center mengirim penelepon ke agen melalui session border controller (SBC) Anda, dengan hingga lima X-header termasuk ID percakapan. Saat agen selesai, agen mengakhiri panggilan, SBC Anda mengembalikan penelepon ke Dynamics 365, dan node Permintaan HTTP mengambil hand-off.

## Sebelum memulai

- Agen ThunderPhone dan [kunci API](/id/guides/api-keys) organisasi.
- Kanal suara Dynamics 365 Contact Center, yang terhubung melalui Azure Communication Services **Direct Routing** ke SBC yang Anda jalankan
  ([persyaratan SBC](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  SBC yang didukung dengan sertifikat publik, TLS 1.2 pada port 5061, dan SRTP ke Microsoft.
- **Dukungan SIP X-header** pada node **Transfer percakapan**
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header)).
  Pastikan fitur ini tersedia di lingkungan Anda.

Dynamics 365 hanya mentransfer ke nomor telepon, dan Microsoft mengautentikasi Direct Routing dengan sertifikat, bukan kata sandi. SBC Anda berada di antara Microsoft dan ThunderPhone serta mengubah nomor tersebut menjadi alamat SIP agen.

## 1. Buat endpoint SIP

Panggilan mencapai ThunderPhone dari SBC Anda, jadi buat endpoint standar untuk digunakan SBC:

```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"}'
```

Simpan `password` dari respons segera; nilai ini hanya ditampilkan sekali, dan SBC Anda menjawab tantangan ThunderPhone dengannya. Jika SBC Anda tidak mendukung autentikasi digest, buat endpoint dengan `auth` diatur ke `ip_allowlist` dan alamat publik SBC Anda; lihat
[Platform yang mengautentikasi berdasarkan IP sumber](/id/guides/sip-addresses).

## 2. Kirim panggilan dengan konteks

1. Pilih nomor telepon untuk agen di SBC Anda, misalnya `+14155550188`.
2. Di SBC, rutekan panggilan ke nomor tersebut ke `sip_uri` endpoint, misalnya `sip:agent-12-jhxmginwjx@sip.thunderphone.com`, melalui TLS pada port
   `5061`. ThunderPhone menemukan endpoint berdasarkan bagian pengguna
   (`agent-12-jhxmginwjx`), yang harus ada di URI permintaan dan header
   `To`. Teruskan X-header tanpa perubahan.
3. Di Copilot Studio, tambahkan node **Transfer percakapan** dengan
   **Transfer nomor telepon eksternal** ke nomor tersebut, lalu tambahkan X-header:
   - `X-Call-ID`: ID percakapan Dynamics 365. Tidak ada header Microsoft yang membawanya, jadi tambahkan di sini; ThunderPhone menyimpannya sebagai
     `external_call_id` panggilan. Pastikan di Copilot Studio variabel mana yang menyimpan ID percakapan.
   - Hingga empat header lainnya, seperti `X-Customer-Tier`.

Microsoft mengirim paling banyak lima X-header, dengan nama hingga 64 karakter dan nilai hingga 256 karakter, menggunakan huruf, angka, serta `= ; . ! % * _ + ~ -`. Microsoft menulis awalan sebagai `x-` huruf kecil; ThunderPhone mencocokkan nama header tanpa memedulikan huruf besar-kecil, sehingga `x-customer-tier` mencapai Prompt sebagai `{{sip_x_customer_tier}}`.

Jika Anda membuat panggilan menggunakan Azure Communication Services Call Automation, `AddSipX` secara default menulis nama `X-MS-Custom-`. Teruskan
`SipHeaderPrefix.X` agar `X-Call-ID` mempertahankan namanya
([konteks kustom](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context)).

## 3. Kembalikan panggilan

Agen mengembalikan panggilan: agen mengucapkan selamat tinggal lalu menutup panggilan. Tambahkan nomor transfer ini (lihat
[Tambahkan nomor transfer](/id/guides/contact-centers/overview)):

```json
{"name": "Dynamics 365", "action": "return"}
```

Mengembalikan penelepon ke Dynamics 365 adalah tugas SBC Anda. Microsoft
mendokumentasikan satu cara masuk untuk panggilan dengan konteks: panggilan baru melalui SBC ke
nomor yang terdaftar di Dynamics 365, dengan UUI yang kuncinya cocok dengan variabel konteks
yang Anda siapkan di **Alur kerja → Pengaturan lanjutan**
([transfer IVR pihak ketiga](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
Koordinasikan dengan vendor SBC Anda cara penelepon mencapai nomor tersebut saat
ThunderPhone menutup panggilan, dan teruskan id percakapan yang Anda kirim dalam `X-Call-ID`
agar alur dapat menemukan panggilan tersebut.

Kemudian ambil serah-terima dengan node **HTTP Request** Copilot Studio:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  diikuti id percakapan.
- Header `Authorization: Bearer sk_live_…`.
- Uraikan respons ke dalam variabel lalu gunakan `handoff.summary` dan
  `handoff.intent`.

Lihat [Cari panggilan yang diserahkan](/api-reference/calls#look-up-a-handed-off-call).

## Uji

Hubungi nomor Dynamics 365 yang mencapai node transfer, minta agen menyambungkan Anda ke
seseorang, lalu periksa bahwa penelepon kembali ke Dynamics 365. Kemudian buka panggilan
dengan `GET /v1/calls/{call_id}`: `sip_headers` harus mencantumkan `x-call-id`, dan
`external_call_id` harus berupa id percakapan. Jika panggilan tidak pernah mencapai
agen dan log SBC Anda mencatat SIP `404`, URI permintaannya atau header `To` tidak membawa
bagian pengguna endpoint.

## Batasan

- SBC diperlukan. Microsoft tidak dapat memanggil alamat SIP atau menjawab tantangan
  digest.
- Microsoft mengirim paling banyak lima header X, dan hanya menyimpan lima header pertama pada
  panggilan masuk. Dynamics 365 menerima UUI hingga 128 karakter.
- Microsoft tidak mendokumentasikan pembacaan header pada `BYE`, sehingga serah-terima
  hanya kembali melalui pencarian.
