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

Contact centers

เชื่อมต่อจาก 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. ส่งสายพร้อมบริบท

  1. ในคอนโซล Amazon Connect ให้เปิด ระบบเสียงภายนอก → การผสานรวมการโอนสายเสียง แล้วเลือก สร้าง
  2. เลือกประเภทปลายทาง (SBC) และเพิ่มเส้นทางขาออกโดยมีโฮสต์ sip.thunderphone.com พอร์ต 5061 และโปรโตคอล TLS ปลายทางต้องใช้ TLS หรือ TCP (พอร์ต 5060) และปฏิเสธ UDP AWS ไม่มีเอกสารระบุว่า ตัวเชื่อมต่อรองรับโปรโตคอลใดบ้าง ดังนั้นให้ยืนยันกับ AWS ว่าสามารถใช้หนึ่งใน โปรโตคอลเหล่านั้นได้
  3. ในโฟลว์ของคุณ ให้เพิ่มบล็อก โอนไปยังหมายเลขโทรศัพท์ โดยตั้งค่า โอนไปยัง เป็น ระบบเสียงภายนอก แล้วกำหนด:
    • 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 วินาที