---
title: "Połącz z Genesys Cloud"
description: "Przekierowuj połączenia Genesys Cloud do agenta ThunderPhone przez trunk BYOC Cloud z identyfikatorem rozmowy i UUI, a następnie kieruj je z powrotem z przekazaniem w UUI."
---

Przepływ Architect wysyła rozmówcę do agenta przez trunk BYOC Cloud wraz z identyfikatorem konwersacji i dowolnym ustawionym przez Ciebie UUI. Gdy rozmówca potrzebuje człowieka, agent wysyła SIP `REFER`, Genesys przejmuje połączenie z powrotem, a identyfikator przekazania trafia do UUI połączenia.

## Zanim zaczniesz

- Agent ThunderPhone i organizacyjny [klucz API](/pl/guides/api-keys).
- Genesys Cloud z BYOC Cloud oraz trunk zewnętrzny (typ BYOC Carrier lub
  PBX) z włączonymi tymi ustawieniami
  ([ustawienia trunku zewnętrznego](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **Nagłówki konwersacji**, aby Genesys wysyłał identyfikator konwersacji w
    `x-inin-cnv`. Domyślnie jest wyłączone.
  - **Przekazywanie UUI**, z typem nagłówka `User-To-User` i kodowaniem Hex.
  - **Przejęcie z powrotem i transfer**, aby Genesys akceptował `REFER` agenta.

## 1. Utwórz punkt końcowy SIP

Genesys odpowiada na wyzwanie digest, więc użyj standardowego punktu końcowego:

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

Od razu zapisz `password` z odpowiedzi; jest wyświetlane tylko raz. Na
trunku:

| Ustawienie | Wartość |
|---|---|
| Serwer SIP | `sip.thunderphone.com`, port `5061` |
| Protokół | TLS |
| Uwierzytelnianie digest | `username` i `password` punktu końcowego |
| Kodeki | PCMU, PCMA lub G.722 |

Umieść trunk na trasie wychodzącej witryny, której plan numeracyjny obejmuje
adres wybierany przez przepływ.

## 2. Wysyłaj połączenia z kontekstem

W przepływie Architect:

1. Opcjonalnie dodaj akcję **Ustaw dane UUI** z kontekstem dla agenta, na
   przykład `account=12345`. Genesys zaleca maksymalnie 128 znaków.
2. Dodaj akcję **Transfer na numer** z `sip_uri` punktu końcowego, na
   przykład `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

Genesys wysyła identyfikator konwersacji w `x-inin-cnv`. ThunderPhone zapisuje
go jako `external_call_id` połączenia. UUI trafia do promptu w postaci
zdekodowanej jako `{{sip_uui}}`.

Niestandardowe nagłówki trunku są statyczne w Genesys, dlatego wartości
specyficzne dla połączenia umieszczaj w UUI. Genesys rezerwuje dla siebie
prefiksy nagłówków `x-inin`, `x-genesys`, `x-pcv` i `x-gcv`.

## 3. Przejmij połączenie z powrotem

Agent przekazuje połączenie za pomocą `REFER` na adres w Genesys, z
identyfikatorem przekazania jako szesnastkowym UUI w tym adresie. Dodaj ten
numer transferu (zobacz
[Dodawanie numeru transferu](/pl/guides/contact-centers/overview)
oraz [Nagłówki w adresie transferu](/pl/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"
}
```

Zastąp adres takim, który kieruje z powrotem do kolejki lub przepływu
obsługującego rozmówcę; potwierdź jego format w Genesys. `REFER` wygląda tak:

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

Po włączeniu **Przejęcia z powrotem i transferu** Genesys przejmuje połączenie
z powrotem z trunku i kieruje je na ten adres. Genesys dokumentuje, że
przychodzące UUI trafia do `Call.UUIData`; nie dokumentuje tego dla przejęcia
z powrotem, dlatego potwierdź w Genesys lub podczas połączenia testowego, że
przepływ odbierający rozmówcę znajduje tam identyfikator przekazania. Aby
pobrać podsumowanie i intencję, wywołaj wyszukiwanie przekazania za pomocą
**Akcji danych połączenia** w integracji Akcje danych usług internetowych:

- Żądanie: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  z identyfikatorem z `Call.UUIData`.
- Poświadczenia: klucz API wysłany jako `Authorization: Bearer sk_live_…`.
- Dane wyjściowe: zmapuj `handoff.summary` i `handoff.intent` na zmienne przepływu.

Zobacz [Wyszukiwanie przekazanego połączenia](/api-reference/calls#look-up-a-handed-off-call).

## Przetestuj

Zadzwoń na numer kierujący do przepływu, poproś agenta o połączenie z osobą i sprawdź, czy
Genesys przekierowuje połączenie na ustawiony adres. W tym przepływie sprawdź, czy
`Call.UUIData` zawiera identyfikator przekazania jako tekst (jeśli wyświetla cyfry szesnastkowe, sprawdź, czy kodowanie UUI magistrali jest ustawione na Hex). Następnie otwórz połączenie za pomocą `GET /v1/calls/{call_id}`:
`external_call_id` powinno być identyfikatorem rozmowy.

## Ograniczenia

- Akcja **Pobierz nagłówki SIP** odczytuje tylko początkowe `INVITE`, więc nie może
  odczytać niczego z `REFER` agenta. Przekazanie dociera do Genesys wyłącznie
  przez UUI.
- Genesys odrzuca wszystkie dane UUI, gdy połączenie zawiera więcej niż jeden nagłówek UUI.
- Adres przekierowania jest ograniczony do 254 znaków, więc długie UUI jest skracane, aby się zmieściło.
  Identyfikator przekazania zawsze się mieści.
