---
title: "Kết nối từ Five9"
description: "Gửi cuộc gọi Five9 đến một tác nhân AI ThunderPhone qua SIP bằng AI Agent Connect, rồi nhận lại với các tiêu đề định tuyến mà tập lệnh IVR của bạn đọc."
---

Tập lệnh IVR Five9 của bạn chuyển người gọi đến tác nhân AI cùng với thông tin
cuộc gọi của Five9. Khi tác nhân AI hoàn tất, nó ngắt cuộc gọi với các header định tuyến trên SIP
`BYE`, rồi tập lệnh đọc các header này vào biến cuộc gọi để định tuyến người gọi.

## Trước khi bắt đầu

- Một tác nhân AI ThunderPhone và [API key](/vi/guides/api-keys) của tổ chức.
- Tiện ích bổ sung **Kết nối tác nhân AI** của Five9. Five9 giới hạn tiện ích này cho các nhà cung cấp AI đã được họ
  chứng nhận, và đội ngũ triển khai của Five9 sẽ thiết lập: họ nhập mẫu tập lệnh IVR của
  nhà cung cấp, tạo các biến cuộc gọi và trỏ mô-đun **Chuyển tiếp bên thứ ba** của
  tập lệnh đến nhà cung cấp. ThunderPhone chưa có trong danh sách được Five9 chứng nhận: hãy hỏi đội ngũ quản lý tài khoản Five9 hoặc bộ phận hỗ trợ ThunderPhone trước khi lập kế hoạch dựa trên tiện ích này.

## 1. Tạo endpoint SIP

Mô-đun Chuyển tiếp bên thứ ba của Five9 gọi một số điện thoại, không phải địa chỉ SIP,
và các tích hợp Five9 của nhà cung cấp khác xác thực Five9 bằng địa chỉ nguồn
thay vì mật khẩu. Vì vậy, hãy tạo endpoint `ip_allowlist` với số mà
Five9 sẽ gọi làm số quay vào (xem
[Các nền tảng gọi số điện thoại](/vi/guides/sip-addresses)):

```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": "Five9",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["FIVE9_SIGNALLING_RANGE_1", "FIVE9_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
```

- `allowed_source_cidrs`: các dải báo hiệu SIP của trung tâm dữ liệu Five9
  của bạn, do Five9 cung cấp. 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).
- `dial_in_numbers`: số mà tập lệnh Five9 sẽ gọi, được viết theo cách
  Five9 gửi số đó. Số này không cần là số điện thoại thực. Số này không được đang
  được sử dụng trên ThunderPhone, dưới dạng số điện thoại hoặc trên endpoint khác: khi đó sẽ trả về
  `409`.

Địa chỉ của Five9 được dùng chung cho tất cả khách hàng của họ, vì vậy bất kỳ khách hàng Five9
nào khác gọi số này đều sẽ đến tác nhân AI của bạn. Khi chọn
số, hãy chọn số dài mà không ai đoán được (tối đa 15 chữ số), đảm bảo
Five9 gửi số đó đến ThunderPhone thay vì ra mạng điện thoại, và
không công bố số đó.

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

Yêu cầu đội ngũ triển khai Five9:

- Gửi cuộc gọi từ mô-đun **Chuyển tiếp bên thứ ba** đến
  `sip:+14155550188@sip.thunderphone.com`, với số xuất hiện trong cả request
  URI và header `To`. Mô-đun lấy số này, với miền SIP của nhà cung cấp trong một header.
- Gửi qua TLS (cổng 5061) hoặc TCP (cổng 5060). Endpoint từ chối UDP,
  và Five9 không công bố phương thức truyền tải mà họ sử dụng, vì vậy hãy đảm bảo đó không phải
  UDP.
- Bật **Trả về sau cuộc gọi bên thứ ba**, để tập lệnh tiếp tục khi
  tác nhân AI ngắt cuộc gọi (Five9 cho phép tối đa 3.600 giây cho cuộc gọi bên thứ ba).

Hướng dẫn của Five9 liệt kê các giá trị mà họ gửi (`call.ANI`, `call.DNIS`,
`call.call_id`, `call.session_id`, `call.campaign_name` và các giá trị khác), chứ không phải
tên header. Các tích hợp Five9 của những nhà cung cấp AI khác ghi nhận chúng trên luồng SIP
là `X-CallANI`, `X-CallDNIS`, `X-CallID`, `X-CallSessionID`, `X-CallCampaign`
và `X-AgentID`; hãy kiểm tra chúng trong cuộc gọi thử đầu tiên của bạn. Mỗi giá trị đến prompt dưới dạng một biến, chẳng hạn như
`{{sip_x_callcampaign}}`. `X-CallID` được lưu làm
`external_call_id` của cuộc gọi.

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

Tác nhân chuyển cuộc gọi trở lại: tác nhân nói lời chào tạm biệt rồi gác máy, và `BYE` mang
bốn header mà script của Five9 đọc. Thêm số chuyển cuộc gọi này (xem
[Thêm số chuyển cuộc gọi](/vi/guides/contact-centers/overview)):

```json
{
  "name": "Five9 agent",
  "action": "return",
  "headers": {
    "X-RouteType": "SkillTransfer",
    "X-RouteValue": "Support",
    "X-RouteReason": "{{handoff_intent}}",
    "X-CustomMetaData": "handoff_id={{handoff_id}}"
  }
}
```

- `X-RouteType` và `X-RouteValue` cho script biết cần gửi người gọi đến đâu,
  trong trường hợp này là kỹ năng Support. Các giá trị mà nhà cung cấp khác ghi nhận cho `X-RouteType` gồm
  `SkillTransfer`, `PhoneTransfer`, `Hangup` và `DispositionOnly`; hãy thống nhất
  các giá trị với người duy trì script. Với nhiều điểm đến, hãy thêm một
  return cho mỗi điểm đến với tên và `X-RouteValue` khác nhau.
- `X-RouteReason` mang nhãn ý định của tác nhân, chẳng hạn như `billing_dispute`.
- `X-CustomMetaData` mang ID bàn giao. `BYE` cũng mang ID này dưới dạng
  `X-TP-Handoff-Id`, nhưng Five9 không đọc header đó.

Script của Five9 ánh xạ bốn header vào các biến cuộc gọi. Để lấy bản
tóm tắt của tác nhân, hãy để script gọi tra cứu bàn giao bằng mô-đun IVR **Truy vấn**:
`GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=` theo sau bởi
`call.call_id`, với Hồ sơ ủy quyền gửi
`Authorization: Bearer` và API key của bạn. Xem
[Tra cứu cuộc gọi đã được bàn giao](/api-reference/calls#look-up-a-handed-off-call).

## Kiểm tra

Gọi vào script IVR, yêu cầu tác nhân kết nối với một người và kiểm tra rằng script
định tuyến người gọi với các biến cuộc gọi đã được điền. Nếu cuộc gọi không bao giờ đến
tác nhân, hãy kiểm tra rằng số trong URI yêu cầu và header `To` khớp với
số gọi vào, địa chỉ nguồn của Five9 nằm trong `allowed_source_cidrs`, và
cuộc gọi đến qua TCP hoặc TLS. Sau đó, mở cuộc gọi bằng
`GET /v1/calls/{call_id}`: `sip_headers` phải liệt kê `x-callid`, và
`external_call_id` phải khớp với `call.call_id` trong Five9.

## Giới hạn

- Hướng dẫn của Five9 ghi nhận dữ liệu định tuyến trên `BYE` và không đề cập đến
  việc chấp nhận `REFER`, vì vậy việc chuyển trở lại là chuyển cuộc gọi lạnh do script thực hiện.
- Five9 đọc `X-RouteType`, `X-RouteValue`, `X-RouteReason` và
  `X-CustomMetaData`, không đọc `User-to-User`. ThunderPhone gửi mỗi giá trị header
  dài tối đa 256 byte.
- Five9 khuyến nghị giữ số header tùy chỉnh ở khoảng mười để tránh phân mảnh
  gói.
