ThunderPhone v3 kini tersedia.Gunakan langsung secara mandiri, mulai 2¢/menit.Baca pengumumannya

Contact centers

Hubungkan dari Microsoft Dynamics 365

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 organisasi.
  • Kanal suara Dynamics 365 Contact Center, yang terhubung melalui Azure Communication Services Direct Routing ke SBC yang Anda jalankan (persyaratan SBC): 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). 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:

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.

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

3. Kembalikan panggilan

Agen mengembalikan panggilan: agen mengucapkan selamat tinggal lalu menutup panggilan. Tambahkan nomor transfer ini (lihat Tambahkan nomor transfer):

{"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). 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.

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.