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ừ Five9

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

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

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

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.