---
title: "Свързване от Genesys Cloud"
description: "Изпращайте обаждания от Genesys Cloud към агент на ThunderPhone през BYOC Cloud trunk с идентификатора на разговора и UUI и ги връщайте обратно с прехвърлянето в UUI."
---

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

## Преди да започнете

- Агент на ThunderPhone и организационен [API ключ](/bg/guides/api-keys).
- Genesys Cloud с BYOC Cloud и външен trunk (тип BYOC Carrier или
  PBX) със включени следните настройки
  ([настройки на външен trunk](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` от отговора веднага; той се показва само веднъж. В trunk-а:

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

Добавете trunk-а към изходящ маршрут на вашия сайт, чийто план за номера покрива
адреса, който потокът набира.

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

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

## 3. Приемете обаждането обратно

Агентът прехвърля с `REFER` към адрес в Genesys, като идентификаторът на предаването е в hex UUI данните вътре в този адрес. Добавете този номер за прехвърляне (вижте
[Добавяне на номера за прехвърляне](/bg/guides/contact-centers/overview)
и [Заглавки в адреса за прехвърляне](/bg/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 приема обаждането обратно от trunk-а
и го маршрутизира към този адрес. 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 се съкращава, за да се побере.
  Идентификаторът за прехвърляне винаги се побира.
