---
title: "Kết nối từ Genesys Cloud"
description: "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](/vi/guides/api-keys) 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](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **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:

```bash
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:

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](/vi/guides/contact-centers/overview)
và [Tiêu đề bên trong địa chỉ chuyển](/vi/guides/call-transfers)):

```json
{
  "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](/api-reference/calls#look-up-a-handed-off-call).

## 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.
