Open in
เชื่อมต่อจาก Genesys Cloud
ส่งสายจาก Genesys Cloud ไปยังเอเจนต์ ThunderPhone ผ่านทรังก์ BYOC Cloud พร้อมรหัสการสนทนาและ UUI และรับสายกลับพร้อมการส่งต่อใน UUI
โฟลว์ Architect ของคุณจะส่งผู้โทรไปยังเอเจนต์ผ่านทรังก์ BYOC Cloud พร้อมรหัสการสนทนาและ UUI ใดๆ ที่คุณตั้งค่าไว้ เมื่อผู้โทรต้องการคุยกับบุคคล เอเจนต์จะส่ง SIP REFER แล้ว Genesys จะรับสายกลับ และรหัสแฮนด์ออฟจะมาถึงใน UUI ของสาย
ก่อนเริ่มต้น
- เอเจนต์ ThunderPhone และคีย์ APIขององค์กร
- Genesys Cloud ที่มี BYOC Cloud และทรังก์ภายนอก (ประเภท BYOC Carrier หรือ PBX) โดยเปิดใช้การตั้งค่าต่อไปนี้
(การตั้งค่าทรังก์ภายนอก):
- ส่วนหัวการสนทนา เพื่อให้ Genesys ส่งรหัสการสนทนาใน
x-inin-cnvซึ่งปิดใช้งานเป็นค่าเริ่มต้น - การส่งต่อ UUI โดยมีประเภทส่วนหัวเป็น
User-To-Userและการเข้ารหัสแบบ Hex - รับสายกลับและโอนสาย เพื่อให้ Genesys ยอมรับ
REFERของเอเจนต์
- ส่วนหัวการสนทนา เพื่อให้ Genesys ส่งรหัสการสนทนาใน
1. สร้างปลายทาง SIP
Genesys ตอบกลับ Digest challenge ดังนั้นให้ใช้ปลายทางมาตรฐาน:
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": "Genesys Cloud"}'จัดเก็บ password จากการตอบกลับทันที โดยจะแสดงเพียงครั้งเดียว บนทรังก์:
| การตั้งค่า | ค่า |
|---|---|
| เซิร์ฟเวอร์ SIP | sip.thunderphone.com, พอร์ต 5061 |
| โพรโทคอล | TLS |
| การยืนยันตัวตน Digest | username และ password ของปลายทาง |
| โคเดก | PCMU, PCMA หรือ G.722 |
กำหนดทรังก์บนเส้นทางขาออกของไซต์ที่มีแผนหมายเลขครอบคลุมที่อยู่ที่โฟลว์โทรออก
2. ส่งสายพร้อมบริบท
ในโฟลว์ Architect ของคุณ:
- หากต้องการ ให้เพิ่มการดำเนินการ ตั้งค่าข้อมูล UUI พร้อมบริบทสำหรับเอเจนต์ เช่น
account=12345Genesys แนะนำให้ใช้ไม่เกิน 128 อักขระ - เพิ่มการดำเนินการ โอนไปยังหมายเลข ด้วย
sip_uriของปลายทาง เช่นsip:agent-12-jhxmginwjx@sip.thunderphone.com
Genesys ส่งรหัสการสนทนาใน x-inin-cnv ThunderPhone จัดเก็บเป็น external_call_id ของสาย UUI จะส่งถึงพรอมป์ต์ในรูปแบบที่ถอดรหัสแล้วเป็น {{sip_uui}}
ส่วนหัวกำหนดเองของทรังก์เป็นค่าแบบคงที่ใน Genesys ดังนั้นให้ใส่ค่าต่อสายใน UUI Genesys สงวนคำนำหน้าส่วนหัว x-inin, x-genesys, x-pcv และ x-gcv ไว้ใช้เอง
3. รับสายกลับ
เอเจนต์โอนสายด้วย REFER ไปยังที่อยู่บน Genesys โดยมีรหัสแฮนด์ออฟเป็น UUI แบบ Hex ภายในที่อยู่นั้น เพิ่มหมายเลขโอนสายนี้ (ดู
เพิ่มหมายเลขโอนสาย
และส่วนหัวภายในที่อยู่สำหรับโอนสาย):
{
"name": "Genesys support",
"number": "sip:support@acme.byoc.mypurecloud.com",
"headers": {"User-to-User": "{{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}แทนที่อยู่ด้วยที่อยู่ที่กำหนดเส้นทางกลับไปยังคิวหรือโฟลว์ที่ควรรับผู้โทร และยืนยันรูปแบบกับ Genesys REFER มีลักษณะดังนี้:
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
เมื่อเปิด รับสายกลับและโอนสาย Genesys จะรับสายกลับจากทรังก์และกำหนดเส้นทางไปยังที่อยู่นั้น Genesys ระบุว่า UUI ขาเข้าจะอยู่ใน Call.UUIData แต่ไม่ได้ระบุเรื่องนี้สำหรับการรับสายกลับ ดังนั้นให้ยืนยันกับ Genesys หรือทดสอบการโทร เพื่อให้แน่ใจว่าโฟลว์ที่รับผู้โทรพบรหัสแฮนด์ออฟที่นั่น หากต้องการรับข้อมูลสรุปและเจตนา ให้เรียกการค้นหาแฮนด์ออฟด้วย การดำเนินการข้อมูลการโทร บนการผสานรวม Web Services Data Actions:
- คำขอ:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=ตามด้วยรหัสจากCall.UUIData - ข้อมูลรับรอง: คีย์ API ของคุณ ซึ่งส่งเป็น
Authorization: Bearer sk_live_… - เอาต์พุต: แมป
handoff.summaryและhandoff.intentไปยังตัวแปรของโฟลว์
ทดสอบ
โทรไปยังหมายเลขที่เข้าถึงโฟลว์ ขอให้เอเจนต์โอนสายไปยังบุคคลหนึ่ง และตรวจสอบว่า
Genesys นำสายไปยังที่อยู่ที่คุณตั้งค่าไว้ ในโฟลว์นั้น ให้ตรวจสอบว่า
Call.UUIData เก็บรหัสการส่งต่อเป็นข้อความ (หากแสดงเลขฐานสิบหก ให้ตรวจสอบว่า
การเข้ารหัส UUI ของทรังก์เป็น Hex) จากนั้นเปิดการเรียกด้วย GET /v1/calls/{call_id}:
external_call_id ควรเป็นรหัสการสนทนา
ข้อจำกัด
- การดำเนินการ รับส่วนหัว SIP อ่านได้เฉพาะ
INVITEเริ่มต้น จึงไม่สามารถ อ่านข้อมูลใดๆ จากREFERของเอเจนต์ได้ การส่งต่อจะไปถึง Genesys ผ่าน UUI เท่านั้น - Genesys จะละทิ้ง UUI ทั้งหมดเมื่อการเรียกมีส่วนหัว UUI มากกว่าหนึ่งรายการ
- ที่อยู่สำหรับโอนสายจำกัดไว้ที่ 254 อักขระ ดังนั้น UUI ที่ยาวจะถูกตัดให้พอดี รหัสการส่งต่อจะพอดีเสมอ