Open in
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/16hoặc hẹp hơn (IPv6/48hoặ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à headerTo. 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-RouteTypevàX-RouteValuecho 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 choX-RouteTypegồmSkillTransfer,PhoneTransfer,Hangupvà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-RouteValuekhác nhau.X-RouteReasonmang nhãn ý định của tác nhân, chẳng hạn nhưbilling_dispute.X-CustomMetaDatamang ID bàn giao.BYEcũng mang ID này dưới dạngX-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
BYEvà không đề cập đến việc chấp nhậnREFER, 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-RouteReasonvàX-CustomMetaData, không đọcUser-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.