Open in
เชื่อมต่อจาก Microsoft Dynamics 365
ส่งสายจาก 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 ขององค์กร
- ช่องทางเสียง Dynamics 365 Contact Center ซึ่งเชื่อมต่อผ่าน Azure Communication Services การกำหนดเส้นทางโดยตรง ไปยัง SBC ที่คุณดูแล (ข้อกำหนดของ SBC): SBC ที่รองรับพร้อมใบรับรองสาธารณะ TLS 1.2 บนพอร์ต 5061 และ SRTP ไปยัง Microsoft
- การรองรับ SIP X-header บนโหนด โอนการสนทนา (Copilot Studio) ตรวจสอบว่าพร้อมใช้งานในสภาพแวดล้อมของคุณ
Dynamics 365 โอนได้เฉพาะไปยังหมายเลขโทรศัพท์ และ Microsoft ตรวจสอบสิทธิ์การกำหนดเส้นทางโดยตรงด้วยใบรับรอง ไม่ใช่รหัสผ่าน SBC ของคุณอยู่ระหว่าง Microsoft และ ThunderPhone และแปลงหมายเลขนั้นเป็นที่อยู่ SIP ของเอเจนต์
1. สร้างปลายทาง SIP
การโทรเข้าสู่ ThunderPhone จาก SBC ของคุณ ดังนั้นให้สร้างปลายทางมาตรฐานเพื่อให้ 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"}'จัดเก็บ password จากการตอบกลับทันที เนื่องจากจะแสดงเพียงครั้งเดียว และ SBC ของคุณจะใช้รหัสนี้เพื่อตอบกลับคำขอท้าทายของ ThunderPhone หาก SBC ของคุณไม่รองรับการตรวจสอบสิทธิ์แบบไดเจสต์ ให้สร้างปลายทางโดยตั้งค่า auth เป็น ip_allowlist และใช้ที่อยู่สาธารณะของ SBC แทน ดู
แพลตฟอร์มที่ตรวจสอบสิทธิ์ด้วย IP ต้นทาง
2. ส่งการโทรพร้อมบริบท
- เลือกหมายเลขโทรศัพท์สำหรับเอเจนต์บน SBC ของคุณ เช่น
+14155550188 - บน SBC ให้กำหนดเส้นทางการโทรไปยังหมายเลขนั้นไปยัง
sip_uriของปลายทาง เช่นsip:agent-12-jhxmginwjx@sip.thunderphone.comผ่าน TLS บนพอร์ต5061ThunderPhone ค้นหาปลายทางจากส่วนผู้ใช้ (agent-12-jhxmginwjx) ซึ่งต้องอยู่ทั้งใน URI ของคำขอและส่วนหัวToส่งต่อ X-header โดยไม่เปลี่ยนแปลง - ใน 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 คงชื่อเดิม
(บริบทแบบกำหนดเอง)
3. รับสายกลับ
เอเจนต์จะโทรกลับ โดยกล่าวลาและวางสาย เพิ่มหมายเลขโอนสายนี้ (ดู เพิ่มหมายเลขโอนสาย):
{"name": "Dynamics 365", "action": "return"}การนำผู้โทรกลับเข้าสู่ Dynamics 365 เป็นหน้าที่ของ SBC ของคุณ Microsoft
ระบุวิธีหนึ่งสำหรับสายที่มีบริบทไว้ดังนี้: สายใหม่ผ่าน SBC ไปยังหมายเลขที่ลงทะเบียนใน Dynamics 365
พร้อม UUI ที่มีคีย์ตรงกับตัวแปรบริบทที่คุณตั้งค่าไว้ใต้ เวิร์กสตรีม → การตั้งค่าขั้นสูง
(การโอน 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
ทดสอบ
โทรไปยังหมายเลข 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ดังนั้นข้อมูลการส่งต่อจึงกลับมาได้ผ่านการค้นหาเท่านั้น