---
title: "Conectați-vă din Genesys Cloud"
description: "Trimiteți apelurile Genesys Cloud către un agent ThunderPhone printr-un trunk BYOC Cloud cu ID-ul conversației și UUI, apoi preluați-le înapoi cu transferul în UUI."
---

Fluxul Architect trimite apelantul către agent printr-un trunchi BYOC Cloud, împreună cu ID-ul conversației și orice UUI setați. Când apelantul are nevoie de o persoană, agentul trimite un `REFER` SIP, Genesys preia apelul înapoi, iar ID-ul de preluare ajunge în UUI-ul apelului.

## Înainte de a începe

- Un agent ThunderPhone și o [cheie API](/ro/guides/api-keys) pentru organizație.
- Genesys Cloud cu BYOC Cloud și un trunchi extern (de tip BYOC Carrier sau
  PBX) cu aceste setări activate
  ([setări pentru trunchi extern](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **Antete de conversație**, pentru ca Genesys să trimită ID-ul conversației în
    `x-inin-cnv`. Este dezactivat implicit.
  - **Transmitere UUI**, cu tipul de antet `User-To-User` și codificarea Hex.
  - **Preluare înapoi și transfer**, pentru ca Genesys să accepte `REFER`-ul agentului.

## 1. Creați endpointul SIP

Genesys răspunde la o solicitare digest, așa că utilizați un endpoint standard:

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

Salvați imediat `password` din răspuns; este afișată o singură dată. Pe
trunchi:

| Setare | Valoare |
|---|---|
| Server SIP | `sip.thunderphone.com`, portul `5061` |
| Protocol | TLS |
| Autentificare digest | `username` și `password` ale endpointului |
| Codec-uri | PCMU, PCMA sau G.722 |

Adăugați trunchiul la o rută de ieșire a site-ului dumneavoastră, al cărei plan
de numerotație acoperă adresa apelată de flux.

## 2. Trimiteți apeluri cu context

În fluxul Architect:

1. Opțional, adăugați o acțiune **Setați date UUI** cu context pentru agent, cum
   ar fi `account=12345`. Genesys recomandă cel mult 128 de caractere.
2. Adăugați o acțiune **Transferați către număr** cu `sip_uri` al endpointului,
   de exemplu `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

Genesys trimite ID-ul conversației în `x-inin-cnv`. ThunderPhone îl stochează ca
`external_call_id` al apelului. UUI-ul ajunge decodificat în prompt, ca
`{{sip_uui}}`.

Antetele personalizate ale trunchiului sunt statice în Genesys, așa că includeți
valorile pentru fiecare apel în UUI. Genesys rezervă pentru uz propriu prefixele
de antet `x-inin`, `x-genesys`, `x-pcv` și `x-gcv`.

## 3. Preluați apelul înapoi

Agentul transferă cu un `REFER` către o adresă din Genesys, cu ID-ul de preluare
ca UUI hex în acea adresă. Adăugați acest număr de transfer (consultați
[Adăugați numărul de transfer](/ro/guides/contact-centers/overview)
și [Antete în adresa de transfer](/ro/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"
}
```

Înlocuiți adresa cu una care direcționează înapoi către coada sau fluxul care
trebuie să preia apelantul; confirmați formatul acesteia cu Genesys. `REFER`
arată astfel:

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

Cu **Preluare înapoi și transfer** activată, Genesys preia apelul înapoi din
trunchi și îl direcționează către acea adresă. Genesys documentează că UUI-ul
primit ajunge în `Call.UUIData`; nu documentează acest lucru pentru o preluare
înapoi, așa că confirmați cu Genesys sau printr-un apel de test că fluxul care
primește apelantul găsește acolo ID-ul de preluare. Pentru a obține rezumatul și
intenția, apelați căutarea preluării cu o **Acțiune de date apel** într-o
integrare Web Services Data Actions:

- Cerere: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  urmată de ID-ul din `Call.UUIData`.
- Credențiale: cheia dumneavoastră API, trimisă ca `Authorization: Bearer sk_live_…`.
- Ieșire: mapați `handoff.summary` și `handoff.intent` la variabilele fluxului.

Consultați [Căutați un apel preluat](/api-reference/calls#look-up-a-handed-off-call).

## Testați

Apelați un număr care ajunge în flux, cereți agentului o persoană și verificați că
Genesys direcționează apelul către adresa setată. În acel flux, verificați că
`Call.UUIData` conține ID-ul de predare ca text (dacă afișează cifre hexazecimale, verificați dacă codarea UUI a trunkului este Hex). Apoi deschideți apelul cu `GET /v1/calls/{call_id}`:
`external_call_id` ar trebui să fie ID-ul conversației.

## Limitări

- Acțiunea **Obține antetele SIP** citește doar `INVITE` inițial, deci nu poate
  citi nimic din `REFER` al agentului. Predarea ajunge la Genesys numai
  prin UUI.
- Genesys elimină toate datele UUI atunci când un apel conține mai mult de un antet UUI.
- Adresa de transfer este limitată la 254 de caractere, astfel încât un UUI lung este trunchiat pentru a se încadra.
  Un ID de predare se încadrează întotdeauna.
