---
title: "Povezivanje iz NICE CXone"
description: "Usmjerite NICE CXone pozive glasovnom agentu ThunderPhone iz Studio skripte s ContactID-jem u SIP zaglavlju i dohvatite predaju agenta kada se skripta nastavi."
---

Vaša CXone Studio skripta upućuje poziv agentu sa SIP zaglavljima koja prenose
ID kontakta i svaki drugi kontekst. Kada agent završi, prekida vezu, a radnja
REST API-ja u skripti dohvaća predaju poziva.

## Prije početka

- ThunderPhone agent i organizacijski [API ključ](/hr/guides/api-keys).
- CXone SIP grupa trunkova koja prihvaća prilagođena zaglavlja. Vaš NICE
  predstavnik za račun mora uključiti ovu postavku prije nego što ih CXone pošalje.

## 1. Izradite SIP krajnju točku

Placecall bira telefonski broj putem CXone grupe trunkova, a ne SIP adresu.
NICE ne dokumentira SIP vjerodajnice za njega, a integracija CXone drugog
pružatelja AI usluga koristi TLS s popisom dopuštenih IP adresa. Stoga izradite
krajnju točku `ip_allowlist` s brojem koji će skripta birati kao brojem za
dolazne pozive (pogledajte
[Platforme koje biraju telefonski broj](/hr/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`: rasponi SIP signalizacije vašeg CXone klastera koje
  daje NICE. Svaki mora biti javni IPv4 raspon `/16` ili uži (IPv6 `/48` ili
  uži).
- `dial_in_numbers`: broj koji će Placecall birati, zapisan na način na koji ga
  CXone šalje. Ne mora biti stvarni telefonski broj. Ne smije već biti u
  upotrebi na ThunderPhoneu, kao telefonski broj ili na drugoj krajnjoj točki:
  to vraća `409`.

CXoneove adrese dijele svi njegovi korisnici, pa svaki drugi CXone korisnik
koji bira broj dolazi do vašeg agenta. Tamo gdje odabirete broj, odaberite dug
broj koji nitko ne bi pogodio (do 15 znamenki), provjerite šalje li ga CXone na
ThunderPhone umjesto prema telefonskoj mreži i nemojte ga objavljivati.

## 2. Pošaljite pozive s kontekstom

U svojoj Studio skripti, prije **Placecall**:

1. Dodajte radnju **Sipputheader** sa zaglavljem `X-Call-ID` i vrijednošću
   `ContactID`. CXone ne šalje vlastito zaglavlje ID-a poziva; ThunderPhone ovo
   zaglavlje pohranjuje kao `external_call_id` poziva.
2. Dodajte radnju **Sipputheader** za svaku drugu vrijednost koju agent treba
   znati, kao što je `X-Skill` postavljen na `support`. U prompt stiže kao
   `{{sip_x_skill}}`. Sipputheader prihvaća `User-to-User`, bilo koje `X-`
   zaglavlje i većinu `P-` zaglavlja; NICE preporučuje vrijednosti od najviše
   256 znakova.

Zatim izvršite **Placecall** na taj broj putem grupe trunkova koja ga šalje na
`sip.thunderphone.com` s brojem i u URI-ju zahtjeva i u zaglavlju `To`.
Krajnja točka prihvaća TLS (port 5061) ili TCP (port 5060), a odbija UDP, a
NICE ne dokumentira transport trunka, stoga provjerite da nije UDP.

## 3. Preuzmite poziv natrag

CXone čita SIP zaglavlja samo u `INVITE` zahtjevu i njegovom konačnom odgovoru,
stoga agent vraća poziv: pozdravi se i prekine vezu, a vaša skripta ponovno
preuzima pozivatelja. Dodajte ovaj broj za prijenos poziva (pogledajte
[Dodajte broj za prijenos](/hr/guides/contact-centers/overview)):

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

NICE ne dokumentira nastavlja li se skripta nakon radnje Placecall kada
upućeni poziv završi. Integracije CXone drugih pružatelja AI usluga umjesto
toga signaliziraju skripti putem CXoneova Signal API-ja
(`POST /interactions/{contactId}/signal`) prije prekida veze; ThunderPhone ga
ne poziva. Potvrdite s NICE-om kako vaša skripta ponovno preuzima pozivatelja,
a zatim dohvatite predaju poziva radnjom **REST API**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  nakon čega slijedi `ContactID`.
- Zaglavlje `Authorization: Bearer sk_live_…`.
- Pročitajte `handoff.summary` i `handoff.intent` iz odgovora kako biste
  usmjerili kontakt.

Pogledajte [Potražite predani poziv](/api-reference/calls#look-up-a-handed-off-call).

## Testirajte

Nazovite broj koji pokreće skriptu, zatražite od agenta osobu i provjerite
nastavlja li se skripta te vraća li radnja REST API-ja preusmjeravanje. Ako poziv
nikad ne dođe do agenta, provjerite broj koji CXone šalje, nalazi li se njegova
izvorna adresa u `allowed_source_cidrs` i je li poziv stigao putem TCP-a ili TLS-a. Zatim otvorite
poziv pomoću `GET /v1/calls/{call_id}`: `sip_headers` treba navesti `x-call-id`, a
`external_call_id` treba biti jednak `ContactID`.

## Ograničenja

- CXone šalje i čita zaglavlja samo na `INVITE` i njegovom završnom `2xx`, pa
  ništa iz agentova `BYE` ne stiže do skripte.
- NICE ne dokumentira prihvaćanje `REFER` zahtjeva od agenta.
- Radnja REST API-ja prema zadanim postavkama istječe nakon 10 sekundi (najviše manje od 90)
  i čita odgovore do 32 KB.
