---
title: "Connetti da NICE CXone"
description: "Invia le chiamate NICE CXone a un agente ThunderPhone da un copione Studio con il ContactID in un'intestazione SIP e cerca il trasferimento dell'agente quando il copione continua."
---

Il copione CXone Studio effettua una chiamata all'agente con intestazioni SIP che trasportano l'ID del contatto e qualsiasi altro contesto. Quando l'agente ha finito, riaggancia e un'azione REST API nel copione recupera il passaggio.

## Prima di iniziare

- Un agente ThunderPhone e una [chiave API](/it/guides/api-keys) dell'organizzazione.
- Un gruppo trunk SIP CXone che accetta intestazioni personalizzate. Il rappresentante del suo account NICE deve attivare questa impostazione prima che CXone le invii.

## 1. Creare l'endpoint SIP

Placecall compone un numero di telefono tramite un gruppo trunk CXone, non un indirizzo SIP. NICE non documenta le credenziali SIP per questa funzionalità e l'integrazione CXone di un altro provider AI usa TLS con una lista di autorizzazione IP. Crei quindi un endpoint `ip_allowlist` con il numero che il copione comporrà come numero di accesso (vedere [Piattaforme che compongono un numero di telefono](/it/guides/sip-addresses)):

```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": "NICE CXone",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["CXONE_SIGNALLING_RANGE_1", "CXONE_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["+14155550188"]
  }'
```

- `allowed_source_cidrs`: gli intervalli di segnalazione SIP del suo cluster CXone, forniti da NICE. Ognuno deve essere un intervallo IPv4 pubblico di `/16` o più ristretto (IPv6 `/48` o più ristretto).
- `dial_in_numbers`: il numero che Placecall comporrà, scritto nel formato in cui CXone lo invia. Non deve necessariamente essere un numero di telefono reale. Non può essere già in uso su ThunderPhone, come numero di telefono o su un altro endpoint: in tal caso restituisce `409`.

Gli indirizzi di CXone sono condivisi da tutti i suoi clienti, quindi qualsiasi altro cliente CXone che componga il numero raggiunge il suo agente. Nel punto in cui sceglie il numero, ne selezioni uno lungo che nessuno indovinerebbe facilmente, fino a 15 cifre, si assicuri che CXone lo invii a ThunderPhone anziché alla rete telefonica e non lo pubblichi.

## 2. Inviare chiamate con contesto

Nel suo copione Studio, prima di **Placecall**:

1. Aggiunga un'azione **Sipputheader** con l'intestazione `X-Call-ID` e il valore di `ContactID`. CXone non invia un'intestazione call-id propria; ThunderPhone memorizza questa come `external_call_id` della chiamata.
2. Aggiunga un'azione **Sipputheader** per ogni altro valore che l'agente deve conoscere, ad esempio `X-Skill` impostato su `support`. Raggiunge il prompt come `{{sip_x_skill}}`. Sipputheader accetta `User-to-User`, qualsiasi intestazione `X-` e la maggior parte delle intestazioni `P-`; NICE raccomanda valori di 256 caratteri o meno.

Quindi usi **Placecall** verso quel numero, tramite un gruppo trunk che lo invia a `sip.thunderphone.com` con il numero sia nell'URI della richiesta sia nell'intestazione `To`. L'endpoint accetta TLS, porta 5061, o TCP, porta 5060, e rifiuta UDP; NICE non documenta il trasporto del trunk, quindi si assicuri che non sia UDP.

## 3. Riprendere la chiamata

CXone legge le intestazioni SIP solo nell'`INVITE` e nella relativa risposta finale, quindi l'agente restituisce la chiamata: saluta e riaggancia, mentre il suo copione riprende il chiamante. Aggiunga questo numero di trasferimento (vedere [Aggiungere il numero di trasferimento](/it/guides/contact-centers/overview)):

```json
{"name": "NICE CXone", "action": "return"}
```

NICE non documenta che un copione continui dopo Placecall quando termina la chiamata effettuata. Le integrazioni CXone di altri provider AI segnalano invece il copione tramite la Signal API di CXone (`POST /interactions/{contactId}/signal`) prima di riagganciare; ThunderPhone non la chiama. Confermi con NICE come il suo copione riprende il chiamante, quindi recuperi il passaggio con un'azione **REST API**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  seguito da `ContactID`.
- Intestazione `Authorization: Bearer sk_live_…`.
- Legga `handoff.summary` e `handoff.intent` dalla risposta per instradare il contatto.

Vedere [Cercare una chiamata trasferita](/api-reference/calls#look-up-a-handed-off-call).

## Provalo

Chiama un numero che esegue il copione, chiedi all'agente una persona e verifica che
il copione continui e che l'azione REST API restituisca il trasferimento. Se la chiamata
non raggiunge mai l'agente, controlla il numero inviato da CXone, che il suo indirizzo di origine
sia in `allowed_source_cidrs` e che la chiamata sia arrivata tramite TCP o TLS. Quindi apri la
chiamata con `GET /v1/calls/{call_id}`: `sip_headers` dovrebbe elencare `x-call-id` e
`external_call_id` dovrebbe essere uguale a `ContactID`.

## Limiti

- CXone invia e legge le intestazioni solo su `INVITE` e sul relativo `2xx` finale, quindi
  nulla nel `BYE` dell'agente raggiunge il copione.
- NICE non documenta l'accettazione di un `REFER` dall'agente.
- L'azione REST API va in timeout dopo 10 secondi per impostazione predefinita (al massimo meno di 90)
  e legge risposte fino a 32 KB.
