---
title: "Savienošana no NICE CXone"
description: "Nosūtiet NICE CXone zvanus uz ThunderPhone balss aģentu no Studio skripta, izmantojot ContactID SIP galvenē, un sameklējiet aģenta pāradresēšanu, kad skripts turpinās."
---

Jūsu CXone Studio skripts veic zvanu balss aģentam ar SIP galvenēm, kurās ir
kontakta ID un jebkāds cits konteksts. Kad balss aģents ir pabeidzis darbu, tas noliek klausuli, un
REST API darbība skriptā iegūst nodošanas datus.

## Pirms darba sākšanas

- ThunderPhone aģents un organizācijas [API atslēga](/lv/guides/api-keys).
- CXone SIP maģistrāļu grupa, kas pieņem pielāgotas galvenes. Jūsu NICE konta
  pārstāvim šis iestatījums ir jāiespējo, pirms CXone tās nosūta.

## 1. Izveidojiet SIP galapunktu

Placecall zvana uz tālruņa numuru, izmantojot CXone maģistrāļu grupu, nevis uz SIP adresi.
NICE tam nedokumentē SIP akreditācijas datus, un cita MI nodrošinātāja CXone
integrācija izmanto TLS ar IP atļauju sarakstu. Tāpēc izveidojiet `ip_allowlist`
galapunktu ar numuru, uz kuru skripts zvanīs, kā ienākošo zvanu numuru (skatiet
[Platformas, kas zvana uz tālruņa numuru](/lv/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ūsu CXone klastera SIP signalizācijas diapazoni,
  ko nodrošina NICE. Katram jābūt publiskam IPv4 diapazonam `/16` vai šaurākam
  (IPv6 `/48` vai šaurākam).
- `dial_in_numbers`: numurs, uz kuru Placecall zvanīs, rakstīts tā, kā to
  nosūta CXone. Tam nav jābūt reālam tālruņa numuram. To nedrīkst jau izmantot
  ThunderPhone kā tālruņa numuru vai citā galapunktā: pretējā gadījumā tiek
  atgriezts `409`.

CXone adreses ir koplietotas visiem tā klientiem, tāpēc jebkurš cits CXone
klients, kas zvana uz šo numuru, sasniedz jūsu balss aģentu. Vietā, kur izvēlaties
numuru, izvēlieties garu numuru, ko neviens neuzminētu (līdz 15 cipariem), pārliecinieties,
ka CXone to nosūta uz ThunderPhone, nevis uz tālruņu tīklu, un
nepublicējiet to.

## 2. Sūtiet zvanus ar kontekstu

Savā Studio skriptā pirms **Placecall**:

1. Pievienojiet **Sipputheader** darbību ar galveni `X-Call-ID` un vērtību
   `ContactID`. CXone nesūta savu zvana ID galveni; ThunderPhone šo galveni saglabā
   kā zvana `external_call_id`.
2. Pievienojiet **Sipputheader** darbību katrai citai vērtībai, kas balss aģentam jāzina,
   piemēram, `X-Skill` ar vērtību `support`. Tā sasniedz uzvedni kā
   `{{sip_x_skill}}`. Sipputheader pieņem `User-to-User`, jebkuru `X-` galveni un
   lielāko daļu `P-` galveņu; NICE iesaka vērtības ar 256 vai mazāk rakstzīmēm.

Pēc tam veiciet **Placecall** uz šo numuru, izmantojot maģistrāļu grupu, kas to nosūta uz
`sip.thunderphone.com` ar numuru gan pieprasījuma URI, gan `To`
galvenē. Galapunkts pieņem TLS (ports 5061) vai TCP (ports 5060) un noraida
UDP, bet NICE nedokumentē maģistrāles transportu, tāpēc pārliecinieties, ka tas nav
UDP.

## 3. Saņemiet zvanu atpakaļ

CXone nolasa SIP galvenes tikai `INVITE` un tā gala atbildē, tāpēc
balss aģents atgriež zvanu: tas atvadās un noliek klausuli, un jūsu skripts atkal
pārņem zvanītāju. Pievienojiet šo pārsūtīšanas numuru (skatiet
[Pievienojiet pārsūtīšanas numuru](/lv/guides/contact-centers/overview)):

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

NICE nedokumentē, ka skripts turpinās pēc Placecall, kad veiktais
zvans beidzas. Citu MI nodrošinātāju CXone integrācijas tā vietā signalizē skriptam,
izmantojot CXone Signal API (`POST /interactions/{contactId}/signal`), pirms
tās noliek klausuli; ThunderPhone to neizsauc. Apstipriniet ar NICE, kā jūsu skripts
atkal pārņem zvanītāju, pēc tam iegūstiet nodošanas datus ar **REST API** darbību:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  kam seko `ContactID`.
- Galvene `Authorization: Bearer sk_live_…`.
- Nolasiet atbildes `handoff.summary` un `handoff.intent`, lai maršrutētu
  kontaktu.

Skatiet [Nodota zvana uzmeklēšana](/api-reference/calls#look-up-a-handed-off-call).

## Pārbaudiet

Piezvaniet uz numuru, kurā darbojas skripts, palūdziet aģentam savienot ar personu un pārbaudiet, vai
skripts turpinās un REST API darbība atgriež pāradresāciju. Ja zvans
nekad nenonāk līdz aģentam, pārbaudiet numuru, ko CXone nosūta, vai tā avota adrese
ir `allowed_source_cidrs` un vai zvans tika veikts, izmantojot TCP vai TLS. Pēc tam atveriet
zvanu ar `GET /v1/calls/{call_id}`: `sip_headers` jānorāda `x-call-id`, un
`external_call_id` jābūt vienādam ar `ContactID`.

## Ierobežojumi

- CXone nosūta un nolasa galvenes tikai `INVITE` un tā galīgajā `2xx`, tāpēc
  nekas no aģenta `BYE` nenonāk līdz skriptam.
- NICE nedokumentē `REFER` pieņemšanu no aģenta.
- REST API darbībai pēc noklusējuma iestājas taimauts pēc 10 sekundēm (ne vairāk kā 90 sekundēs)
  un tā nolasa atbildes līdz 32 KB.
