---
title: "Prisijungimas iš NICE CXone"
description: "Nukreipkite NICE CXone skambučius į ThunderPhone agentą iš Studio scenarijaus, perduodami ContactID SIP antraštėje, ir suraskite agento perduotą skambutį, kai scenarijus tęsiamas."
---

Jūsų CXone Studio scenarijus skambina agentui su SIP antraštėmis, kuriose perduodamas
kontakto ID ir kitas kontekstas. Kai agentas baigia, jis padeda ragelį, o scenarijuje
esantis REST API veiksmas gauna perdavimą.

## Prieš pradėdami

- ThunderPhone agentas ir organizacijos [API raktas](/lt/guides/api-keys).
- CXone SIP magistralės grupė, priimanti pasirinktines antraštes. Jūsų NICE paskyros
  atstovas turi įjungti šį nustatymą, kad CXone jas siųstų.

## 1. Sukurkite SIP galinį tašką

Placecall skambina telefono numeriu per CXone magistralės grupę, o ne SIP adresu.
NICE nepateikia jo SIP prisijungimo duomenų dokumentacijos, o kito DI tiekėjo CXone
integracija naudoja TLS su IP leidžiamųjų sąrašu. Todėl sukurkite `ip_allowlist`
galinį tašką, nurodydami numerį, kuriuo scenarijus skambins, kaip įeinančio skambučio numerį (žr.
[Platformos, kurios skambina telefono numeriu](/lt/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`: jūsų CXone sankaupos SIP signalizavimo diapazonai,
  pateikti NICE. Kiekvienas turi būti viešasis `/16` arba siauresnis IPv4 diapazonas
  (IPv6 `/48` arba siauresnis).
- `dial_in_numbers`: numeris, kuriuo skambins Placecall, užrašytas taip, kaip jį
  siunčia CXone. Jis nebūtinai turi būti tikras telefono numeris. Jis negali būti
  jau naudojamas ThunderPhone kaip telefono numeris arba kitame galiniame taške:
  tokiu atveju grąžinamas `409`.

CXone adresais dalijasi visi jo klientai, todėl bet kuris kitas CXone klientas,
paskambinęs šiuo numeriu, pasieks jūsų agentą. Rinkdamiesi numerį, pasirinkite ilgą
numerį, kurio niekas neatspėtų (iki 15 skaitmenų), įsitikinkite, kad CXone siunčia jį
į ThunderPhone, o ne į telefono tinklą, ir jo neskelbkite.

## 2. Siųskite skambučius su kontekstu

Savo Studio scenarijuje prieš **Placecall**:

1. Pridėkite **Sipputheader** veiksmą su antrašte `X-Call-ID` ir reikšme
   `ContactID`. CXone nesiunčia savo skambučio ID antraštės; ThunderPhone saugo
   šią reikšmę kaip skambučio `external_call_id`.
2. Pridėkite **Sipputheader** veiksmą kiekvienai kitai reikšmei, kurią agentas turi
   žinoti, pavyzdžiui, `X-Skill`, kurios reikšmė yra `support`. Ji pasiekia raginimą kaip
   `{{sip_x_skill}}`. Sipputheader priima `User-to-User`, bet kurią `X-` antraštę ir
   daugumą `P-` antraščių; NICE rekomenduoja ne ilgesnes nei 256 simbolių reikšmes.

Tada atlikite **Placecall** į šį numerį per magistralės grupę, kuri jį siunčia į
`sip.thunderphone.com`, nurodydama numerį ir užklausos URI, ir `To`
antraštėje. Galinis taškas priima TLS (5061 prievadas) arba TCP (5060 prievadas) ir atmeta
UDP, o NICE nepateikia magistralės perdavimo protokolo dokumentacijos, todėl įsitikinkite,
kad tai nėra UDP.

## 3. Perimkite skambutį atgal

CXone nuskaito SIP antraštes tik iš `INVITE` ir jo galutinio atsako, todėl
agentas grąžina skambutį: jis atsisveikina ir padeda ragelį, o jūsų scenarijus vėl
perima skambintoją. Pridėkite šį perdavimo numerį (žr.
[Pridėkite perdavimo numerį](/lt/guides/contact-centers/overview)):

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

NICE nepateikia dokumentacijos, kad scenarijus tęsiamas po Placecall, kai inicijuotas
skambutis baigiasi. Kitų DI tiekėjų CXone integracijos prieš padėdamos ragelį
vietoje to signalizuoja scenarijui per CXone Signal API (`POST /interactions/{contactId}/signal`);
ThunderPhone jo nekviečia. Su NICE patvirtinkite, kaip jūsų scenarijus vėl perima
skambintoją, tada gaukite perdavimą naudodami **REST API** veiksmą:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  ir po jo `ContactID`.
- Antraštė `Authorization: Bearer sk_live_…`.
- Perskaitykite atsako `handoff.summary` ir `handoff.intent`, kad nukreiptumėte
  kontaktą.

Žr. [Perduoto skambučio paieška](/api-reference/calls#look-up-a-handed-off-call).

## Išbandykite

Paskambinkite numeriu, kuriame vykdomas scenarijus, paprašykite agento sujungti su asmeniu ir patikrinkite, ar
scenarijus tęsiamas ir REST API veiksmas grąžina perdavimą. Jei skambutis
niekada nepasiekia agento, patikrinkite CXone siunčiamą numerį, ar jo šaltinio adresas
yra `allowed_source_cidrs`, ir ar skambutis atėjo per TCP arba TLS. Tada atidarykite
skambutį naudodami `GET /v1/calls/{call_id}`: `sip_headers` turėtų nurodyti `x-call-id`, o
`external_call_id` turėtų sutapti su `ContactID`.

## Ribojimai

- CXone siunčia ir nuskaito antraštes tik `INVITE` ir jo galutiniame `2xx`, todėl
  niekas iš agento `BYE` nepasiekia scenarijaus.
- NICE nedokumentuoja, kad priima agento siunčiamą `REFER`.
- REST API veiksmo numatytasis laiko limitas yra 10 sekundžių (daugiausia iki 90)
  ir jis nuskaito atsakymus iki 32 KB.
