---
title: "Повежите из услуге Genesys Cloud"
description: "Проследите позиве из услуге Genesys Cloud агенту ThunderPhone преко BYOC Cloud магистрале са ИД-ом разговора и UUI-јем, а затим их вратите са преносом у UUI-ју."
---

Ваш Architect ток шаље позиваоца агенту преко BYOC Cloud магистрале, са ID-ом
разговора и свим UUI вредностима које подесите. Када је позиваоцу потребна особа,
агент шаље SIP `REFER`, Genesys преузима позив назад, а ID предаје стиже у UUI
позива.

## Пре почетка

- ThunderPhone агент и организациони [API кључ](/sr/guides/api-keys).
- Genesys Cloud са BYOC Cloud-ом и спољном магистралом (тип BYOC Carrier или
  PBX) са укљученим следећим подешавањима
  ([подешавања спољне магистрале](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **Заглавља разговора**, тако да Genesys шаље свој ID разговора у
    `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 шаље ID разговора у `x-inin-cnv`. ThunderPhone га чува као
`external_call_id` позива. UUI стиже у упит декодиран, као
`{{sip_uui}}`.

Прилагођена заглавља магистрале су статична у Genesys-у, па вредности по позиву
ставите у UUI. Genesys за себе резервише префиксе заглавља `x-inin`,
`x-genesys`, `x-pcv` и `x-gcv`.

## 3. Преузмите позив назад

Агент преноси позив помоћу `REFER` на адресу у Genesys-у, са ID-ом предаје као
hex UUI унутар те адресе. Додајте овај број за пренос (погледајте
[Додајте број за пренос](/sr/guides/contact-centers/overview)
и [Заглавља унутар адресе за пренос](/sr/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-ом, или на пробном позиву, да ток који прима позиваоца тамо проналази
ID предаје. Да бисте добили резиме и намеру, позовите претрагу предаје помоћу
радње **Позовите радњу за податке** у интеграцији Web Services Data Actions:

- Захтев: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  праћен 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 скраћује да би се уклопио.
  ИД предаје увек стаје.
