---
title: "Pripojenie z NICE CXone"
description: "Odosielajte hovory z NICE CXone hlasovému agentovi ThunderPhone zo skriptu Studio s ContactID v hlavičke SIP a pri pokračovaní skriptu vyhľadajte odovzdanie agentom."
---

Váš skript CXone Studio uskutoční hovor s hlasovým agentom pomocou hlavičiek SIP, ktoré prenášajú ID kontaktu a ďalší kontext. Keď hlasový agent skončí, zavesí hovor a akcia REST API v skripte načíta odovzdanie.

## Skôr než začnete

- Hlasový agent ThunderPhone a [kľúč API](/sk/guides/api-keys) organizácie.
- Skupina trunkov SIP CXone, ktorá prijíma vlastné hlavičky. Váš zástupca účtu NICE musí toto nastavenie zapnúť, aby ich CXone odosielal.

## 1. Vytvorte koncový bod SIP

Placecall vytáča telefónne číslo prostredníctvom skupiny trunkov CXone, nie adresu SIP.
NICE preň nedokumentuje prihlasovacie údaje SIP a integrácia CXone iného poskytovateľa AI používa TLS so zoznamom povolených IP adries. Preto vytvorte koncový bod `ip_allowlist` s číslom, ktoré bude skript vytáčať, ako číslom pre prichádzajúce hovory (pozrite si
[Platformy, ktoré vytáčajú telefónne číslo](/sk/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`: rozsahy signalizácie SIP vášho klastra CXone od NICE. Každý musí byť verejný rozsah IPv4 s maskou `/16` alebo užšou (IPv6 `/48` alebo užšou).
- `dial_in_numbers`: číslo, ktoré bude Placecall vytáčať, zapísané spôsobom, akým ho CXone odosiela. Nemusí to byť skutočné telefónne číslo. Nesmie sa už používať v ThunderPhone ako telefónne číslo ani na inom koncovom bode: v takom prípade sa vráti `409`.

Adresy CXone zdieľajú všetci jeho zákazníci, takže každý iný zákazník CXone, ktorý vytočí toto číslo, sa spojí s vaším hlasovým agentom. Pri výbere čísla zvoľte dlhé číslo, ktoré nikto neuhádne (maximálne 15 číslic), uistite sa, že ho CXone odošle do ThunderPhone namiesto do telefónnej siete, a nezverejňujte ho.

## 2. Odosielajte hovory s kontextom

Vo svojom skripte Studio pred **Placecall**:

1. Pridajte akciu **Sipputheader** s hlavičkou `X-Call-ID` a hodnotou `ContactID`. CXone neodosiela vlastnú hlavičku ID hovoru; ThunderPhone túto hlavičku uloží ako `external_call_id` hovoru.
2. Pridajte akciu **Sipputheader** pre každú ďalšiu hodnotu, ktorú má hlasový agent poznať, napríklad `X-Skill` nastavenú na `support`. Do výzvy sa dostane ako `{{sip_x_skill}}`. Sipputheader prijíma `User-to-User`, ľubovoľnú hlavičku `X-` a väčšinu hlavičiek `P-`; NICE odporúča hodnoty s dĺžkou 256 znakov alebo menej.

Potom použite **Placecall** na toto číslo prostredníctvom skupiny trunkov, ktorá ho odosiela na
`sip.thunderphone.com` s číslom v identifikátore URI požiadavky aj v hlavičke `To`. Koncový bod prijíma TLS (port 5061) alebo TCP (port 5060) a odmieta UDP; NICE nepopisuje transport trunku, preto sa uistite, že nejde o UDP.

## 3. Prevezmite hovor späť

CXone číta hlavičky SIP iba pri `INVITE` a jeho konečnej odpovedi, preto hlasový agent vráti hovor: rozlúči sa a zavesí a váš skript opäť prevezme volajúceho. Pridajte toto číslo presmerovania (pozrite si
[Pridanie čísla presmerovania](/sk/guides/contact-centers/overview)):

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

NICE nedokumentuje, že skript po skončení uskutočneného hovoru pokračuje po Placecall. Integrácie CXone iných poskytovateľov AI namiesto toho signalizujú skriptu prostredníctvom rozhrania Signal API CXone (`POST /interactions/{contactId}/signal`) pred zavesením; ThunderPhone ho nevolá. Overte si v NICE, ako váš skript prevezme volajúceho späť, a potom načítajte odovzdanie pomocou akcie **REST API**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  nasledované hodnotou `ContactID`.
- Hlavička `Authorization: Bearer sk_live_…`.
- Z odpovede načítajte `handoff.summary` a `handoff.intent`, aby ste kontakt nasmerovali.

Pozrite si [Vyhľadanie odovzdaného hovoru](/api-reference/calls#look-up-a-handed-off-call).

## Otestujte to

Zavolajte na číslo, na ktorom beží skript, požiadajte agenta o osobu a overte,
že skript pokračuje a akcia REST API vráti odovzdanie hovoru. Ak hovor nikdy
nedosiahne agenta, skontrolujte číslo, ktoré CXone odosiela, či je jeho zdrojová adresa
v `allowed_source_cidrs` a či hovor prišiel cez TCP alebo TLS. Potom otvorte
hovor pomocou `GET /v1/calls/{call_id}`: `sip_headers` by mali obsahovať `x-call-id`
a `external_call_id` by sa malo rovnať `ContactID`.

## Obmedzenia

- CXone odosiela a číta hlavičky iba pri `INVITE` a jeho konečnej odpovedi `2xx`, takže
  nič z `BYE` agenta nedosiahne skript.
- NICE nedokumentuje prijatie požiadavky `REFER` od agenta.
- Akcia REST API predvolene vyprší po 10 sekundách (maximálne do 90 sekúnd)
  a číta odpovede do veľkosti 32 KB.
