---
title: "Povežite iz NICE CXone"
description: "Pošljite klice NICE CXone glasovnemu agentu ThunderPhone iz skripta Studio s ContactID v glavi SIP in poiščite predajo agenta, ko se skript nadaljuje."
---

Vaš skript CXone Studio vzpostavi klic z agentom prek glav SIP, ki prenašajo ID stika in drug kontekst. Ko agent konča, odloži slušalko, dejanje REST API v skriptu pa pridobi predajo.

## Preden začnete

- Agent ThunderPhone in [ključ API](/sl/guides/api-keys) organizacije.
- Skupina SIP-trunkov CXone, ki sprejema glave po meri. Vaš skrbnik računa NICE mora to nastavitev vklopiti, preden jih CXone pošlje.

## 1. Ustvarite končno točko SIP

Placecall kliče telefonsko številko prek skupine trunkov CXone, ne naslova SIP.
NICE ne dokumentira poverilnic SIP za to možnost, integracija CXone drugega ponudnika umetne inteligence pa uporablja TLS s seznamom dovoljenih naslovov IP. Zato ustvarite končno točko `ip_allowlist` s številko, ki jo bo skript klical, kot številko za dohodne klice (glejte
[Platforme, ki kličejo telefonsko številko](/sl/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`: obsegi signalizacije SIP vaše gruče CXone, ki jih zagotovi NICE. Vsak mora biti javni obseg IPv4 velikosti `/16` ali ožji (IPv6 `/48` ali ožji).
- `dial_in_numbers`: številka, ki jo bo Placecall poklical, zapisana tako, kot jo pošlje CXone. Ni nujno, da je prava telefonska številka. Ne sme biti že v uporabi v ThunderPhone, niti kot telefonska številka niti na drugi končni točki: v tem primeru se vrne `409`.

Naslove CXone uporabljajo vse njegove stranke, zato vsaka druga stranka CXone, ki pokliče to številko, doseže vašega agenta. Pri izbiri številke izberite dolgo številko, ki je nihče ne bi uganil (do 15 števk), poskrbite, da jo CXone pošlje v ThunderPhone namesto v telefonsko omrežje, in je ne objavljajte.

## 2. Pošljite klice s kontekstom

V svojem skriptu Studio pred **Placecall**:

1. Dodajte dejanje **Sipputheader** z glavo `X-Call-ID` in vrednostjo `ContactID`. CXone ne pošlje lastne glave ID-ja klica; ThunderPhone to glavo shrani kot `external_call_id` klica.
2. Dodajte dejanje **Sipputheader** za vsako drugo vrednost, ki jo mora agent poznati, na primer `X-Skill`, nastavljeno na `support`. V pozivu je na voljo kot `{{sip_x_skill}}`. Sipputheader sprejme `User-to-User`, katero koli glavo `X-` in večino glav `P-`; NICE priporoča vrednosti z največ 256 znaki.

Nato izvedite **Placecall** na to številko prek skupine trunkov, ki jo pošlje na
`sip.thunderphone.com` s številko v URI-ju zahteve in glavi `To`. Končna točka sprejema TLS (vrata 5061) ali TCP (vrata 5060) in zavrača UDP, NICE pa ne dokumentira transporta trunka, zato preverite, da ne uporablja UDP.

## 3. Prevzemite klic nazaj

CXone bere glave SIP samo pri `INVITE` in njegovem končnem odgovoru, zato agent vrne klic: poslovi se in odloži slušalko, vaš skript pa znova prevzame klicatelja. Dodajte to številko za preusmeritev (glejte
[Dodajte številko za preusmeritev](/sl/guides/contact-centers/overview)):

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

NICE ne dokumentira, da se skript po koncu vzpostavljenega klica nadaljuje po Placecall. Integracije CXone drugih ponudnikov umetne inteligence namesto tega signalizirajo skriptu prek API-ja Signal podjetja CXone (`POST /interactions/{contactId}/signal`), preden odložijo slušalko; ThunderPhone ga ne pokliče. Pri NICE potrdite, kako vaš skript znova prevzame klicatelja, nato pa predajo pridobite z dejanjem **REST API**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  ki mu sledi `ContactID`.
- Glava `Authorization: Bearer sk_live_…`.
- Iz odgovora preberite `handoff.summary` in `handoff.intent`, da usmerite stik.

Glejte [Poiščite predani klic](/api-reference/calls#look-up-a-handed-off-call).

## Preizkusite

Pokličite številko, na kateri se izvaja skript, agenta prosite za osebo in preverite, ali se
skript nadaljuje ter ali dejanje REST API vrne predajo. Če klic
nikoli ne doseže agenta, preverite številko, ki jo pošlje CXone, ali je njen izvorni naslov
v `allowed_source_cidrs` in ali je klic prišel prek TCP ali TLS. Nato odprite
klic z `GET /v1/calls/{call_id}`: `sip_headers` mora navesti `x-call-id`, vrednost
`external_call_id` pa mora biti enaka `ContactID`.

## Omejitve

- CXone pošilja in bere glave samo pri `INVITE` in njegovem končnem odgovoru `2xx`, zato
  nič iz agentovega `BYE` ne doseže skripta.
- NICE ne dokumentira sprejemanja `REFER` od agenta.
- Dejanje REST API privzeto poteče po 10 sekundah (največ v manj kot 90 sekundah)
  in prebere odgovore do 32 KB.
