Open in
เชื่อมต่อจาก Amazon Connect
ส่งสายจาก Amazon Connect ไปยังเอเจนต์ ThunderPhone ผ่าน SIP พร้อมรหัสผู้ติดต่อและ UUI แล้วดำเนินโฟลว์ต่อด้วยการส่งต่อของเอเจนต์
โฟลว์ Amazon Connect ของคุณจะส่งผู้โทรไปยังเอเจนต์พร้อมรหัสติดต่อและ UUI ที่คุณกำหนดไว้ เมื่อเอเจนต์ดำเนินการเสร็จ จะวางสาย โฟลว์ของคุณจะทำงานต่อ และ Lambda จะดึงข้อมูลการส่งต่อด้วยรหัสติดต่อ
ก่อนเริ่มต้น
- เอเจนต์ ThunderPhone และคีย์ APIขององค์กร
- ตัวเชื่อมต่อ การโอนสายเสียงภายนอก ของ Amazon Connect ขอเพิ่มโควตา "ตัวเชื่อมต่อการโอนสายเสียงภายนอกต่อบัญชี" ก่อน เมนูจะยังซ่อนอยู่จนกว่า AWS จะอนุมัติ AWS เรียกเก็บค่าบริการตัวเชื่อมต่อแต่ละรายการรายวัน ($100 ต่อวันตั้งแต่วันที่ 21 กรกฎาคม 2025) พร้อมค่าการใช้งานต่อนาที
1. สร้างปลายทาง SIP
ตัวเชื่อมต่อไม่มีเอกสารเกี่ยวกับการยืนยันตัวตน SIP digest ดังนั้นให้สร้าง ปลายทางที่รับสายตามที่อยู่ต้นทาง:
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": "Amazon Connect",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["CONNECT_SIGNALLING_RANGE_1", "CONNECT_SIGNALLING_RANGE_2"]
}'รับช่วงสัญญาณ SIP ของตัวเชื่อมต่อสำหรับรีเจียนของคุณจาก AWS แต่ละช่วงต้องเป็น
ช่วง IPv4 สาธารณะขนาด /16 หรือแคบกว่า (IPv6 ขนาด /48 หรือแคบกว่า) ดู
แพลตฟอร์มที่ยืนยันตัวตนด้วย IP ต้นทาง
สำหรับกฎและความเสี่ยงของที่อยู่ที่ใช้ร่วมกันโดยลูกค้าทุกรายของ
แพลตฟอร์ม เก็บค่า sip_uri จากการตอบกลับไว้ เช่น
sip:agent-12-jhxmginwjx@sip.thunderphone.com
2. ส่งสายพร้อมบริบท
- ในคอนโซล Amazon Connect ให้เปิด ระบบเสียงภายนอก → การผสานรวมการโอนสายเสียง แล้วเลือก สร้าง
- เลือกประเภทปลายทาง (SBC) และเพิ่มเส้นทางขาออกโดยมีโฮสต์
sip.thunderphone.comพอร์ต5061และโปรโตคอล TLS ปลายทางต้องใช้ TLS หรือ TCP (พอร์ต5060) และปฏิเสธ UDP AWS ไม่มีเอกสารระบุว่า ตัวเชื่อมต่อรองรับโปรโตคอลใดบ้าง ดังนั้นให้ยืนยันกับ AWS ว่าสามารถใช้หนึ่งใน โปรโตคอลเหล่านั้นได้ - ในโฟลว์ของคุณ ให้เพิ่มบล็อก โอนไปยังหมายเลขโทรศัพท์ โดยตั้งค่า โอนไปยัง
เป็น ระบบเสียงภายนอก แล้วกำหนด:
- ARN ปลายทาง: ตัวเชื่อมต่อ
- ถึงผู้ใช้: ส่วนผู้ใช้ของ
sip_uriของปลายทาง เช่นagent-12-jhxmginwjx - UUI (ไม่บังคับ): บริบทสำหรับเอเจนต์ Connect จะส่งในรูปแบบเข้ารหัส hex
- ดำเนินโฟลว์ต่อหลังตัดการเชื่อมต่อ: ใช่ เพื่อให้โฟลว์ทำงานต่อเมื่อ เอเจนต์วางสาย
Connect ส่งรหัสติดต่อใน X-Amzn-ConnectContactId ThunderPhone จัดเก็บ
เป็น external_call_id ของสาย ซึ่งเป็นวิธีที่โฟลว์ของคุณใช้ค้นหาสายในภายหลัง
UUI จะส่งถึงพรอมต์เป็น {{sip_uui}} การผสานรวมของบุคคลที่สามมีเอกสารเกี่ยวกับ
ส่วนหัวรหัสติดต่อ แต่เอกสารของ AWS เองไม่มี ดังนั้นให้ตรวจสอบในการทดสอบสายครั้งแรกของคุณ
3. รับสายกลับ
AWS ไม่มีเอกสารระบุวิธีให้ Connect อ่านส่วนหัวใน BYE หรือรับ
REFER จากเอเจนต์ ดังนั้นเอเจนต์จึงคืนสาย: กล่าวลาและวางสาย แล้วโฟลว์ของคุณจะทำงานต่อหลังบล็อกการโอนสาย เพิ่มหมายเลขโอนสายนี้ (ดู เพิ่มหมายเลขโอนสาย):
{"name": "Amazon Connect", "action": "return"}จากนั้นดึงข้อมูลการส่งต่อด้วยบล็อก เรียกใช้ฟังก์ชัน AWS Lambda หลังการโอนสาย Lambda จะค้นหาสายด้วยรหัสผู้ติดต่อ:
import json
import os
import urllib.error
import urllib.parse
import urllib.request
def lambda_handler(event, context):
contact_id = event["Details"]["ContactData"]["ContactId"]
url = "https://api.thunderphone.com/v1/calls/handoff?" + urllib.parse.urlencode(
{"external_call_id": contact_id}
)
request = urllib.request.Request(
url, headers={"Authorization": "Bearer " + os.environ["THUNDERPHONE_API_KEY"]}
)
try:
with urllib.request.urlopen(request, timeout=5) as response:
call = json.load(response)
except (urllib.error.URLError, TimeoutError):
return {"found": "false"}
handoff = call.get("handoff") or {}
return {
"found": "true",
"intent": handoff.get("intent") or "",
"summary": handoff.get("summary") or "",
}บล็อกจะส่งคืนแมปแบบแบน ดังนั้นโฟลว์จึงสามารถแยกเส้นทางตาม intent หรือตั้งค่า
summary เป็นแอททริบิวต์ผู้ติดต่อสำหรับผู้ที่รับสายได้ เรียกใช้บล็อกแบบซิงโครนัส
(ไม่เกิน 8 วินาที) และจัดเก็บคีย์ API แบบเข้ารหัส เช่น ใน AWS Secrets Manager ฟิลด์การตอบกลับอยู่ใน
ค้นหาสายที่ส่งต่อ
ทดสอบ
โทรไปยังหมายเลขในอินสแตนซ์ Connect ของคุณที่ไปถึงบล็อกการโอนสาย ขอให้
เอเจนต์โอนหาบุคคลหนึ่ง และตรวจสอบว่าโฟลว์ทำงานต่อ จากนั้นเปิดสายด้วย
GET /v1/calls/{call_id}: sip_headers ควรแสดง
x-amzn-connectcontactid และ external_call_id ควรเท่ากับ ContactId
ที่ Lambda ของคุณได้รับ หากการโอนสายล้มเหลวด้วย SIP 404 แสดงว่า ThunderPhone ไม่พบ
ส่วน user ของปลายทาง: ต้องมีอยู่ทั้งใน URI คำขอและส่วนหัว To
ข้อจำกัด
- AWS ไม่มีเอกสารระบุวิธีอ่านส่วนหัวใน
BYEรวมถึงX-TP-Handoff-Idดังนั้นรหัสผู้ติดต่อจึงเป็นลิงก์เดียวกลับไปยังสาย - AWS ไม่มีเอกสารระบุความยาว UUI สูงสุดสำหรับคอนเน็กเตอร์
- บล็อก Lambda แบบซิงโครนัสจะหมดเวลาหลัง 8 วินาที