---
title: "Connetti da Genesys Cloud"
description: "Invia le chiamate Genesys Cloud a un agente ThunderPhone tramite un trunk BYOC Cloud con l'ID conversazione e UUI, quindi riprendile con il passaggio in consegna nell'UUI."
---

Il flusso Architect invia il chiamante all'agente tramite un trunk BYOC Cloud, con l'id della conversazione e qualsiasi UUI impostata. Quando il chiamante ha bisogno di una persona, l'agente invia un `REFER` SIP, Genesys riprende la chiamata e l'id di passaggio arriva nell'UUI della chiamata.

## Prima di iniziare

- Un agente ThunderPhone e una [chiave API](/it/guides/api-keys) dell'organizzazione.
- Genesys Cloud con BYOC Cloud e un trunk esterno (tipo BYOC Carrier o
  PBX) con queste impostazioni attivate
  ([impostazioni del trunk esterno](https://help.genesys.cloud/articles/external-trunk-settings/)):
  - **Intestazioni conversazione**, affinché Genesys invii il proprio id della conversazione in
    `x-inin-cnv`. Per impostazione predefinita è disattivato.
  - **Passaggio UUI**, con tipo di intestazione `User-To-User` e codifica Hex.
  - **Riprendi e trasferisci**, affinché Genesys accetti il `REFER` dell'agente.

## 1. Crea l'endpoint SIP

Genesys risponde a una richiesta digest, quindi utilizza 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 subito la `password` della risposta; viene mostrata una sola volta. Sul
trunk:

| Impostazione | Valore |
|---|---|
| Server SIP | `sip.thunderphone.com`, porta `5061` |
| Protocollo | TLS |
| Autenticazione digest | `username` e `password` dell'endpoint |
| Codec | PCMU, PCMA o G.722 |

Inserisci il trunk in una route in uscita del tuo sito il cui piano di numerazione copra l'indirizzo composto dal flusso.

## 2. Invia chiamate con contesto

Nel tuo flusso Architect:

1. Facoltativamente, aggiungi un'azione **Imposta dati UUI** con il contesto per l'agente, ad
   esempio `account=12345`. Genesys consiglia 128 caratteri o meno.
2. Aggiungi un'azione **Trasferisci a numero** con il `sip_uri` dell'endpoint, ad
   esempio `sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

Genesys invia l'id della conversazione in `x-inin-cnv`. ThunderPhone lo archivia come
`external_call_id` della chiamata. L'UUI raggiunge il prompt decodificato, come
`{{sip_uui}}`.

Le intestazioni personalizzate del trunk sono statiche in Genesys, quindi inserisci i valori per chiamata nell'UUI.
Genesys riserva a sé i prefissi delle intestazioni `x-inin`, `x-genesys`, `x-pcv` e `x-gcv`.

## 3. Riprendi la chiamata

L'agente trasferisce con un `REFER` a un indirizzo su Genesys, con l'id di passaggio come UUI esadecimale all'interno di quell'indirizzo. Aggiungi questo numero di trasferimento (vedi
[Aggiungi il numero di trasferimento](/it/guides/contact-centers/overview)
e [Intestazioni all'interno dell'indirizzo di trasferimento](/it/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"
}
```

Sostituisci l'indirizzo con uno che instradi di nuovo alla coda o al flusso che deve
ricevere il chiamante; confermane il formato con Genesys. Il `REFER` è simile a questo:

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

Con **Riprendi e trasferisci** attivato, Genesys riprende la chiamata dal trunk
e la instrada a quell'indirizzo. Genesys documenta che l'UUI in arrivo viene inserito in
`Call.UUIData`; non lo documenta per una ripresa, quindi verifica con
Genesys, oppure con una chiamata di prova, che il flusso che riceve il chiamante trovi
l'id di passaggio lì. Per ottenere il riepilogo e l'intento, richiama la ricerca del passaggio con
un'**Azione dati di chiamata** in un'integrazione Web Services Data Actions:

- Richiesta: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`
  seguito dall'id di `Call.UUIData`.
- Credenziali: la tua chiave API, inviata come `Authorization: Bearer sk_live_…`.
- Output: mappa `handoff.summary` e `handoff.intent` alle variabili del flusso.

Vedi [Cerca una chiamata passata](/api-reference/calls#look-up-a-handed-off-call).

## Provalo

Chiama un numero che raggiunge il flusso, chiedi all'agente una persona e verifica che
Genesys instradi la chiamata all'indirizzo impostato. In quel flusso, verifica che
`Call.UUIData` contenga l'ID di hand-off come testo (se mostra cifre esadecimali, verifica che la codifica UUI del trunk sia Hex). Poi apri la chiamata con `GET /v1/calls/{call_id}`:
`external_call_id` dovrebbe essere l'ID della conversazione.

## Limiti

- L'azione **Ottieni intestazioni SIP** legge solo l'`INVITE` iniziale, quindi non può
  leggere nulla dal `REFER` dell'agente. L'hand-off raggiunge Genesys solo
  tramite UUI.
- Genesys elimina tutti gli UUI quando una chiamata contiene più di un'intestazione UUI.
- L'indirizzo di trasferimento è limitato a 254 caratteri, quindi un UUI lungo viene troncato per rientrare.
  Un ID di hand-off rientra sempre.
