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ừ 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-User và mã hóa Hex.
    • Nhận lại và chuyển cuộc gọi, để Genesys chấp nhận REFER của tác nhân AI.

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 đặtGiá trị
Máy chủ SIPsip.thunderphone.com, cổng 5061
Giao thứcTLS
Xác thực digestusername và password của điểm cuối
CodecPCMU, 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:

  1. 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ự.
  2. Thêm hành động Chuyển đến số với sip_uri củ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.summary và handoff.intent và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 INVITE ban đầu, nên không thể đọc bất kỳ nội dung nào từ REFER củ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.