Open in
Kết nối từ Genesys Cloud
Gửi cuộc gọi Genesys Cloud đến tác nhân AI ThunderPhone qua trunk BYOC Cloud kèm ID cuộc hội thoại và UUI, rồi chuyển lại với thông tin bàn giao trong UUI.
Luồng Architect của bạn gửi người gọi đến tác nhân AI qua một trung kế BYOC Cloud, cùng với ID cuộc trò chuyện và mọi UUI bạn thiết lập. Khi người gọi cần gặp người thật, tác nhân AI gửi một SIP REFER, Genesys nhận lại cuộc gọi và ID bàn giao đến trong UUI của cuộc gọi.
Trước khi bắt đầu
- Một tác nhân AI ThunderPhone và khóa API của tổ chức.
- Genesys Cloud có BYOC Cloud và một trung kế ngoài (loại BYOC Carrier hoặc
PBX) với các cài đặt này được bật
(cài đặt trung kế ngoài):
- Tiêu đề cuộc trò chuyện, để Genesys gửi ID cuộc trò chuyện trong
x-inin-cnv. Tùy chọn này mặc định tắt. - Chuyển tiếp UUI, với loại tiêu đề
User-To-Uservà mã hóa Hex. - Nhận lại và chuyển cuộc gọi, để Genesys chấp nhận
REFERcủa tác nhân AI.
- Tiêu đề cuộc trò chuyện, để Genesys gửi ID cuộc trò chuyện trong
1. Tạo điểm cuối SIP
Genesys phản hồi thử thách digest, vì vậy hãy dùng một điểm cuối tiêu chuẩ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": "Genesys Cloud"}'Lưu ngay password từ phản hồi; giá trị này chỉ hiển thị một lần. Trên
trung kế:
| Cài đặt | Giá trị |
|---|---|
| Máy chủ SIP | sip.thunderphone.com, cổng 5061 |
| Giao thức | TLS |
| Xác thực digest | username và password của điểm cuối |
| Codec | PCMU, PCMA hoặc G.722 |
Đặt trung kế trên một tuyến gửi đi của site mà kế hoạch đánh số bao phủ địa chỉ mà luồng quay số.
2. Gửi cuộc gọi kèm ngữ cảnh
Trong luồng Architect của bạn:
- Nếu cần, thêm hành động Đặt dữ liệu UUI với ngữ cảnh cho tác nhân AI, ví dụ
account=12345. Genesys khuyến nghị tối đa 128 ký tự. - Thêm hành động Chuyển đến số với
sip_uricủa điểm cuối, ví dụsip:agent-12-jhxmginwjx@sip.thunderphone.com.
Genesys gửi ID cuộc trò chuyện trong x-inin-cnv. ThunderPhone lưu giá trị này
làm external_call_id của cuộc gọi. UUI đến prompt ở dạng đã giải mã, dưới
dạng {{sip_uui}}.
Tiêu đề tùy chỉnh của trung kế là tĩnh trong Genesys, vì vậy hãy đặt các giá trị
theo từng cuộc gọi trong UUI. Genesys dành riêng các tiền tố tiêu đề x-inin,
x-genesys, x-pcv và x-gcv cho chính hệ thống này.
3. Nhận lại cuộc gọi
Tác nhân AI chuyển cuộc gọi bằng REFER đến một địa chỉ trên Genesys, với ID
bàn giao là UUI hex bên trong địa chỉ đó. Thêm số chuyển này (xem
Thêm số chuyển
và Tiêu đề bên trong địa chỉ chuyển):
{
"name": "Genesys support",
"number": "sip:support@acme.byoc.mypurecloud.com",
"headers": {"User-to-User": "{{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}Thay địa chỉ bằng một địa chỉ định tuyến trở lại hàng đợi hoặc luồng sẽ tiếp
nhận người gọi; xác nhận định dạng của địa chỉ với Genesys. REFER có dạng như
sau:
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
Khi bật Nhận lại và chuyển cuộc gọi, Genesys nhận lại cuộc gọi từ trung kế
và định tuyến đến địa chỉ đó. Genesys ghi nhận rằng UUI đến sẽ nằm trong
Call.UUIData; tài liệu không đề cập điều này đối với thao tác nhận lại cuộc
gọi, vì vậy hãy xác nhận với Genesys hoặc trên một cuộc gọi thử rằng luồng tiếp
nhận người gọi tìm thấy ID bàn giao ở đó. Để lấy bản tóm tắt và ý định, hãy gọi
tra cứu bàn giao bằng Hành động dữ liệu cuộc gọi trên một tích hợp Hành động
dữ liệu dịch vụ web:
- Yêu cầu:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=theo sau bởi ID từCall.UUIData. - Thông tin xác thực: khóa API của bạn, gửi dưới dạng
Authorization: Bearer sk_live_…. - Đầu ra: ánh xạ
handoff.summaryvàhandoff.intentvào các biến của luồng.
Xem Tra cứu cuộc gọi đã được bàn giao.
Kiểm tra
Gọi đến một số đi vào flow, yêu cầu tác nhân AI tìm một người, rồi kiểm tra rằng
Genesys chuyển cuộc gọi đến địa chỉ bạn đã đặt. Trong flow đó, kiểm tra rằng
Call.UUIData chứa id bàn giao dưới dạng văn bản (nếu hiển thị các chữ số hex, hãy kiểm tra mã hóa UUI của trunk là Hex). Sau đó mở cuộc gọi bằng GET /v1/calls/{call_id}:
external_call_id phải là id cuộc hội thoại.
Giới hạn
- Hành động Lấy SIP Headers chỉ đọc
INVITEban đầu, nên không thể đọc bất kỳ nội dung nào từREFERcủa tác nhân AI. Việc bàn giao chỉ đến Genesys thông qua UUI. - Genesys loại bỏ toàn bộ UUI khi một cuộc gọi có nhiều hơn một header UUI.
- Địa chỉ chuyển được giới hạn ở 254 ký tự, vì vậy UUI dài sẽ bị cắt để phù hợp. Id bàn giao luôn vừa.