---
title: "Подключение из Genesys Cloud"
description: "Направляйте звонки Genesys Cloud агенту ThunderPhone через транк BYOC Cloud с идентификатором разговора и UUI, а затем возвращайте их обратно с передачей в UUI."
---

Ваш сценарий Architect направляет звонящего к агенту через транк BYOC Cloud вместе с идентификатором разговора и любыми заданными данными UUI. Когда звонящему нужен человек, агент отправляет SIP `REFER`, Genesys возвращает вызов, а идентификатор передачи поступает в UUI вызова.

## Перед началом работы

- Агент ThunderPhone и [ключ API](/ru/guides/api-keys) организации.
- Genesys Cloud с BYOC Cloud и внешним транком (типа BYOC Carrier или
  PBX) со следующими включёнными настройками
  ([настройки внешнего транка](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **Заголовки разговора**, чтобы Genesys отправлял идентификатор разговора в
    `x-inin-cnv`. По умолчанию эта настройка выключена.
  - **Передача UUI**, с типом заголовка `User-To-User` и кодировкой Hex.
  - **Возврат и перевод**, чтобы Genesys принимал `REFER` агента.

## 1. Создайте SIP-конечную точку

Genesys отвечает на digest-запрос, поэтому используйте стандартную конечную точку:

```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"}'
```

Сразу сохраните `password` из ответа: он отображается только один раз. На
транке:

| Настройка | Значение |
|---|---|
| SIP-сервер | `sip.thunderphone.com`, порт `5061` |
| Протокол | TLS |
| Digest-аутентификация | `username` и `password` конечной точки |
| Кодеки | PCMU, PCMA или G.722 |

Добавьте транк в исходящий маршрут вашего сайта, план нумерации которого охватывает
адрес, на который выполняет набор сценарий.

## 2. Отправляйте вызовы с контекстом

В сценарии Architect:

1. При необходимости добавьте действие **Задать данные UUI** с контекстом для агента,
   например `account=12345`. Genesys рекомендует использовать не более 128 символов.
2. Добавьте действие **Перевести на номер** с `sip_uri` конечной точки, например
   `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

Genesys отправляет идентификатор разговора в `x-inin-cnv`. ThunderPhone сохраняет его как
`external_call_id` вызова. UUI поступает в промпт в декодированном виде как
`{{sip_uui}}`.

Пользовательские заголовки транка статичны в Genesys, поэтому передавайте значения для
каждого вызова в UUI. Genesys резервирует для себя префиксы заголовков `x-inin`,
`x-genesys`, `x-pcv` и `x-gcv`.

## 3. Верните вызов

Агент выполняет перевод с помощью `REFER` на адрес в Genesys, содержащий идентификатор
передачи в виде шестнадцатеричного UUI. Добавьте этот номер перевода (см.
[Добавление номера перевода](/ru/guides/contact-centers/overview)
и [Заголовки в адресе перевода](/ru/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"
}
```

Замените адрес на тот, который направляет вызов обратно в очередь или сценарий, принимающий
звонящего; уточните его формат в Genesys. `REFER` выглядит так:

```
Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>
```

При включённой настройке **Возврат и перевод** Genesys возвращает вызов с транка
и направляет его на этот адрес. Согласно документации Genesys, входящий UUI поступает в
`Call.UUIData`; для возврата вызова это не задокументировано, поэтому уточните в
Genesys или проверьте тестовым вызовом, что сценарий, принимающий звонящего, находит там
идентификатор передачи. Чтобы получить сводку и намерение, вызовите поиск передачи с помощью
**Действия с данными вызова** в интеграции Web Services Data Actions:

- Запрос: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  с последующим идентификатором из `Call.UUIData`.
- Учётные данные: ваш ключ API, передаваемый как `Authorization: Bearer sk_live_…`.
- Вывод: сопоставьте `handoff.summary` и `handoff.intent` с переменными сценария.

См. [Поиск переданного вызова](/api-reference/calls#look-up-a-handed-off-call).

## Проверьте

Позвоните на номер, ведущий к сценарию, попросите агента соединить с человеком и проверьте, что
Genesys направляет вызов на указанный вами адрес. В этом сценарии проверьте, что
`Call.UUIData` содержит идентификатор передачи как текст (если отображаются шестнадцатеричные цифры, проверьте, что кодировка UUI транка установлена в Hex). Затем откройте вызов с помощью `GET /v1/calls/{call_id}`:
`external_call_id` должен содержать идентификатор разговора.

## Ограничения

- Действие **Получить SIP-заголовки** считывает только исходный `INVITE`, поэтому оно не может
  считывать данные из `REFER` агента. Передача достигает Genesys только через UUI.
- Genesys отбрасывает все UUI, если вызов содержит более одного заголовка UUI.
- Адрес передачи ограничен 254 символами, поэтому длинный UUI обрезается до допустимой длины.
  Идентификатор передачи всегда помещается.
