Open in
เชื่อมต่อจาก Talkdesk
ส่งสาย Talkdesk ไปยังเอเจนต์ ThunderPhone ด้วย Connect to Autopilot Voice และส่งต่อกลับด้วยรหัสการส่งต่อใน UUI
โฟลว์ Talkdesk Studio ของคุณส่งผู้โทรไปยังเอเจนต์พร้อมรหัสการโต้ตอบและ UUI เมื่อผู้โทรต้องการคุยกับบุคคล เอเจนต์จะส่งต่อด้วย SIP REFER ไปยัง Talkdesk และรหัสการส่งต่อจะอยู่ในตัวแปร Studio
ก่อนเริ่มต้น
- เอเจนต์ ThunderPhone และคีย์ APIขององค์กร
- ไลเซนส์ Talkdesk Conversation Orchestrator ซึ่งครอบคลุมคอมโพเนนต์ Studio เชื่อมต่อกับ Autopilot Voice ในโหมด สตรีมเสียงภายนอก (บทความของ Talkdesk) Talkdesk คิดค่าบริการต่อนาทีในระหว่างที่เอเจนต์รับสายไว้
1. สร้างปลายทาง SIP
Talkdesk ระบุเอกสารเฉพาะรายการอนุญาต IP ดังนั้นให้สร้างปลายทางที่รับสายตามที่อยู่ต้นทาง:
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": "Talkdesk",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
"srtp": "optional"
}'บทความของ Talkdesk ระบุว่าส่งเสียงผ่าน SRTP และ "srtp": "optional"
จะตอบรับ SRTP เมื่อ Talkdesk เสนอมา บทความไม่ได้ระบุว่า Talkdesk
ต้องใช้ SRTP หรือไม่ หาก Talkdesk แจ้งว่าต้องใช้ ให้ตั้งค่า srtp เป็น required ซึ่ง
จะปฏิเสธสายที่ไม่มี SRTP
รับช่วงการส่งสัญญาณ SIP ของ Talkdesk จาก Talkdesk แต่ละช่วงต้องเป็นช่วง IPv4 สาธารณะ
ขนาด /16 หรือแคบกว่า (IPv6 /48 หรือแคบกว่า) ดู
แพลตฟอร์มที่ตรวจสอบสิทธิ์ด้วย IP ต้นทาง
Talkdesk ส่ง SIP จากเครือข่ายของ Twilio ซึ่งมีที่อยู่ที่ลูกค้า Twilio ทุกรายใช้ร่วมกัน
ดังนั้นที่อยู่ของปลายทางจึงเป็นสิ่งที่ป้องกันผู้โทรรายอื่น: อย่าเผยแพร่ที่อยู่นี้
เก็บค่า sip_uri จากการตอบกลับไว้ ตัวอย่างเช่น
sip:agent-12-jhxmginwjx@sip.thunderphone.com
2. ส่งสายพร้อมบริบท
ในโฟลว์ Studio ให้เพิ่ม เชื่อมต่อกับ Autopilot Voice ในโหมด สตรีมเสียงภายนอก
และตั้งค่าเป้าหมายเป็น sip_uri ของปลายทางโดยต่อท้ายด้วย ;transport=tls ตัวอย่างเช่น
sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls ปลายทางจะปฏิเสธสายผ่าน UDP
ซึ่งเป็นโปรโตคอลที่ SIP ของ Twilio ใช้หากไม่ได้ระบุเป็นอย่างอื่น
Talkdesk ส่งข้อมูลดังนี้:
X-Talkdesk-Interaction-Idซึ่งจัดเก็บเป็นexternal_call_idของสายUser-to-Userที่เข้ารหัสแบบเลขฐานสิบหก เช่นbusiness_hours=openโดยจะส่งถึง พรอมต์หลังถอดรหัสเป็น{{sip_uui}}
คอมโพเนนต์เวอร์ชัน 2.1 ยังสามารถส่ง ส่วนหัวที่กำหนด ได้ หน้าการตั้งค่าของ Talkdesk อธิบายว่าส่วนหัวเหล่านี้เป็น JSON ที่ส่งผ่าน WebSocket ดังนั้นควรยืนยันกับ Talkdesk ว่าส่วนหัวเหล่านี้มาถึงในรูปแบบส่วนหัว SIP ก่อนนำไปใช้งาน
3. รับสายกลับ
เอเจนต์จะยกระดับด้วย REFER ไปยังที่อยู่สำหรับการยกระดับของ Talkdesk โดยมีรหัส hand-off เป็น UUI แบบเลขฐานสิบหกภายในที่อยู่นั้น ซึ่งเป็นตำแหน่งเดียวที่ Talkdesk อ่านค่า เพิ่มหมายเลขโอนสายนี้ (ดู
เพิ่มหมายเลขโอนสาย
และ ส่วนหัวภายในที่อยู่โอนสาย):
{
"name": "Talkdesk escalation",
"number": "sip:escalation@talkdesk.com",
"headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}ใช้ที่อยู่ตามบทความของ Talkdesk คอมโพเนนต์เวอร์ชัน 2.1
อ่าน autopilot_result= ส่วนเวอร์ชัน 1.7 อ่าน escalate_to= ดังนั้นให้ใช้คีย์ดังกล่าวใน
1.7 REFER มีลักษณะดังนี้:
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
Talkdesk จะใส่ค่าไว้ในตัวแปร Studio หากต้องการรับสรุปและเจตนา ให้เพิ่มขั้นตอน ดำเนินการ ในการผสานรวมแบบกำหนดเองที่สร้างด้วย Connections:
- ประเภทการตรวจสอบสิทธิ์ คีย์ API ชื่อส่วนหัว
Authorizationค่าBearer sk_live_… - คำขอ:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=ตามด้วยรหัสจากตัวแปร คุณยังค้นหาสายได้ด้วยexternal_call_idโดยใช้รหัสการโต้ตอบ - กำหนดเส้นทางตาม
handoff.intentและแสดงhandoff.summaryให้ผู้รับ สาย
ทดสอบ
เริ่มสายผ่านโฟลว์ Studio ขอให้เอเจนต์โอนสายไปยังบุคคล และตรวจสอบว่า
โฟลว์ดำเนินต่อผ่านคอมโพเนนต์พร้อมรหัส hand-off ในตัวแปร จากนั้นเปิดสายด้วย GET /v1/calls/{call_id}:
external_call_id ควรเป็นรหัสการโต้ตอบของ Talkdesk
ข้อจำกัด
- Talkdesk อ่าน UUI ได้สูงสุด 256 ไบต์ และไม่อนุญาตให้ใช้ค่าที่คั่นด้วย
|หรือ;ดังนั้นให้ส่งค่าเดียว รหัส hand-off มีขนาดพอดี - API ของ Talkdesk ไม่สามารถอ่านทรานสคริปต์ของเอเจนต์ได้ ให้ใช้การค้นหา hand-off หรือ
GET /v1/calls/{call_id}แทน