---
title: "Povežite se iz Genesys Clouda"
description: "Šaljite pozive iz Genesys Clouda glasovnom agentu ThunderPhone putem BYOC Cloud trunka s ID-jem razgovora i UUI-jem te ih preuzmite natrag s predajom u UUI-ju."
---

Vaš Architect tok šalje pozivatelja agentu preko BYOC Cloud trunka, zajedno s ID-jem razgovora i svim UUI podacima koje postavite. Kada pozivatelj treba osobu, agent šalje SIP `REFER`, Genesys preuzima poziv natrag, a ID predaje stiže u UUI podacima poziva.

## Prije početka

- ThunderPhone agent i organizacijski [API ključ](/hr/guides/api-keys).
- Genesys Cloud s BYOC Cloudom i vanjskim trunkom (vrsta BYOC Carrier ili
  PBX) s uključenim sljedećim postavkama
  ([postavke vanjskog trunka](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **Zaglavlja razgovora**, kako bi Genesys slao svoj ID razgovora u
    `x-inin-cnv`. Ta je postavka prema zadanim postavkama isključena.
  - **Prosljeđivanje UUI podataka**, s vrstom zaglavlja `User-To-User` i
    kodiranjem Hex.
  - **Preuzimanje natrag i prijenos**, kako bi Genesys prihvatio agentov `REFER`.

## 1. Izradite SIP krajnju točku

Genesys odgovara na digest izazov, stoga upotrijebite standardnu krajnju točku:

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

Odmah spremite `password` iz odgovora; prikazuje se samo jednom. Na trunku:

| Postavka | Vrijednost |
|---|---|
| SIP poslužitelj | `sip.thunderphone.com`, port `5061` |
| Protokol | TLS |
| Digest autentikacija | `username` i `password` krajnje točke |
| Kodeci | PCMU, PCMA ili G.722 |

Postavite trunk na odlaznu rutu svoje lokacije čiji plan brojeva obuhvaća
adresu koju tok bira.

## 2. Šaljite pozive s kontekstom

U svom Architect toku:

1. Prema potrebi dodajte radnju **Postavi UUI podatke** s kontekstom za agenta,
   kao što je `account=12345`. Genesys preporučuje 128 znakova ili manje.
2. Dodajte radnju **Prijenos na broj** s `sip_uri` krajnje točke, na primjer
   `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

Genesys šalje ID razgovora u `x-inin-cnv`. ThunderPhone ga pohranjuje kao
`external_call_id` poziva. UUI podaci stižu u prompt dekodirani, kao
`{{sip_uui}}`.

Prilagođena zaglavlja trunka statična su u Genesysu, stoga vrijednosti po pozivu
stavite u UUI podatke. Genesys za sebe rezervira prefikse zaglavlja `x-inin`,
`x-genesys`, `x-pcv` i `x-gcv`.

## 3. Preuzmite poziv natrag

Agent prenosi poziv pomoću `REFER` na adresu u Genesysu, s ID-jem predaje kao
heksadekadskim UUI podacima unutar te adrese. Dodajte ovaj broj za prijenos
(pogledajte [Dodajte broj za prijenos](/hr/guides/contact-centers/overview)
i [Zaglavlja unutar adrese za prijenos](/hr/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"
}
```

Zamijenite adresu onom koja usmjerava natrag na red čekanja ili tok koji treba
preuzeti pozivatelja; potvrdite njezin oblik s Genesysom. `REFER` izgleda ovako:

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

Uz uključenu postavku **Preuzimanje natrag i prijenos**, Genesys preuzima poziv
natrag s trunka i usmjerava ga na tu adresu. Genesys navodi da se dolazni UUI
podaci nalaze u `Call.UUIData`; to ne navodi za preuzimanje natrag, stoga s
Genesysom ili na testnom pozivu potvrdite da tok koji prima pozivatelja ondje
pronalazi ID predaje. Za dohvaćanje sažetka i namjere pozovite pretraživanje
predaje pomoću radnje **Podaci poziva** u integraciji Web Services Data Actions:

- Zahtjev: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  nakon čega slijedi ID iz `Call.UUIData`.
- Vjerodajnice: vaš API ključ, poslan kao `Authorization: Bearer sk_live_…`.
- Izlaz: mapirajte `handoff.summary` i `handoff.intent` na varijable toka.

Pogledajte [Potražite predani poziv](/api-reference/calls#look-up-a-handed-off-call).

## Testirajte

Nazovite broj koji vodi do toka, zatražite od agenta osobu i provjerite prenosi li
Genesys poziv na adresu koju ste postavili. U tom toku provjerite sadrži li
`Call.UUIData` ID predaje kao tekst (ako prikazuje heksadecimalne znamenke, provjerite je li UUI kodiranje trunk veze postavljeno na Hex). Zatim otvorite poziv pomoću `GET /v1/calls/{call_id}`:
`external_call_id` trebao bi biti ID razgovora.

## Ograničenja

- Radnja **Dohvaćanje SIP zaglavlja** čita samo početni `INVITE`, stoga ne može
  pročitati ništa iz agentova `REFER`. Predaja stiže do Genesysa samo putem UUI-ja.
- Genesys odbacuje sav UUI kada poziv sadrži više od jednog UUI zaglavlja.
- Adresa za prijenos ograničena je na 254 znaka, pa se dugi UUI skraćuje da bi stao.
  ID predaje uvijek stane.
