Open in
เชื่อมต่อจาก Zoom Contact Center
ส่งสายจาก Zoom Contact Center ไปยังเอเจนต์ ThunderPhone ด้วยตัวเชื่อมต่อ voicebot ของบุคคลที่สาม และโอนกลับไปยังเอเจนต์มนุษย์ด้วย SIP REFER
วิดเจ็ตบอตในโฟลว์ Zoom Contact Center จะส่งผู้โทรไปยังเอเจนต์พร้อม call sid ของ Zoom เมื่อผู้โทรต้องการพูดคุยกับบุคคล เอเจนต์จะส่ง SIP REFER ไปยังที่อยู่เอเจนต์มนุษย์ของ Zoom และโฟลว์ของคุณจะดึงการส่งต่อสายด้วย call sid
ก่อนเริ่มต้น
- เอเจนต์ ThunderPhone และคีย์ APIขององค์กร
- แอปทั่วไปของ Zoom Marketplace ที่ผู้ดูแลระบบของคุณจัดการและเปิดใช้สำหรับ Contact Center พร้อมตัวเชื่อมต่อสำหรับวิดเจ็ตบอต (คู่มือ voicebot ของบุคคลที่สามจาก Zoom)
- SIP trunk จาก Zoom ไปยังผู้ให้บริการบอต ทีม ISV ของ Zoom จะสร้างเป็นขั้นตอน (การสำรวจ trunk สำหรับสภาพแวดล้อมทดสอบ แล้วจึงใช้งานจริง) และชื่อบริษัทของแอปต้องตรงกับระเบียน trunk ทุกประการ การตั้งค่านี้เริ่มต้นร่วมกับฝ่ายสนับสนุน ThunderPhone และ Zoom ไม่ใช่ดำเนินการในบัญชี Zoom ของคุณเพียงลำพัง
1. สร้างปลายทาง SIP
ตัวเชื่อมต่อของ Zoom จะโทรไปยังหมายเลข 15 หลักที่ขึ้นต้นด้วย 999 ไม่ใช่ที่อยู่ SIP การบันทึกตัวเชื่อมต่อจะสร้างหมายเลขดังกล่าว trunk ของ Zoom ใช้ TLS 1.2 บนพอร์ต 5061 พร้อม SRTP สำหรับเสียง และอนุญาตการเชื่อมต่อด้วยรายการอนุญาตของเครือข่ายย่อย Zoom แทนรหัสผ่าน ดังนั้นให้สร้างปลายทาง ip_allowlist โดยใช้หมายเลขของตัวเชื่อมต่อเป็นหมายเลขโทรเข้าและบังคับใช้ SRTP (ดู
แพลตฟอร์มที่โทรไปยังหมายเลขโทรศัพท์):
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": "Zoom Contact Center",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["999123456789012"],
"srtp": "required"
}'allowed_source_cidrs: เครือข่ายย่อยสำหรับสัญญาณ SIP ของ Zoom ซึ่งได้รับจาก Zoom แต่ละรายการต้องเป็นช่วง IPv4 สาธารณะขนาด/16หรือแคบกว่า (IPv6/48หรือแคบกว่า)dial_in_numbers: หมายเลขของตัวเชื่อมต่อที่ตรงตามที่ Zoom ส่งมา โดยไม่มี+srtp:requiredเนื่องจาก trunk ของ Zoom ใช้ SRTP เสมอ
ที่อยู่ของ Zoom ใช้ร่วมกันระหว่างลูกค้าทั้งหมด ดังนั้นลูกค้า Zoom รายอื่นที่โทรไปยังหมายเลขนี้จะติดต่อเอเจนต์ของคุณได้ Zoom เป็นผู้กำหนดหมายเลข อย่าเผยแพร่หมายเลขดังกล่าว
2. ส่งสายพร้อมบริบท
เพิ่มวิดเจ็ตบอตลงในโฟลว์ของคุณและผูกเข้ากับตัวเชื่อมต่อ ขอให้ทีม ISV ของ Zoom กำหนด trunk ไปที่ sip.thunderphone.com โดยใช้ TLS บนพอร์ต 5061 พร้อมหมายเลขของตัวเชื่อมต่อทั้งใน request URI และส่วนหัว To ปลายทางจะปฏิเสธ UDP ดังนั้นตรวจสอบให้แน่ใจว่า trunk จะไม่สำรองกลับไปใช้ UDP
Zoom ส่งข้อมูลดังนี้:
X-ZOOM-Call-Sidจัดเก็บเป็นexternal_call_idของสาย หน้าการแมปข้อมูลของ Zoom เองไม่ได้ระบุข้อมูลนี้ แต่เอกสารการผสานรวม Zoom ของผู้ให้บริการ AI รายอื่นระบุไว้ ดังนั้นให้ตรวจสอบในการทดสอบสายครั้งแรกX-ZOOM-DNISหมายเลขที่ผู้โทรโทรเข้า เป็น{{sip_x_zoom_dnis}}X-ZOOM-WEBHOOKStatic URL ของตัวเชื่อมต่อ
3. รับสายกลับ
เอเจนต์ส่ง REFER ไปยังที่อยู่ของเอเจนต์ที่เป็นมนุษย์บน SBC ของ Zoom เพิ่มหมายเลขโอนสายนี้ (ดู
เพิ่มหมายเลขโอนสาย)
พร้อมที่อยู่ SBC ที่ Zoom ให้คุณ:
{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}คู่มือของ Zoom อธิบาย 2 วิธีที่บอตส่งบริบท: POST ไปยัง Static URL ของ
คอนเน็กเตอร์ก่อน REFER (เหตุการณ์ voicebot_metadata และเหตุการณ์ที่คล้ายกัน)
และส่วนหัว SIP ที่แมปไว้ภายใต้ ขาเข้าจากบอต ThunderPhone จะไม่โพสต์ไปยัง Static URL
คู่มือของ Zoom ไม่ได้ระบุว่าอ่านส่วนหัวที่แมปจาก REFER หรือไม่ หากต้องการลอง ให้เพิ่ม
headers เช่น "X-Handoff-Id": "{{handoff_id}}" ลงในรายการ แล้วตรวจสอบด้วยสายทดสอบ
นอกจากนี้ ให้ยืนยันกับ Zoom ว่ายอมรับ REFER ที่ไม่มี metadata POST ก่อนหน้านั้น
หากต้องการรับข้อมูลการส่งต่อโดยไม่ต้องพึ่งพาวิธีใดวิธีหนึ่ง ให้โฟลว์ของคุณค้นหาหลังวิดเจ็ตบอต ด้วยวิดเจ็ต การเรียก HTTP หรือ สคริปต์:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=ตามด้วย SID ของสาย- ส่วนหัว
Authorization: Bearer sk_live_… - ใช้
handoff.summaryและhandoff.intentเพื่อกำหนดเส้นทางผู้โทรและสรุปข้อมูลให้ผู้รับสาย
Zoom ไม่เผยแพร่เอกสารระดับฟิลด์สำหรับวิดเจ็ตเหล่านี้ ดังนั้นให้ยืนยันในบัญชีของคุณว่าวิดเจ็ตสามารถส่งส่วนหัว
Authorization ได้ ดู
ค้นหาสายที่ส่งต่อแล้ว
ทดสอบ
โทรไปยังหมายเลขที่เข้าถึงวิดเจ็ตบอต ขอคุยกับเอเจนต์ที่เป็นมนุษย์ และตรวจสอบว่าผู้โทรไปถึงเอเจนต์ที่เป็นมนุษย์
และวิดเจ็ตส่งคืนข้อมูลการส่งต่อ จากนั้นเปิดสายด้วย GET /v1/calls/{call_id}: sip_headers
ควรแสดง x-zoom-call-sid และ external_call_id ควรตรงกับ SID ของสายที่โฟลว์ของคุณใช้
ข้อจำกัด
- ThunderPhone จะไม่โพสต์ไปยัง Static URL ของคอนเน็กเตอร์ ดังนั้น Zoom จะได้รับข้อมูลการส่งต่อผ่านการค้นหา
หรือผ่านส่วนหัวที่แมป หากการทดสอบของคุณแสดงว่า Zoom อ่านส่วนหัวเหล่านั้นจาก
REFER - ทรังก์สร้างโดยทีม ISV ของ Zoom ดังนั้นคุณจึงไม่สามารถตั้งค่าหรือทดสอบได้ด้วยตนเอง