Open in
Kết nối từ Talkdesk
Gửi cuộc gọi Talkdesk đến một tác nhân AI ThunderPhone bằng Connect to Autopilot Voice, rồi chuyển tiếp lại bằng mã hand-off trong UUI.
Luồng Talkdesk Studio của bạn gửi người gọi đến tác nhân AI cùng với mã tương tác
và UUI. Khi người gọi cần gặp người thật, tác nhân AI chuyển cuộc gọi bằng SIP
REFER đến Talkdesk, và mã chuyển giao được lưu vào một biến Studio.
Trước khi bắt đầu
- Một tác nhân AI ThunderPhone và một API key của tổ chức.
- Giấy phép Talkdesk Điều phối cuộc trò chuyện, bao gồm thành phần Studio Kết nối với Giọng nói Autopilot ở chế độ Luồng thoại bên ngoài (bài viết của Talkdesk). Talkdesk tính phí theo phút trong khi tác nhân AI giữ cuộc gọi.
1. Tạo điểm cuối SIP
Talkdesk chỉ cung cấp tài liệu về danh sách cho phép IP, vì vậy hãy tạo một điểm cuối chấp nhận cuộc gọi theo địa chỉ nguồn:
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": "Talkdesk",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
"srtp": "optional"
}'Bài viết của Talkdesk cho biết Talkdesk gửi âm thanh qua SRTP, và "srtp": "optional"
phản hồi bằng SRTP khi Talkdesk đề xuất. Bài viết không cho biết liệu Talkdesk
có yêu cầu SRTP hay không; nếu Talkdesk cho bạn biết có yêu cầu, hãy đặt srtp thành required, giá trị này
từ chối cuộc gọi không có SRTP.
Lấy các dải báo hiệu SIP của Talkdesk từ Talkdesk. 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). Xem
Các nền tảng xác thực bằng IP nguồn.
Talkdesk gửi SIP từ mạng của Twilio, nơi mọi khách hàng Twilio đều dùng chung
địa chỉ, vì vậy địa chỉ của điểm cuối là thứ ngăn các người gọi khác truy cập: không
công khai địa chỉ đó.
Giữ lại sip_uri trong phản hồi, ví dụ
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. Gửi cuộc gọi kèm ngữ cảnh
Trong luồng Studio của bạn, hãy thêm Kết nối với Giọng nói Autopilot ở chế độ Luồng thoại bên ngoài
và đặt mục tiêu thành sip_uri của điểm cuối với ;transport=tls được thêm vào, ví dụ
sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. Điểm cuối
từ chối cuộc gọi qua UDP, giao thức mà SIP của Twilio sử dụng nếu không được chỉ định khác.
Talkdesk gửi:
X-Talkdesk-Interaction-Id, được lưu dưới dạngexternal_call_idcủa cuộc gọi;User-to-User, được mã hóa hex, chẳng hạnbusiness_hours=open. Giá trị này đến prompt ở dạng đã giải mã, dưới dạng{{sip_uui}}.
Phiên bản 2.1 của thành phần cũng có thể gửi Tiêu đề được xác định. Trang tùy chọn của Talkdesk mô tả chúng là JSON được gửi qua WebSocket, vì vậy hãy xác nhận với Talkdesk liệu chúng có đến dưới dạng tiêu đề SIP hay không trước khi dựa vào chúng.
3. Nhận lại cuộc gọi
Tác nhân AI chuyển cuộc gọi bằng REFER đến địa chỉ chuyển cấp của Talkdesk, với
id chuyển giao dưới dạng UUI hệ thập lục phân trong địa chỉ đó — nơi duy nhất Talkdesk đọc giá trị này.
Thêm số chuyển tiếp này (xem
Thêm số chuyển tiếp
và Header trong địa chỉ chuyển tiếp):
{
"name": "Talkdesk escalation",
"number": "sip:escalation@talkdesk.com",
"headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}Địa chỉ này là địa chỉ trong bài viết của Talkdesk. Phiên bản 2.1 của thành phần
đọc autopilot_result=; phiên bản 1.7 đọc escalate_to=, vì vậy hãy dùng khóa đó trên
1.7. REFER có dạng như sau:
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
Talkdesk đặt giá trị này vào một biến Studio. Để lấy bản tóm tắt và ý định, thêm bước Thực thi hành động vào một tích hợp tùy chỉnh được xây dựng bằng Connections:
- Loại xác thực Khóa API, tên header
Authorization, giá trịBearer sk_live_…. - Yêu cầu:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=theo sau bởi id từ biến. Bạn cũng có thể tra cứu cuộc gọi theoexternal_call_idbằng id tương tác. - Định tuyến theo
handoff.intent, và hiển thịhandoff.summarycho người tiếp nhận cuộc gọi.
Xem Tra cứu cuộc gọi đã chuyển giao.
Kiểm tra
Bắt đầu một cuộc gọi qua luồng Studio, yêu cầu tác nhân AI chuyển bạn đến một người, rồi kiểm tra
luồng tiếp tục qua thành phần với id chuyển giao trong biến của thành phần đó. Sau đó mở cuộc gọi bằng GET /v1/calls/{call_id}:
external_call_id phải là id tương tác Talkdesk.
Giới hạn
- Talkdesk chỉ đọc tối đa 256 byte UUI và không cho phép các giá trị được phân tách bằng
|hoặc;, vì vậy hãy gửi một giá trị duy nhất. Id chuyển giao có kích thước phù hợp. - API của Talkdesk không thể đọc bản chép lời của tác nhân AI. Thay vào đó, hãy dùng tra cứu chuyển giao hoặc
GET /v1/calls/{call_id}.