---
title: "Kết nối từ Amazon Connect"
description: "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](/vi/guides/api-keys) 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](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  cộng với mức sử dụng theo phút.

<Warning>
  Hướng dẫn quản trị hiện tại của AWS không còn có trang dành cho chuyển cuộc gọi thoại bên ngoài.
  Trước khi xây dựng dựa trên tính năng này, hãy xác nhận với AWS rằng trình kết nối khả dụng cho
  phiên bản và Khu vực của bạn.
</Warning>

## 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:

```bash
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](/vi/guides/sip-addresses)
để 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](/vi/guides/contact-centers/overview)):

```json
{"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ệ:

```python
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](/api-reference/calls#look-up-a-handed-off-call).

## 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.
