---
title: "เชื่อมต่อจาก Microsoft Dynamics 365"
description: "ส่งสายจาก Dynamics 365 Contact Center และ Copilot Studio ไปยัง AI เอเจนต์ ThunderPhone ผ่าน SBC ของคุณด้วย X-headers และค้นหาการส่งต่อสายของเอเจนต์ผ่าน HTTP"
---

Dynamics 365 Contact Center ส่งผู้โทรไปยังเอเจนต์ผ่าน session border controller (SBC) ของคุณ พร้อม X-header ได้สูงสุดห้ารายการ รวมถึงรหัสการสนทนา เมื่อเอเจนต์เสร็จสิ้น เอเจนต์จะวางสาย SBC ของคุณจะนำผู้โทรกลับไปยัง Dynamics 365 และโหนดคำขอ HTTP จะดึงข้อมูลการส่งต่อ

## ก่อนเริ่มต้น

- เอเจนต์ ThunderPhone และ[คีย์ API](/th/guides/api-keys) ขององค์กร
- ช่องทางเสียง Dynamics 365 Contact Center ซึ่งเชื่อมต่อผ่าน Azure Communication Services **การกำหนดเส้นทางโดยตรง** ไปยัง SBC ที่คุณดูแล
  ([ข้อกำหนดของ SBC](https://learn.microsoft.com/en-us/azure/communication-services/concepts/telephony/direct-routing-infrastructure)):
  SBC ที่รองรับพร้อมใบรับรองสาธารณะ TLS 1.2 บนพอร์ต 5061 และ SRTP ไปยัง Microsoft
- **การรองรับ SIP X-header** บนโหนด **โอนการสนทนา**
  ([Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/voice-sip-x-header))
  ตรวจสอบว่าพร้อมใช้งานในสภาพแวดล้อมของคุณ

Dynamics 365 โอนได้เฉพาะไปยังหมายเลขโทรศัพท์ และ Microsoft ตรวจสอบสิทธิ์การกำหนดเส้นทางโดยตรงด้วยใบรับรอง ไม่ใช่รหัสผ่าน SBC ของคุณอยู่ระหว่าง Microsoft และ ThunderPhone และแปลงหมายเลขนั้นเป็นที่อยู่ SIP ของเอเจนต์

## 1. สร้างปลายทาง SIP

การโทรเข้าสู่ ThunderPhone จาก SBC ของคุณ ดังนั้นให้สร้างปลายทางมาตรฐานเพื่อให้ 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"}'
```

จัดเก็บ `password` จากการตอบกลับทันที เนื่องจากจะแสดงเพียงครั้งเดียว และ SBC ของคุณจะใช้รหัสนี้เพื่อตอบกลับคำขอท้าทายของ ThunderPhone หาก SBC ของคุณไม่รองรับการตรวจสอบสิทธิ์แบบไดเจสต์ ให้สร้างปลายทางโดยตั้งค่า `auth` เป็น `ip_allowlist` และใช้ที่อยู่สาธารณะของ SBC แทน ดู
[แพลตฟอร์มที่ตรวจสอบสิทธิ์ด้วย IP ต้นทาง](/th/guides/sip-addresses)

## 2. ส่งการโทรพร้อมบริบท

1. เลือกหมายเลขโทรศัพท์สำหรับเอเจนต์บน SBC ของคุณ เช่น `+14155550188`
2. บน SBC ให้กำหนดเส้นทางการโทรไปยังหมายเลขนั้นไปยัง `sip_uri` ของปลายทาง เช่น `sip:agent-12-jhxmginwjx@sip.thunderphone.com` ผ่าน TLS บนพอร์ต `5061` ThunderPhone ค้นหาปลายทางจากส่วนผู้ใช้ (`agent-12-jhxmginwjx`) ซึ่งต้องอยู่ทั้งใน URI ของคำขอและส่วนหัว `To` ส่งต่อ X-header โดยไม่เปลี่ยนแปลง
3. ใน Copilot Studio ให้เพิ่มโหนด **โอนการสนทนา** พร้อม **การโอนหมายเลขโทรศัพท์ภายนอก** ไปยังหมายเลขนั้น และเพิ่ม X-header:
   - `X-Call-ID`: รหัสการสนทนา Dynamics 365 ไม่มีส่วนหัว Microsoft ใดส่งค่านี้มา ดังนั้นให้เพิ่มที่นี่ ThunderPhone จะจัดเก็บเป็น `external_call_id` ของการโทร ตรวจสอบใน Copilot Studio ว่าตัวแปรใดเก็บรหัสการสนทนา
   - เพิ่มได้อีกสูงสุดสี่รายการ เช่น `X-Customer-Tier`

Microsoft ส่ง X-header ได้สูงสุดห้ารายการ โดยชื่อยาวได้สูงสุด 64 อักขระ และค่ายาวได้สูงสุด 256 อักขระ ใช้ตัวอักษร ตัวเลข และ `= ; . ! % * _ + ~ -` โดยจะเขียนคำนำหน้าเป็นตัวพิมพ์เล็ก `x-` ThunderPhone จับคู่ชื่อส่วนหัวโดยไม่สนตัวพิมพ์เล็กใหญ่ ดังนั้น `x-customer-tier` จะส่งถึงพรอมต์เป็น `{{sip_x_customer_tier}}`

หากคุณสร้างการโทรด้วย Azure Communication Services Call Automation แทน `AddSipX` จะเขียนชื่อ `X-MS-Custom-` โดยค่าเริ่มต้น ส่ง `SipHeaderPrefix.X` เพื่อให้ `X-Call-ID` คงชื่อเดิม
([บริบทแบบกำหนดเอง](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/call-automation/custom-context))

## 3. รับสายกลับ

เอเจนต์จะโทรกลับ โดยกล่าวลาและวางสาย เพิ่มหมายเลขโอนสายนี้ (ดู
[เพิ่มหมายเลขโอนสาย](/th/guides/contact-centers/overview)):

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

การนำผู้โทรกลับเข้าสู่ Dynamics 365 เป็นหน้าที่ของ SBC ของคุณ Microsoft
ระบุวิธีหนึ่งสำหรับสายที่มีบริบทไว้ดังนี้: สายใหม่ผ่าน SBC ไปยังหมายเลขที่ลงทะเบียนใน Dynamics 365
พร้อม UUI ที่มีคีย์ตรงกับตัวแปรบริบทที่คุณตั้งค่าไว้ใต้ **เวิร์กสตรีม → การตั้งค่าขั้นสูง**
([การโอน IVR ของบุคคลที่สาม](https://learn.microsoft.com/en-us/dynamics365/customer-service/administer/voice-channel-contextual-transfer-external-ivr)).
หารือกับผู้ให้บริการ SBC ของคุณว่าผู้โทรจะเข้าถึงหมายเลขนั้นได้อย่างไรเมื่อ
ThunderPhone วางสาย และส่งต่อรหัสการสนทนาที่คุณส่งใน `X-Call-ID`
เพื่อให้โฟลว์ค้นหาสายได้

จากนั้นดึงข้อมูลการส่งต่อด้วยโหนด **คำขอ HTTP** ของ Copilot Studio:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  ตามด้วยรหัสการสนทนา
- ส่วนหัว `Authorization: Bearer sk_live_…`
- แยกวิเคราะห์การตอบกลับลงในตัวแปร แล้วใช้ `handoff.summary` และ
  `handoff.intent`

ดู [ค้นหาสายที่ส่งต่อ](/api-reference/calls#look-up-a-handed-off-call)

## ทดสอบ

โทรไปยังหมายเลข Dynamics 365 ที่เข้าถึงโหนดโอนสาย ขอคุยกับบุคคลจากเอเจนต์
แล้วตรวจสอบว่าผู้โทรกลับเข้าสู่ Dynamics 365 จากนั้นเปิดข้อมูลสายด้วย
`GET /v1/calls/{call_id}`: `sip_headers` ควรแสดง `x-call-id` และ
`external_call_id` ควรเป็นรหัสการสนทนา หากสายไม่เคยไปถึงเอเจนต์และบันทึก SBC
ของคุณแสดง SIP `404` URI คำขอหรือส่วนหัว `To` ไม่มีส่วนผู้ใช้ของปลายทาง

## ข้อจำกัด

- ต้องใช้ SBC Microsoft ไม่สามารถโทรไปยังที่อยู่ SIP หรือตอบรับ digest
  challenge ได้
- Microsoft ส่ง X-header ได้สูงสุดห้ารายการ และเก็บเฉพาะห้ารายการแรกสำหรับสายขาเข้า Dynamics 365 รองรับ UUI ได้สูงสุด 128 อักขระ
- Microsoft ไม่มีเอกสารสำหรับการอ่านส่วนหัวบน `BYE` ดังนั้นข้อมูลการส่งต่อจึงกลับมาได้ผ่านการค้นหาเท่านั้น
