---
title: "Pripojenie z Genesys Cloud"
description: "Odosielajte hovory z Genesys Cloud hlasovému agentovi ThunderPhone cez trunk BYOC Cloud s ID konverzácie a UUI a prevezmite ich späť s odovzdaním v UUI."
---

Váš tok Architect odošle volajúceho hlasovému agentovi cez trunk BYOC Cloud spolu
s ID konverzácie a všetkými nastavenými údajmi UUI. Keď volajúci potrebuje človeka,
agent odošle SIP `REFER`, Genesys prevezme hovor späť a ID odovzdania príde v UUI
hovoru.

## Skôr než začnete

- Agent ThunderPhone a [kľúč API](/sk/guides/api-keys) organizácie.
- Genesys Cloud s BYOC Cloud a externý trunk (typ BYOC Carrier alebo
  PBX) s povolenými týmito nastaveniami
  ([nastavenia externého trunku](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **Hlavičky konverzácie**, aby Genesys odosielal ID konverzácie v
    `x-inin-cnv`. Predvolene je vypnuté.
  - **Prechod UUI**, s typom hlavičky `User-To-User` a kódovaním Hex.
  - **Prevzatie späť a prenos**, aby Genesys prijal agentov `REFER`.

## 1. Vytvorte koncový bod SIP

Genesys odpovedá na výzvu digest, preto použite štandardný koncový bod:

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

Heslo `password` z odpovede si ihneď uložte; zobrazí sa iba raz. Na
trunku:

| Nastavenie | Hodnota |
|---|---|
| Server SIP | `sip.thunderphone.com`, port `5061` |
| Protokol | TLS |
| Digest autentifikácia | `username` a `password` koncového bodu |
| Kodeky | PCMU, PCMA alebo G.722 |

Priraďte trunk k odchádzajúcej trase svojej lokality, ktorej číslovací plán pokrýva
adresu, na ktorú tok vytáča.

## 2. Odosielanie hovorov s kontextom

Vo svojom toku Architect:

1. Voliteľne pridajte akciu **Nastaviť údaje UUI** s kontextom pre agenta,
   napríklad `account=12345`. Genesys odporúča najviac 128 znakov.
2. Pridajte akciu **Preniesť na číslo** s `sip_uri` koncového bodu, napríklad
   `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

Genesys odošle ID konverzácie v `x-inin-cnv`. ThunderPhone ho uloží ako
`external_call_id` hovoru. UUI dorazí do výzvy dekódované ako
`{{sip_uui}}`.

Vlastné hlavičky trunku sú v Genesys statické, preto hodnoty pre jednotlivé hovory
vkladajte do UUI. Genesys si pre seba vyhradzuje predpony hlavičiek `x-inin`,
`x-genesys`, `x-pcv` a `x-gcv`.

## 3. Prevezmite hovor späť

Agent prenesie hovor pomocou `REFER` na adresu v Genesys, pričom ID odovzdania je
ako hexadecimálny UUI v tejto adrese. Pridajte toto číslo na prenos (pozrite si
[Pridanie čísla na prenos](/sk/guides/contact-centers/overview)
a [Hlavičky v adrese na prenos](/sk/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"
}
```

Adresu nahraďte adresou, ktorá smeruje späť do frontu alebo toku, ktorý má
prevziať volajúceho; jej formát potvrďte v Genesys. `REFER` vyzerá takto:

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

Keď je zapnuté **Prevzatie späť a prenos**, Genesys prevezme hovor späť z trunku
a nasmeruje ho na túto adresu. Genesys uvádza, že prichádzajúce UUI sa uloží do
`Call.UUIData`; pre prevzatie späť to však neuvádza, preto si v Genesys alebo
počas testovacieho hovoru potvrďte, že tok prijímajúci volajúceho tam nájde
ID odovzdania. Ak chcete získať súhrn a zámer, zavolajte vyhľadanie odovzdania
pomocou **Akcie údajov hovoru** v integrácii Web Services Data Actions:

- Požiadavka: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  nasledovaná ID z `Call.UUIData`.
- Prihlasovacie údaje: váš kľúč API odoslaný ako `Authorization: Bearer sk_live_…`.
- Výstup: namapujte `handoff.summary` a `handoff.intent` na premenné toku.

Pozrite si [Vyhľadanie odovzdaného hovoru](/api-reference/calls#look-up-a-handed-off-call).

## Otestovanie

Zavolajte na číslo, ktoré vedie do toku, požiadajte agenta o osobu a overte, že
Genesys presmeruje hovor na adresu, ktorú ste nastavili. V danom toku overte, že
`Call.UUIData` obsahuje ID odovzdania ako text (ak zobrazuje hexadecimálne číslice, overte, že kódovanie UUI trunku je Hex). Potom otvorte hovor pomocou `GET /v1/calls/{call_id}`:
`external_call_id` by malo byť ID konverzácie.

## Obmedzenia

- Akcia **Získať hlavičky SIP** číta iba počiatočný `INVITE`, takže nemôže
  čítať nič z `REFER` agenta. Odovzdanie sa do Genesys dostane iba
  prostredníctvom UUI.
- Genesys zahodí všetky UUI, keď hovor obsahuje viac než jednu hlavičku UUI.
- Adresa prenosu je obmedzená na 254 znakov, takže dlhé UUI sa skráti, aby sa zmestilo.
  ID odovzdania sa vždy zmestí.
