Open in
เชื่อมต่อจาก NICE CXone
ส่งสายจาก NICE CXone ไปยังเอเจนต์ ThunderPhone จากสคริปต์ Studio โดยใส่ ContactID ในส่วนหัว SIP และค้นหาการส่งต่อของเอเจนต์เมื่อสคริปต์ดำเนินต่อ
สคริปต์ CXone Studio ของคุณจะโทรไปยังเอเจนต์พร้อมส่วนหัว SIP ที่มีรหัสผู้ติดต่อและบริบทอื่นๆ เมื่อเอเจนต์ดำเนินการเสร็จแล้ว เอเจนต์จะวางสาย และการดำเนินการ REST API ในสคริปต์จะดึงข้อมูลการส่งต่อ
ก่อนเริ่มต้น
- เอเจนต์ ThunderPhone และคีย์ APIขององค์กร
- กลุ่ม SIP trunk ของ CXone ที่ยอมรับส่วนหัวแบบกำหนดเอง ตัวแทนบัญชี NICE ของคุณต้องเปิดการตั้งค่านี้ก่อนที่ CXone จะส่งส่วนหัวเหล่านั้น
1. สร้างปลายทาง SIP
Placecall โทรออกไปยังหมายเลขโทรศัพท์ผ่านกลุ่ม trunk ของ CXone ไม่ใช่ที่อยู่ SIP NICE ไม่มีเอกสารข้อมูลรับรอง SIP สำหรับการดำเนินการนี้ และการผสานรวม CXone ของผู้ให้บริการ AI รายอื่นใช้ TLS ร่วมกับรายการอนุญาต IP ดังนั้นให้สร้างปลายทาง ip_allowlist โดยใช้หมายเลขที่สคริปต์จะโทรเป็นหมายเลขโทรเข้า (ดูแพลตฟอร์มที่โทรไปยังหมายเลขโทรศัพท์):
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": "NICE CXone",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["CXONE_SIGNALLING_RANGE_1", "CXONE_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["+14155550188"]
}'allowed_source_cidrs: ช่วงการส่งสัญญาณ SIP ของคลัสเตอร์ CXone จาก NICE แต่ละช่วงต้องเป็นช่วง IPv4 สาธารณะ/16หรือแคบกว่า (IPv6/48หรือแคบกว่า)dial_in_numbers: หมายเลขที่ Placecall จะโทร โดยเขียนในรูปแบบที่ CXone ส่ง ไม่จำเป็นต้องเป็นหมายเลขโทรศัพท์จริง และต้องไม่ได้ถูกใช้งานบน ThunderPhone อยู่แล้ว ไม่ว่าจะเป็นหมายเลขโทรศัพท์หรือบนปลายทางอื่น มิฉะนั้นจะได้รับ409
ที่อยู่ของ CXone ใช้ร่วมกันโดยลูกค้าทุกราย ดังนั้นลูกค้า CXone รายอื่นที่โทรไปยังหมายเลขนี้จะเข้าถึงเอเจนต์ของคุณได้ เมื่อเลือกหมายเลข ให้เลือกหมายเลขยาวที่ไม่มีใครเดาได้ (สูงสุด 15 หลัก) ตรวจสอบให้แน่ใจว่า CXone ส่งหมายเลขนั้นไปยัง ThunderPhone แทนที่จะส่งออกไปยังเครือข่ายโทรศัพท์ และอย่าเผยแพร่หมายเลขนั้น
2. ส่งสายพร้อมบริบท
ในสคริปต์ Studio ของคุณ ก่อน Placecall:
- เพิ่มการดำเนินการ Sipputheader พร้อมส่วนหัว
X-Call-IDและค่าContactIDCXone จะไม่ส่งส่วนหัวรหัสการโทรของตัวเอง ThunderPhone จะจัดเก็บค่านี้เป็นexternal_call_idของสาย - เพิ่มการดำเนินการ Sipputheader สำหรับค่าอื่นแต่ละค่าที่เอเจนต์ควรทราบ เช่น ตั้งค่า
X-Skillเป็นsupportค่านี้จะเข้าสู่พรอมต์เป็น{{sip_x_skill}}Sipputheader รองรับUser-to-Userส่วนหัวX-ใดก็ได้ และส่วนหัวP-ส่วนใหญ่ โดย NICE แนะนำให้ใช้ค่าที่มีความยาวไม่เกิน 256 อักขระ
จากนั้นใช้ Placecall โทรไปยังหมายเลขนั้น ผ่านกลุ่ม trunk ที่ส่งสายไปยัง sip.thunderphone.com พร้อมหมายเลขทั้งใน URI คำขอและส่วนหัว To ปลายทางรองรับ TLS (พอร์ต 5061) หรือ TCP (พอร์ต 5060) และปฏิเสธ UDP โดย NICE ไม่มีเอกสารเกี่ยวกับการขนส่งของ trunk ดังนั้นตรวจสอบให้แน่ใจว่าไม่ได้ใช้ UDP
3. รับสายกลับ
CXone อ่านส่วนหัว SIP เฉพาะบน INVITE และการตอบกลับสุดท้ายเท่านั้น ดังนั้นเอเจนต์จึงส่งสายกลับ: กล่าวลาและวางสาย แล้วสคริปต์ของคุณจะรับผู้โทรกลับมา เพิ่มหมายเลขโอนสายนี้ (ดูเพิ่มหมายเลขโอนสาย):
{"name": "NICE CXone", "action": "return"}NICE ไม่มีเอกสารยืนยันว่าสคริปต์จะทำงานต่อหลัง Placecall เมื่อสายที่โทรออกสิ้นสุดลง การผสานรวม CXone ของผู้ให้บริการ AI รายอื่นจะส่งสัญญาณให้สคริปต์ผ่าน Signal API ของ CXone (POST /interactions/{contactId}/signal) ก่อนวางสายแทน แต่ ThunderPhone จะไม่เรียก API นี้ ยืนยันกับ NICE ว่าสคริปต์ของคุณรับผู้โทรกลับอย่างไร จากนั้นดึงข้อมูลการส่งต่อด้วยการดำเนินการ REST API:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=ตามด้วยContactID- ส่วนหัว
Authorization: Bearer sk_live_… - อ่าน
handoff.summaryและhandoff.intentจากการตอบกลับเพื่อกำหนดเส้นทางผู้ติดต่อ
ทดสอบ
โทรไปยังหมายเลขที่เรียกใช้สคริปต์ ขอคุยกับบุคคลผ่านเอเจนต์ และตรวจสอบว่า
สคริปต์ทำงานต่อและแอ็กชัน REST API ส่งคืนการส่งต่อสาย หากสาย
ไม่ไปถึงเอเจนต์ ให้ตรวจสอบหมายเลขที่ CXone ส่งไป ที่อยู่ต้นทางอยู่ใน allowed_source_cidrs
และสายเข้ามาผ่าน TCP หรือ TLS จากนั้นเปิดข้อมูลสายด้วย
GET /v1/calls/{call_id}: sip_headers ควรแสดง x-call-id และ
external_call_id ควรเท่ากับ ContactID
ข้อจำกัด
- CXone ส่งและอ่านส่วนหัวเฉพาะใน
INVITEและ2xxสุดท้ายเท่านั้น ดังนั้น ข้อมูลใด ๆ ในBYEของเอเจนต์จะไปไม่ถึงสคริปต์ - NICE ไม่มีเอกสารระบุว่ารับ
REFERจากเอเจนต์ - แอ็กชัน REST API จะหมดเวลาหลัง 10 วินาทีโดยค่าเริ่มต้น (สูงสุดต้องน้อยกว่า 90 วินาที) และอ่านการตอบกลับได้สูงสุด 32 KB