---
title: "Savienojiet no Genesys Cloud"
description: "Novirziet Genesys Cloud zvanus uz ThunderPhone balss aģentu, izmantojot BYOC Cloud maģistrāli ar sarunas ID un UUI, un novirziet tos atpakaļ, izmantojot UUI pāradresāciju."
---

Jūsu Architect plūsma nosūta zvanītāju aģentam pa BYOC Cloud maģistrāli kopā ar
sarunas id un jebkādiem jūsu iestatītajiem UUI datiem. Kad zvanītājam ir vajadzīgs cilvēks,
aģents nosūta SIP `REFER`, Genesys pārņem zvanu atpakaļ, un nodošanas id
nonāk zvana UUI.

## Pirms sākat

- ThunderPhone aģents un organizācijas [API atslēga](/lv/guides/api-keys).
- Genesys Cloud ar BYOC Cloud un ārējo maģistrāli (tips BYOC Carrier vai
  PBX), kurā ir ieslēgti šie iestatījumi
  ([ārējās maģistrāles iestatījumi](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **Sarunas galvenes**, lai Genesys nosūtītu savas sarunas id laukā
    `x-inin-cnv`. Pēc noklusējuma tas ir izslēgts.
  - **UUI pārsūtīšana**, ar galvenes tipu `User-To-User` un Hex kodējumu.
  - **Atpakaļpārņemšana un pārsūtīšana**, lai Genesys pieņemtu aģenta `REFER`.

## 1. Izveidojiet SIP galapunktu

Genesys atbild uz digest izaicinājumu, tāpēc izmantojiet standarta galapunktu:

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

Nekavējoties saglabājiet atbildē saņemto `password`; tas tiek parādīts tikai vienreiz. Maģistrālē:

| Iestatījums | Vērtība |
|---|---|
| SIP serveris | `sip.thunderphone.com`, ports `5061` |
| Protokols | TLS |
| Digest autentifikācija | galapunkta `username` un `password` |
| Kodeki | PCMU, PCMA vai G.722 |

Pievienojiet maģistrāli savas vietnes izejošajam maršrutam, kura numuru plāns aptver
adresi, uz kuru plūsma zvana.

## 2. Sūtiet zvanus ar kontekstu

Savā Architect plūsmā:

1. Pēc izvēles pievienojiet darbību **Iestatīt UUI datus** ar aģenta kontekstu,
   piemēram, `account=12345`. Genesys iesaka izmantot 128 vai mazāk rakstzīmju.
2. Pievienojiet darbību **Pārsūtīt uz numuru** ar galapunkta `sip_uri`, piemēram,
   `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

Genesys nosūta sarunas id laukā `x-inin-cnv`. ThunderPhone to saglabā kā
zvana `external_call_id`. UUI sasniedz uzvedni atkodētā veidā kā
`{{sip_uui}}`.

Maģistrāles pielāgotās galvenes Genesys vidē ir statiskas, tāpēc katra zvana vērtības ievietojiet UUI.
Genesys sev rezervē galveņu prefiksus `x-inin`, `x-genesys`, `x-pcv` un `x-gcv`.

## 3. Saņemiet zvanu atpakaļ

Aģents pārsūta ar `REFER` uz Genesys adresi, kuras iekšpusē kā hex UUI ir
nodošanas id. Pievienojiet šo pārsūtīšanas numuru (skatiet
[Pievienojiet pārsūtīšanas numuru](/lv/guides/contact-centers/overview)
un [Galvenes pārsūtīšanas adresē](/lv/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"
}
```

Aizstājiet adresi ar tādu, kas maršrutē atpakaļ uz rindu vai plūsmu, kurai ir
jāapkalpo zvanītājs; apstipriniet tās formu ar Genesys. `REFER` izskatās šādi:

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

Kad ir ieslēgta **Atpakaļpārņemšana un pārsūtīšana**, Genesys pārņem zvanu atpakaļ no maģistrāles
un maršrutē to uz šo adresi. Genesys dokumentācijā norādīts, ka ienākošais UUI nonāk
`Call.UUIData`; tas nav dokumentēts atpakaļpārņemšanas gadījumam, tāpēc apstipriniet ar
Genesys vai testa zvanā, ka plūsma, kas saņem zvanītāju, tur atrod
nodošanas id. Lai iegūtu kopsavilkumu un nolūku, izsauciet nodošanas meklēšanu ar
**Zvanu datu darbību** Web Services Data Actions integrācijā:

- Pieprasījums: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  kam seko id no `Call.UUIData`.
- Akreditācijas dati: jūsu API atslēga, nosūtīta kā `Authorization: Bearer sk_live_…`.
- Izvade: kartējiet `handoff.summary` un `handoff.intent` uz plūsmas mainīgajiem.

Skatiet [Meklējiet nodotu zvanu](/api-reference/calls#look-up-a-handed-off-call).

## Pārbaudiet to

Piezvaniet uz numuru, kas sasniedz plūsmu, palūdziet aģentam savienot ar personu un pārbaudiet, vai
Genesys pārsūta zvanu uz jūsu iestatīto adresi. Šajā plūsmā pārbaudiet, vai
`Call.UUIData` satur nodošanas ID kā tekstu (ja tajā redzami heksadecimālie cipari, pārbaudiet, vai maģistrāles UUI kodējums ir Hex). Pēc tam atveriet zvanu ar `GET /v1/calls/{call_id}`:
`external_call_id` jābūt sarunas ID.

## Ierobežojumi

- Darbība **Iegūt SIP galvenes** nolasa tikai sākotnējo `INVITE`, tāpēc tā nevar
  nolasīt neko no aģenta `REFER`. Nodošana sasniedz Genesys tikai
  caur UUI.
- Genesys noņem visus UUI, ja zvanam ir vairāk nekā viena UUI galvene.
- Pārsūtīšanas adrese ir ierobežota līdz 254 rakstzīmēm, tāpēc garš UUI tiek saīsināts, lai ietilptu.
  Nodošanas ID vienmēr ietilpst.
