---
title: "Yhdistä Genesys Cloudista"
description: "Ohjaa Genesys Cloud -puhelut ThunderPhone-agentille BYOC Cloud -rungon kautta keskustelutunnuksen ja UUI:n kanssa ja ota ne takaisin UUI:ssa olevan siirron avulla."
---

Architect-työnkulkusi ohjaa soittajan agentille BYOC Cloud -runkoyhteyden kautta
keskustelutunnuksen ja määrittämiesi UUI-tietojen kanssa. Kun soittaja tarvitsee ihmisen,
agentti lähettää SIP-`REFER`-pyynnön, Genesys ottaa puhelun takaisin, ja
siirtotunnus saapuu puhelun UUI-tietoihin.

## Ennen aloittamista

- ThunderPhone-agentti ja organisaation [API-avain](/fi/guides/api-keys).
- Genesys Cloud, jossa on BYOC Cloud, sekä ulkoinen runkoyhteys (tyyppi BYOC Carrier tai
  PBX), jossa nämä asetukset ovat käytössä
  ([ulkoisen runkoyhteyden asetukset](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **Keskusteluotsakkeet**, jotta Genesys lähettää keskustelutunnuksensa
    kentässä `x-inin-cnv`. Asetus on oletusarvoisesti pois käytöstä.
  - **UUI-läpivienti**, jossa otsaketyyppi on `User-To-User` ja koodaus Hex.
  - **Takaisinotto ja siirto**, jotta Genesys hyväksyy agentin `REFER`-pyynnön.

## 1. Luo SIP-päätepiste

Genesys vastaa digest-haasteeseen, joten käytä tavallista päätepistettä:

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

Tallenna vastauksen `password` heti; se näytetään vain kerran. Määritä
runkoyhteyteen:

| Asetus | Arvo |
|---|---|
| SIP-palvelin | `sip.thunderphone.com`, portti `5061` |
| Protokolla | TLS |
| Digest-todennus | päätepisteen `username` ja `password` |
| Koodekit | PCMU, PCMA tai G.722 |

Lisää runkoyhteys sivustosi lähtevälle reitille, jonka numerointisuunnitelma kattaa
osoitteen, johon työnkulku soittaa.

## 2. Lähetä puhelut kontekstin kanssa

Architect-työnkulussasi:

1. Lisää halutessasi **Aseta UUI-tiedot** -toiminto, johon määrität agentin kontekstin,
   esimerkiksi `account=12345`. Genesys suosittelee enintään 128 merkkiä.
2. Lisää **Siirrä numeroon** -toiminto, jonka arvona on päätepisteen `sip_uri`,
   esimerkiksi `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

Genesys lähettää keskustelutunnuksen kentässä `x-inin-cnv`. ThunderPhone tallentaa sen
puhelun `external_call_id`-tunnuksena. UUI saapuu kehotteeseen purettuna muodossa
`{{sip_uui}}`.

Runkoyhteyden mukautetut otsakkeet ovat Genesysissä staattisia, joten sijoita puhelukohtaiset
arvot UUI-tietoihin. Genesys varaa `x-inin`-, `x-genesys`-, `x-pcv`- ja `x-gcv`-otsake-etuliitteet
omaan käyttöönsä.

## 3. Ota puhelu takaisin

Agentti siirtää puhelun `REFER`-pyynnöllä Genesysin osoitteeseen, jossa siirtotunnus on
heksadesimaalisena UUI-tietona osoitteen sisällä. Lisää tämä siirtonumero (katso
[Lisää siirtonumero](/fi/guides/contact-centers/overview)
ja [Otsakkeet siirto-osoitteen sisällä](/fi/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"
}
```

Korvaa osoite osoitteella, joka reitittää takaisin jonoon tai työnkulkuun, jonka tulee
ottaa soittaja vastaan; varmista sen muoto Genesysiltä. `REFER` näyttää tältä:

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

Kun **Takaisinotto ja siirto** on käytössä, Genesys ottaa puhelun takaisin runkoyhteydestä
ja reitittää sen tähän osoitteeseen. Genesys dokumentoi, että saapuva UUI tallentuu
kohteeseen `Call.UUIData`; se ei dokumentoi tätä takaisinoton osalta, joten varmista
Genesysiltä tai testipuhelulla, että soittajan vastaanottava työnkulku löytää
siirtotunnuksen sieltä. Saat yhteenvedon ja tarkoituksen hakemalla siirron tiedot
**Puheludatatoiminnolla** Web Services Data Actions -integraatiossa:

- Pyyntö: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  ja sen perään tunnus kohteesta `Call.UUIData`.
- Tunnistetiedot: API-avaimesi, joka lähetetään muodossa `Authorization: Bearer sk_live_…`.
- Tuloste: yhdistä `handoff.summary` ja `handoff.intent` työnkulun muuttujiin.

Katso [Siirretyn puhelun tietojen haku](/api-reference/calls#look-up-a-handed-off-call).

## Testaa

Soita numeroon, joka ohjaa työnkulkuun, pyydä agentilta henkilöä ja tarkista, että
Genesys ohjaa puhelun määrittämääsi osoitteeseen. Tarkista siinä työnkulussa, että
`Call.UUIData` sisältää siirtotunnuksen tekstinä (jos siinä näkyy heksadesimaalinumeroita, tarkista, että
runkoyhteyden UUI-koodaus on Hex). Avaa sitten puhelu komennolla `GET /v1/calls/{call_id}`:
`external_call_id`-kentän pitäisi olla keskustelutunnus.

## Rajoitukset

- **Get SIP Headers** -toiminto lukee vain alkuperäisen `INVITE`-pyynnön, joten se ei voi
  lukea mitään agentin `REFER`-pyynnöstä. Siirto saavuttaa Genesysin vain UUI:n kautta.
- Genesys hylkää kaiken UUI-datan, kun puhelussa on useampi kuin yksi UUI-otsake.
- Siirto-osoite rajoitetaan 254 merkkiin, joten pitkä UUI katkaistaan sopivaksi.
  Siirtotunnus mahtuu aina.
