---
title: "Připojení z Genesys Cloud"
description: "Směrujte hovory z Genesys Cloud k agentovi ThunderPhone přes trunk BYOC Cloud s ID konverzace a UUI a přebírejte je zpět s předáním v UUI."
---

Váš tok Architect odešle volajícího k agentovi přes trunk BYOC Cloud spolu s ID konverzace a veškerými nastavenými údaji UUI. Když volající potřebuje člověka, agent odešle SIP `REFER`, Genesys hovor převezme zpět a ID předání dorazí v UUI hovoru.

## Než začnete

- Agent ThunderPhone a [klíč API](/cs/guides/api-keys) organizace.
- Genesys Cloud s BYOC Cloud a externím trunkem (typ BYOC Carrier nebo
  PBX) s aktivovanými následujícími nastaveními
  ([nastavení externího trunku](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **Hlavičky konverzace**, aby Genesys odesílal ID konverzace v
    `x-inin-cnv`. Ve výchozím nastavení je vypnuté.
  - **Průchod UUI** s typem hlavičky `User-To-User` a kódováním Hex.
  - **Převzetí zpět a přesměrování**, aby Genesys přijímal `REFER` agenta.

## 1. Vytvořte koncový bod SIP

Genesys odpovídá na digest challenge, proto použijte standardní 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 odpovědi si ihned uložte; zobrazí se pouze jednou. Na
trunku nastavte:

| Nastavení | Hodnota |
|---|---|
| Server SIP | `sip.thunderphone.com`, port `5061` |
| Protokol | TLS |
| Digest ověřování | `username` a `password` koncového bodu |
| Kodeky | PCMU, PCMA nebo G.722 |

Přidejte trunk do odchozí trasy své lokality, jejíž číslovací plán pokrývá
adresu, na kterou tok volá.

## 2. Odesílejte hovory s kontextem

V toku Architect:

1. Volitelně přidejte akci **Nastavit data UUI** s kontextem pro agenta,
   například `account=12345`. Genesys doporučuje maximálně 128 znaků.
2. Přidejte akci **Přesměrovat na číslo** s `sip_uri` koncového bodu,
   například `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

Genesys odesílá ID konverzace v `x-inin-cnv`. ThunderPhone jej uloží jako
`external_call_id` hovoru. UUI dorazí do promptu dekódované jako
`{{sip_uui}}`.

Vlastní hlavičky trunku jsou v Genesys statické, proto hodnoty pro jednotlivé
hovory vkládejte do UUI. Genesys si pro sebe vyhrazuje předpony hlaviček
`x-inin`, `x-genesys`, `x-pcv` a `x-gcv`.

## 3. Převezměte hovor zpět

Agent přesměruje hovor pomocí `REFER` na adresu v Genesys, přičemž ID předání
je uvnitř této adresy jako hexadecimální UUI. Přidejte toto číslo pro přesměrování (viz
[Přidání čísla pro přesměrování](/cs/guides/contact-centers/overview)
a [Hlavičky uvnitř adresy pro přesměrování](/cs/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, která směruje zpět do fronty nebo toku, jenž má
volajícího převzít; její formát ověřte u Genesys. `REFER` vypadá takto:

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

Při zapnutém **Převzetí zpět a přesměrování** Genesys převezme hovor zpět z
trunku a nasměruje jej na danou adresu. Genesys uvádí, že příchozí UUI se uloží
do `Call.UUIData`; pro převzetí zpět to však nedokumentuje, proto u Genesys
nebo při testovacím hovoru ověřte, že tok přijímající volajícího zde najde ID
předání. Chcete-li získat souhrn a záměr, zavolejte vyhledání předání pomocí
akce **Datová akce volání** v integraci Web Services Data Actions:

- Požadavek: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  následovaný ID z `Call.UUIData`.
- Přihlašovací údaje: váš klíč API odeslaný jako `Authorization: Bearer sk_live_…`.
- Výstup: namapujte `handoff.summary` a `handoff.intent` na proměnné toku.

Viz [Vyhledání předaného hovoru](/api-reference/calls#look-up-a-handed-off-call).

## Otestujte to

Zavolejte na číslo, které vede do toku, požádejte agenta o osobu a ověřte, že
Genesys přesměruje hovor na nastavenou adresu. V tomto toku ověřte, že
`Call.UUIData` obsahuje ID předání jako text (pokud zobrazuje šestnáctkové číslice, ověřte, že
kódování UUI trunku je nastavené na Hex). Poté otevřete hovor pomocí `GET /v1/calls/{call_id}`:
`external_call_id` by mělo být ID konverzace.

## Omezení

- Akce **Získat hlavičky SIP** čte pouze počáteční `INVITE`, takže nemůže
  číst nic z `REFER` agenta. Předání se do Genesys dostane pouze
  prostřednictvím UUI.
- Genesys zahodí všechna UUI, pokud hovor obsahuje více než jednu hlavičku UUI.
- Adresa přesměrování je omezená na 254 znaků, takže dlouhé UUI se zkrátí, aby se vešlo.
  ID předání se vždy vejde.
