---
title: "Povežite iz Genesys Cloud"
description: "Pošljite klice Genesys Cloud glasovnemu agentu ThunderPhone prek trunka BYOC Cloud z ID-jem pogovora in UUI ter jih prevzemite nazaj s predajo v UUI."
---

Vaš tok Architect pošlje klicatelja agentu prek povezave BYOC Cloud, z ID-jem pogovora in vsemi nastavljenimi podatki UUI. Ko klicatelj potrebuje osebo, agent pošlje SIP `REFER`, Genesys prevzame klic nazaj, ID predaje pa prispe v podatkih UUI klica.

## Preden začnete

- Agent ThunderPhone in [ključ API](/sl/guides/api-keys) organizacije.
- Genesys Cloud z BYOC Cloud in zunanjo povezavo (vrste BYOC Carrier ali
  PBX) z omogočenimi naslednjimi nastavitvami
  ([nastavitve zunanje povezave](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **Glave pogovora**, da Genesys pošlje ID pogovora v
    `x-inin-cnv`. Ta možnost je privzeto izklopljena.
  - **Posredovanje UUI**, z vrsto glave `User-To-User` in kodiranjem Hex.
  - **Prevzem nazaj in prenos**, da Genesys sprejme agentov `REFER`.

## 1. Ustvarite končno točko SIP

Genesys odgovori na izziv digest, zato uporabite standardno končno točko:

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

Takoj shranite `password` iz odgovora; prikazan je samo enkrat. Na
povezavi:

| Nastavitev | Vrednost |
|---|---|
| Strežnik SIP | `sip.thunderphone.com`, vrata `5061` |
| Protokol | TLS |
| Preverjanje pristnosti digest | `username` in `password` končne točke |
| Kodeki | PCMU, PCMA ali G.722 |

Povezavo dodajte na izhodno pot vaše lokacije, katere načrt številk zajema
naslov, ki ga kliče tok.

## 2. Pošiljanje klicev s kontekstom

V svojem toku Architect:

1. Po želji dodajte dejanje **Nastavi podatke UUI** s kontekstom za agenta, na
   primer `account=12345`. Genesys priporoča 128 znakov ali manj.
2. Dodajte dejanje **Prenos na številko** z `sip_uri` končne točke, na
   primer `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

Genesys pošlje ID pogovora v `x-inin-cnv`. ThunderPhone ga shrani kot
`external_call_id` klica. UUI prispe v poziv dekodiran kot
`{{sip_uui}}`.

Glave po meri povezave so v Genesysu statične, zato vrednosti posameznih klicev
vnesite v UUI. Genesys si zase pridržuje predpone glav `x-inin`, `x-genesys`,
`x-pcv` in `x-gcv`.

## 3. Prevzemite klic nazaj

Agent prenese klic z `REFER` na naslov v Genesysu, z ID-jem predaje kot
šestnajstiškim UUI v tem naslovu. Dodajte to številko za prenos (glejte
[Dodajte številko za prenos](/sl/guides/contact-centers/overview)
in [Glave v naslovu za prenos](/sl/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"
}
```

Naslov zamenjajte z naslovom, ki usmerja nazaj v čakalno vrsto ali tok, ki mora
prevzeti klicatelja; njegovo obliko potrdite pri Genesysu. `REFER` je videti
takole:

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

Ko je možnost **Prevzem nazaj in prenos** omogočena, Genesys prevzame klic
nazaj s povezave in ga usmeri na ta naslov. Genesys navaja, da dohodni UUI
prispe v `Call.UUIData`; tega ne dokumentira za prevzem nazaj, zato pri
Genesysu ali s preskusnim klicem potrdite, da tok, ki prejme klicatelja, tam
najde ID predaje. Za pridobitev povzetka in namena pokličite iskanje predaje z
**Dejanjem podatkov klica** v integraciji Data Actions spletnih storitev:

- Zahteva: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  ki ji sledi ID iz `Call.UUIData`.
- Poverilnice: vaš ključ API, poslan kot `Authorization: Bearer sk_live_…`.
- Izhod: preslikajte `handoff.summary` in `handoff.intent` v spremenljivke toka.

Glejte [Poiščite predani klic](/api-reference/calls#look-up-a-handed-off-call).

## Preizkusite

Pokličite številko, ki doseže tok, agenta prosite za osebo in preverite, ali
Genesys klic preusmeri na naslov, ki ste ga nastavili. V tem toku preverite, ali
`Call.UUIData` vsebuje ID predaje kot besedilo (če prikazuje šestnajstiške števke, preverite, ali je kodiranje UUI v tranku nastavljeno na Hex). Nato odprite klic z `GET /v1/calls/{call_id}`:
`external_call_id` mora biti ID pogovora.

## Omejitve

- Dejanja **Pridobite glave SIP** preberejo samo začetni `INVITE`, zato ne morejo
  prebrati ničesar iz agentovega `REFER`. Predaja doseže Genesys samo prek UUI.
- Genesys zavrže vse UUI, kadar klic vsebuje več kot eno glavo UUI.
- Naslov za prenos je omejen na 254 znakov, zato se dolg UUI skrajša, da ustreza.
  ID predaje se vedno prilega.
