---
title: "Ühenda Genesys Cloudist"
description: "Suuna Genesys Cloudi kõned ThunderPhone'i agendile BYOC Cloudi trunki kaudu koos vestluse ID ja UUI-ga ning võta need tagasi, edastades üleandmise UUI-s."
---

Sinu Architecti voog saadab helistaja agendile BYOC Cloudi trunki kaudu koos
vestluse ID ja sinu määratud UUI-ga. Kui helistaja vajab inimest, saadab
agent SIP-i `REFER`, Genesys võtab kõne tagasi ja üleandmise ID jõuab kõne UUI-sse.

## Enne alustamist

- ThunderPhone'i agent ja organisatsiooni [API-võti](/et/guides/api-keys).
- Genesys Cloud koos BYOC Cloudiga ning väline trunk (tüüp BYOC Carrier või
  PBX), kus on sisse lülitatud järgmised seaded
  ([välise trunki seaded](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **Vestluse päised**, et Genesys saadaks oma vestluse ID väljal
    `x-inin-cnv`. See on vaikimisi välja lülitatud.
  - **UUI edastamine**, päisetüübiga `User-To-User` ja Hex-kodeeringuga.
  - **Tagasivõtmine ja edastamine**, et Genesys aktsepteeriks agendi `REFER`-i.

## 1. Loo SIP-lõpp-punkt

Genesys vastab Digest-kutsele, seega kasuta standardset lõpp-punkti:

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

Salvesta vastusest saadud `password` kohe; seda kuvatakse ainult ühe korra. Trunkis:

| Seade | Väärtus |
|---|---|
| SIP-server | `sip.thunderphone.com`, port `5061` |
| Protokoll | TLS |
| Digest-autentimine | lõpp-punkti `username` ja `password` |
| Koodekid | PCMU, PCMA või G.722 |

Lisa trunk oma saidi väljaminevale marsruudile, mille numeratsiooniplaan katab
aadressi, millele voog helistab.

## 2. Saada kõned koos kontekstiga

Oma Architecti voos:

1. Soovi korral lisa agendi jaoks kontekstiga **Määra UUI-andmed** toiming,
   näiteks `account=12345`. Genesys soovitab kasutada kuni 128 tähemärki.
2. Lisa **Edasta numbrile** toiming lõpp-punkti `sip_uri`-ga, näiteks
   `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

Genesys saadab vestluse ID väljal `x-inin-cnv`. ThunderPhone salvestab selle
kõne `external_call_id`-na. UUI jõuab viibani dekodeeritult väljana
`{{sip_uui}}`.

Trunki kohandatud päised on Genesyses staatilised, seega paiguta kõnepõhised
väärtused UUI-sse. Genesys reserveerib endale päiseliited `x-inin`,
`x-genesys`, `x-pcv` ja `x-gcv`.

## 3. Võta kõne tagasi

Agent edastab kõne `REFER`-iga Genesyses olevale aadressile, mille sees on
üleandmise ID kuueteistkümnendkoodis UUI-na. Lisa see edastusnumber (vaata
[Edastusnumbri lisamine](/et/guides/contact-centers/overview)
ja [Päised edastusaadressis](/et/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"
}
```

Asenda aadress sellisega, mis suunab tagasi järjekorda või voogu, mis peab
helistaja vastu võtma; kinnita selle vorm Genesysega. `REFER` näeb välja
selline:

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

Kui **Tagasivõtmine ja edastamine** on sisse lülitatud, võtab Genesys kõne
trunkilt tagasi ja suunab selle sellele aadressile. Genesys dokumenteerib, et
sissetulev UUI jõuab väljale `Call.UUIData`; tagasivõtmise kohta seda ei
dokumenteerita, seega kinnita Genesysega või testkõnes, et helistaja vastu võttev
voog leiab sealt üleandmise ID. Kokkuvõtte ja kavatsuse saamiseks kutsu
üleandmise otsingut **Kõne andmetoimingu** abil integratsioonis Web Services
Data Actions:

- Päring: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`,
  millele järgneb `Call.UUIData` ID.
- Tuvastamisandmed: sinu API-võti, saadetud kujul `Authorization: Bearer sk_live_…`.
- Väljund: seo `handoff.summary` ja `handoff.intent` voo muutujatega.

Vaata [Üle antud kõne otsimine](/api-reference/calls#look-up-a-handed-off-call).

## Testi

Helista numbrile, mis suunab kõne voogu, palu agendilt inimest ja kontrolli, et
Genesys suunab kõne sinu määratud aadressile. Selles voos kontrolli, et
`Call.UUIData` sisaldab üleandmise ID-d tekstina (kui kuvatakse kuueteistkümnendsüsteemi numbrid, kontrolli, et trunk'i UUI kodeering on Hex). Seejärel ava kõne käsuga `GET /v1/calls/{call_id}`:
`external_call_id` peaks olema vestluse ID.

## Piirangud

- Toiming **Hangi SIP-päised** loeb ainult algset `INVITE`-i, seega ei saa see
  agendi `REFER`-ist midagi lugeda. Üleandmine jõuab Genesysesse ainult UUI kaudu.
- Genesys eemaldab kogu UUI, kui kõnel on rohkem kui üks UUI-päis.
- Edastusaadress on piiratud 254 tähemärgiga, seega pikk UUI kärbitakse sobivaks.
  Üleandmise ID mahub alati ära.