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ừ NICE CXone

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

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

{"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.

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.