---
title: "Kết nối từ NICE CXone"
description: "Gửi cuộc gọi NICE CXone đến một tác nhân AI ThunderPhone từ Studio script với ContactID trong SIP header, và tra cứu chuyển tiếp của tác nhân khi script tiếp tục."
---

Tập lệnh CXone Studio của bạn đặt cuộc gọi đến tác nhân AI kèm các tiêu đề SIP chứa
mã liên hệ và mọi ngữ cảnh khác. Khi tác nhân AI hoàn tất, tác nhân sẽ ngắt máy và
một thao tác REST API trong tập lệnh sẽ truy xuất thông tin bàn giao.

## 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.
- Một nhóm SIP trunk CXone chấp nhận tiêu đề tùy chỉnh. Đại diện tài khoản NICE của bạn
  phải bật cài đặt này trước khi CXone gửi chúng.

## 1. Tạo điểm cuối SIP

Placecall quay số điện thoại qua một nhóm trunk CXone, không phải địa chỉ SIP.
NICE không cung cấp tài liệu về thông tin xác thực SIP cho tính năng này, và quy trình tích hợp CXone
của một nhà cung cấp AI khác sử dụng TLS cùng danh sách cho phép IP. Vì vậy, hãy tạo một điểm cuối
`ip_allowlist` với số mà tập lệnh sẽ quay làm số gọi vào (xem
[Nền tảng quay 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": "NICE CXone",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["CXONE_SIGNALLING_RANGE_1", "CXONE_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
```

- `allowed_source_cidrs`: các dải báo hiệu SIP của cụm CXone của bạn,
  do NICE 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à Placecall sẽ quay, được viết theo cách
  CXone gửi số đó. Số này không cần là số điện thoại thực. Số này không thể đang
  được sử dụng trên ThunderPhone, với vai trò số điện thoại hoặc trên một điểm cuối khác: điều đó
  trả về `409`.

Địa chỉ của CXone được chia sẻ bởi tất cả khách hàng của họ, vì vậy bất kỳ khách hàng CXone
nào khác quay số này đều sẽ đến tác nhân AI của bạn. Khi chọn số,
hãy chọn một số dài mà không ai có thể đoán được (tối đa 15 chữ số), đảm bảo
CXone 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

Trong tập lệnh Studio của bạn, trước **Placecall**:

1. Thêm thao tác **Sipputheader** với tiêu đề `X-Call-ID` và giá trị
   `ContactID`. CXone không gửi tiêu đề mã cuộc gọi riêng; ThunderPhone lưu
   tiêu đề này làm `external_call_id` của cuộc gọi.
2. Thêm một thao tác **Sipputheader** cho mỗi giá trị khác mà tác nhân AI cần biết,
   chẳng hạn `X-Skill` đặt thành `support`. Giá trị này đến prompt dưới dạng
   `{{sip_x_skill}}`. Sipputheader chấp nhận `User-to-User`, mọi tiêu đề `X-`, và
   hầu hết tiêu đề `P-`; NICE khuyến nghị giá trị có 256 ký tự trở xuống.

Sau đó **Placecall** đến số đó, qua một nhóm trunk gửi số đó đến
`sip.thunderphone.com` với số trong cả URI yêu cầu và tiêu đề `To`.
Điểm cuối chấp nhận TLS (cổng 5061) hoặc TCP (cổng 5060) và từ chối
UDP; NICE không cung cấp tài liệu về phương thức truyền của trunk, vì vậy hãy đảm bảo đó không phải
UDP.

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

CXone chỉ đọc tiêu đề SIP trên `INVITE` và phản hồi cuối cùng của nó, vì vậy
tác nhân AI trả lại cuộc gọi: tác nhân nói lời tạm biệt rồi ngắt máy, và tập lệnh của bạn
nhận lại người gọi. Thêm số chuyển tiếp này (xem
[Thêm số chuyển tiếp](/vi/guides/contact-centers/overview)):

```json
{"name": "NICE CXone", "action": "return"}
```

NICE không cung cấp tài liệu xác nhận rằng tập lệnh tiếp tục sau Placecall khi cuộc gọi được đặt
kết thúc. Thay vào đó, các quy trình tích hợp CXone của nhà cung cấp AI khác báo hiệu cho tập lệnh
thông qua Signal API của CXone (`POST /interactions/{contactId}/signal`) trước khi
ngắt máy; ThunderPhone không gọi API đó. Hãy xác nhận với NICE cách tập lệnh của bạn
nhận lại người gọi, sau đó truy xuất thông tin bàn giao bằng thao tác **REST API**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  theo sau bởi `ContactID`.
- Tiêu đề `Authorization: Bearer sk_live_…`.
- Đọc `handoff.summary` và `handoff.intent` từ phản hồi để định tuyến
  liên hệ.

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 đến số chạy script, yêu cầu tác nhân AI kết nối với một người và kiểm tra rằng
script tiếp tục chạy cũng như hành động REST API trả về việc chuyển giao. Nếu cuộc gọi
không bao giờ đến được tác nhân AI, hãy kiểm tra số mà CXone gửi, địa chỉ nguồn của số đó
có trong `allowed_source_cidrs` hay không và cuộc gọi có đi qua TCP hoặc TLS không. Sau đó mở
cuộc gọi bằng `GET /v1/calls/{call_id}`: `sip_headers` phải liệt kê `x-call-id`, và
`external_call_id` phải bằng `ContactID`.

## Giới hạn

- CXone chỉ gửi và đọc header trên `INVITE` và `2xx` cuối cùng của nó, vì vậy
  không có nội dung nào trên `BYE` của tác nhân AI đến được script.
- NICE không có tài liệu về việc chấp nhận `REFER` từ tác nhân AI.
- Hành động REST API hết thời gian chờ sau 10 giây theo mặc định (tối đa dưới 90 giây)
  và đọc phản hồi tối đa 32 KB.
