ThunderPhone v3 đã chính thức ra mắt.Tự đăng ký và sử dụng, chỉ từ 2¢/phút.Xem thông báo ra mắt

Contact centers

Kết nối từ Amazon Connect

Gửi cuộc gọi Amazon Connect đến tác nhân AI ThunderPhone qua SIP cùng với mã liên hệ và UUI, rồi tiếp tục luồng của bạn với thao tác bàn giao của tác nhân AI.

Luồng Amazon Connect của bạn gửi người gọi đến tác nhân AI cùng với ID liên hệ và mọi UUI bạn đặt. Khi tác nhân AI hoàn tất, tác nhân sẽ ngắt máy, luồng của bạn tiếp tục và một Lambda truy xuất lần bàn giao theo ID liên hệ.

Trước khi bắt đầu

  • Một tác nhân ThunderPhone và API key của tổ chức.
  • Trình kết nối Chuyển cuộc gọi thoại bên ngoài của Amazon Connect. Trước tiên, hãy yêu cầu tăng hạn mức "Trình kết nối chuyển cuộc gọi thoại bên ngoài cho mỗi tài khoản": menu sẽ vẫn bị ẩn cho đến khi AWS phê duyệt. AWS tính phí mỗi trình kết nối theo ngày ($100 mỗi ngày kể từ ngày 21 tháng 7 năm 2025) cộng với mức sử dụng theo phút.

1. Tạo endpoint SIP

Trình kết nối không tài liệu hóa xác thực SIP digest, vì vậy hãy tạo một endpoint chấp nhận cuộc gọi theo địa chỉ nguồn:

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"]
  }'

Lấy các dải báo hiệu SIP của trình kết nối cho Khu vực của bạn từ AWS. Mỗi dải phải là dải IPv4 công khai /16 hoặc hẹp hơn (IPv6 /48 hoặc hẹp hơn). Xem Các nền tảng xác thực bằng IP nguồn để biết quy tắc và rủi ro của một địa chỉ được chia sẻ bởi mọi khách hàng của nền tảng. Giữ lại sip_uri trong phản hồi, ví dụ sip:agent-12-jhxmginwjx@sip.thunderphone.com.

2. Gửi cuộc gọi kèm ngữ cảnh

  1. Trong bảng điều khiển Amazon Connect, mở Hệ thống thoại bên ngoài → Tích hợp chuyển cuộc gọi thoại và chọn Tạo.
  2. Chọn loại đích (một SBC) và thêm tuyến gửi đi với máy chủ sip.thunderphone.com, cổng 5061 và giao thức TLS. Endpoint cần TLS hoặc TCP (cổng 5060) và từ chối UDP. AWS không tài liệu hóa những giao thức mà trình kết nối cung cấp, vì vậy hãy xác nhận với AWS rằng nó có thể sử dụng một trong các giao thức đó.
  3. Trong luồng của bạn, thêm khối Chuyển đến số điện thoại với Chuyển đến được đặt thành Hệ thống thoại bên ngoài, rồi đặt:
    • ARN đích: trình kết nối.
    • Đến người dùng: phần người dùng trong sip_uri của endpoint, chẳng hạn như agent-12-jhxmginwjx.
    • UUI (tùy chọn): ngữ cảnh cho tác nhân AI. Connect gửi dữ liệu này dưới dạng mã hóa hex.
    • Tiếp tục luồng sau khi ngắt kết nối: Có, để luồng tiếp tục khi tác nhân AI ngắt máy.

Connect gửi ID liên hệ trong X-Amzn-ConnectContactId. ThunderPhone lưu trữ nó dưới dạng external_call_id của cuộc gọi, đây là cách luồng của bạn tìm cuộc gọi sau đó. UUI đến prompt dưới dạng {{sip_uui}}. Các tích hợp bên thứ ba tài liệu hóa header ID liên hệ; tài liệu riêng của AWS thì không, vì vậy hãy kiểm tra nó trong cuộc gọi thử nghiệm đầu tiên của bạn.

3. Nhận lại cuộc gọi

AWS không ghi nhận cách nào để Connect đọc header trên BYE hoặc chấp nhận REFER từ tác nhân AI. Vì vậy, tác nhân AI trả lại cuộc gọi: nói lời tạm biệt và ngắt máy, sau đó flow của bạn tiếp tục sau khối chuyển tiếp. Thêm số chuyển tiếp này (xem Thêm số chuyển tiếp):

{"name": "Amazon Connect", "action": "return"}

Sau đó, truy xuất dữ liệu chuyển giao bằng khối Gọi hàm AWS Lambda sau khi chuyển tiếp. Lambda tra cứu cuộc gọi theo ID liên hệ:

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 "",
    }

Khối này trả về một map phẳng, vì vậy flow có thể phân nhánh theo intent hoặc đặt summary làm thuộc tính liên hệ cho người nhận cuộc gọi. Chạy khối này đồng bộ (tối đa 8 giây) và lưu API key dưới dạng mã hóa, ví dụ trong AWS Secrets Manager. Các trường phản hồi có trong Tra cứu cuộc gọi đã được chuyển giao.

Kiểm tra

Gọi đến một số trên instance Connect của bạn có đi tới khối chuyển tiếp, yêu cầu tác nhân AI nối máy với một người và kiểm tra xem flow có tiếp tục hay không. Sau đó mở cuộc gọi bằng GET /v1/calls/{call_id}: sip_headers phải liệt kê x-amzn-connectcontactid, và external_call_id phải bằng ContactId mà Lambda của bạn nhận được. Nếu chuyển tiếp thất bại với SIP 404, ThunderPhone không tìm thấy phần người dùng của endpoint: phần này phải có trong cả URI yêu cầu và header To.

Giới hạn

  • AWS không ghi nhận cách nào để đọc header trên BYE, bao gồm X-TP-Handoff-Id, vì vậy ID liên hệ là liên kết duy nhất trở lại cuộc gọi.
  • AWS không ghi nhận độ dài UUI tối đa cho connector.
  • Khối Lambda đồng bộ hết thời gian chờ sau 8 giây.