ThunderPhone v3 พร้อมให้ใช้งานแล้วเริ่มใช้งานได้ด้วยตัวเอง ราคาเริ่มต้น 2 เซนต์ต่อนาที.อ่านประกาศเปิดตัว

Contact centers

เชื่อมต่อจาก 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} แทน