Open in
เชื่อมต่อจาก Five9
ส่งสาย Five9 ไปยังเอเจนต์ ThunderPhone ผ่าน SIP ด้วย AI Agent Connect และรับสายกลับพร้อมส่วนหัวการกำหนดเส้นทางที่สคริปต์ IVR ของคุณอ่านได้
สคริปต์ IVR ของ Five9 จะส่งผู้โทรไปยังเอเจนต์พร้อมรายละเอียดการโทรของ Five9 เมื่อเอเจนต์ดำเนินการเสร็จแล้ว ระบบจะวางสายโดยส่งส่วนหัวการกำหนดเส้นทางบน SIP BYE ซึ่งสคริปต์จะอ่านเข้าสู่ตัวแปรการโทรเพื่อกำหนดเส้นทางผู้โทร
ก่อนเริ่มต้น
- เอเจนต์ ThunderPhone และคีย์ APIขององค์กร
- ส่วนเสริม AI Agent Connect ของ Five9 Five9 จำกัดการใช้งานไว้สำหรับผู้ให้บริการ AI ที่ได้รับการรับรอง และทีมติดตั้งใช้งานของ Five9 จะเป็นผู้ตั้งค่า โดยนำเข้าเทมเพลตสคริปต์ IVR ของผู้ให้บริการ สร้างตัวแปรการโทร และชี้โมดูล การโอนสายไปยังบุคคลที่สาม ของสคริปต์ไปยังผู้ให้บริการ ThunderPhone ยังไม่อยู่ในรายชื่อผู้ให้บริการที่ Five9 รับรอง โปรดสอบถามทีมดูแลบัญชี Five9 หรือฝ่ายสนับสนุน ThunderPhone ก่อนวางแผนโดยอิงกับการใช้งานนี้
1. สร้างปลายทาง SIP
โมดูลการโอนสายไปยังบุคคลที่สามของ Five9 โทรไปยังหมายเลขโทรศัพท์ ไม่ใช่ที่อยู่ SIP และการผสานรวม Five9 ของผู้ให้บริการรายอื่นยืนยันตัวตน Five9 ด้วยที่อยู่ต้นทางแทนรหัสผ่าน ดังนั้นให้สร้างปลายทาง ip_allowlist โดยใช้หมายเลขที่ Five9 จะโทรเป็นหมายเลขโทรเข้า (ดูแพลตฟอร์มที่โทรไปยังหมายเลขโทรศัพท์):
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": "Five9",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
"dial_in_numbers": ["+14155550188"]
}'allowed_source_cidrs: ช่วงการส่งสัญญาณ SIP ของศูนย์ข้อมูล Five9 ของคุณ ซึ่งได้รับจาก Five9 แต่ละรายการต้องเป็นช่วง IPv4 สาธารณะขนาด/16หรือแคบกว่า (IPv6/48หรือแคบกว่า)dial_in_numbers: หมายเลขที่สคริปต์ Five9 จะโทร โดยเขียนในรูปแบบที่ Five9 ส่ง ไม่จำเป็นต้องเป็นหมายเลขโทรศัพท์จริง และต้องยังไม่ได้ใช้งานบน ThunderPhone ไม่ว่าจะเป็นหมายเลขโทรศัพท์หรือบนปลายทางอื่น มิฉะนั้นจะได้รับ409
ที่อยู่ของ Five9 ใช้ร่วมกันโดยลูกค้าทั้งหมด ดังนั้นลูกค้า Five9 รายอื่นที่โทรหมายเลขนี้จะเชื่อมต่อถึงเอเจนต์ของคุณ เมื่อเลือกหมายเลข ให้เลือกหมายเลขยาวที่ไม่มีใครเดาได้ (สูงสุด 15 หลัก) ตรวจสอบให้แน่ใจว่า Five9 ส่งหมายเลขนั้นไปยัง ThunderPhone แทนที่จะส่งออกไปยังเครือข่ายโทรศัพท์ และอย่าเผยแพร่หมายเลขดังกล่าว
2. ส่งสายพร้อมบริบท
ขอให้ทีมติดตั้งใช้งานของ Five9 ดำเนินการดังนี้:
- ส่งสายจากโมดูล การโอนสายไปยังบุคคลที่สาม ไปยัง
sip:+14155550188@sip.thunderphone.comโดยระบุหมายเลขทั้งใน URI คำขอและส่วนหัวToโมดูลจะรับหมายเลข โดยมีโดเมน SIP ของผู้ให้บริการอยู่ในส่วนหัว - ส่งผ่าน TLS (พอร์ต 5061) หรือ TCP (พอร์ต 5060) ปลายทางจะปฏิเสธ UDP และ Five9 ไม่ได้เผยแพร่ว่าใช้การขนส่งแบบใด ดังนั้นตรวจสอบให้แน่ใจว่าไม่ได้ใช้ UDP
- เปิด กลับมาหลังการโทรไปยังบุคคลที่สาม เพื่อให้สคริปต์ทำงานต่อเมื่อเอเจนต์วางสาย (Five9 อนุญาตให้การโทรไปยังบุคคลที่สามนานสูงสุด 3,600 วินาที)
คู่มือของ Five9 ระบุค่าที่ส่ง (call.ANI, call.DNIS, call.call_id, call.session_id, call.campaign_name และอื่นๆ) แต่ไม่ได้ระบุชื่อส่วนหัว การผสานรวม Five9 ของผู้ให้บริการ AI รายอื่นบันทึกค่าเหล่านี้บนเครือข่ายเป็น X-CallANI, X-CallDNIS, X-CallID, X-CallSessionID, X-CallCampaign
และ X-AgentID; ตรวจสอบค่าเหล่านี้ในการโทรทดสอบครั้งแรกของคุณ แต่ละค่าจะเข้าถึงพรอมต์ในรูปแบบตัวแปร เช่น
{{sip_x_callcampaign}} โดย X-CallID จะถูกจัดเก็บเป็น
external_call_id ของการโทร
3. รับสายกลับ
เอเจนต์ส่งสายกลับ โดยกล่าวลาและวางสาย และ BYE มีเฮดเดอร์ 4 รายการที่สคริปต์ของ Five9 อ่าน เพิ่มหมายเลขโอนสายนี้ (ดู เพิ่มหมายเลขโอนสาย):
{
"name": "Five9 agent",
"action": "return",
"headers": {
"X-RouteType": "SkillTransfer",
"X-RouteValue": "Support",
"X-RouteReason": "{{handoff_intent}}",
"X-CustomMetaData": "handoff_id={{handoff_id}}"
}
}X-RouteTypeและX-RouteValueบอกสคริปต์ว่าต้องส่งผู้โทรไปที่ใด ซึ่งในที่นี้คือทักษะ Support ค่าที่ผู้ให้บริการรายอื่นระบุไว้สำหรับX-RouteTypeได้แก่SkillTransfer,PhoneTransfer,HangupและDispositionOnlyตกลงค่าเหล่านี้กับผู้ที่ดูแลสคริปต์ สำหรับปลายทางหลายแห่ง ให้เพิ่มการส่งกลับหนึ่งรายการต่อปลายทาง โดยใช้ชื่อและX-RouteValueที่ต่างกันX-RouteReasonมีป้ายกำกับเจตนาของเอเจนต์ เช่นbilling_disputeX-CustomMetaDataมี ID การส่งต่อสายBYEยังมีค่านี้ในรูปแบบX-TP-Handoff-Idซึ่ง Five9 ไม่ได้อ่าน
สคริปต์ของ Five9 แมปเฮดเดอร์ทั้ง 4 รายการไปยังตัวแปรการโทร สำหรับสรุปของเอเจนต์ ให้สคริปต์เรียกการค้นหาการส่งต่อสายด้วยโมดูล IVR Query:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= ตามด้วย
call.call_id โดยใช้ Authorization Profile ที่ส่ง
Authorization: Bearer และคีย์ API ของคุณ ดู
ค้นหาสายที่ส่งต่อแล้ว
ทดสอบ
โทรเข้าสคริปต์ IVR ขอให้เอเจนต์โอนสายไปยังบุคคลหนึ่ง และตรวจสอบว่าสคริปต์กำหนดเส้นทางผู้โทรพร้อมตัวแปรการโทรที่กรอกครบถ้วน หากสายไปไม่ถึงเอเจนต์ ให้ตรวจสอบว่าหมายเลขใน request URI และเฮดเดอร์ To ตรงกับหมายเลขโทรเข้า ว่าที่อยู่ต้นทางของ Five9 อยู่ใน allowed_source_cidrs และว่าสายเข้ามาผ่าน TCP หรือ TLS จากนั้นเปิดข้อมูลสายด้วย
GET /v1/calls/{call_id}: sip_headers ควรแสดง x-callid และ
external_call_id ควรตรงกับ call.call_id ใน Five9
ข้อจำกัด
- คู่มือของ Five9 ระบุข้อมูลการกำหนดเส้นทางใน
BYEและไม่ได้กล่าวถึงการรับREFERดังนั้นการส่งกลับจึงเป็นการโอนสายแบบ cold transfer โดยสคริปต์ - Five9 อ่าน
X-RouteType,X-RouteValue,X-RouteReasonและX-CustomMetaDataไม่ใช่User-to-UserThunderPhone ส่งค่าเฮดเดอร์แต่ละรายการได้ยาวสูงสุด 256 ไบต์ - Five9 แนะนำให้มีเฮดเดอร์แบบกำหนดเองประมาณ 10 รายการเพื่อหลีกเลี่ยงการแตกส่วนของแพ็กเก็ต