---
title: "Połącz z NICE CXone"
description: "Przekierowuj połączenia NICE CXone do agenta ThunderPhone ze skryptu Studio, umieszczając ContactID w nagłówku SIP, a następnie wyszukuj przekazanie agenta, gdy skrypt jest kontynuowany."
---

Skrypt CXone Studio wykonuje połączenie z agentem, używając nagłówków SIP zawierających
identyfikator kontaktu i wszelki inny kontekst. Gdy agent zakończy pracę, rozłącza się, a
akcja REST API w skrypcie pobiera przekazanie.

## Zanim zaczniesz

- Agent ThunderPhone i [klucz API](/pl/guides/api-keys) organizacji.
- Grupa łączy SIP CXone akceptująca niestandardowe nagłówki. Przed wysłaniem ich przez CXone
  przedstawiciel NICE obsługujący Twoje konto musi włączyć to ustawienie.

## 1. Utwórz punkt końcowy SIP

Placecall wybiera numer telefonu przez grupę łączy CXone, a nie adres SIP.
NICE nie dokumentuje dla niego poświadczeń SIP, a integracja CXone innego dostawcy AI
używa TLS z listą dozwolonych adresów IP. Utwórz więc punkt końcowy `ip_allowlist`
z numerem, który skrypt będzie wybierać, jako numerem do połączeń przychodzących (zobacz
[Platformy wybierające numer telefonu](/pl/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`: zakresy sygnalizacji SIP klastra CXone, otrzymane od NICE.
  Każdy musi być publicznym zakresem IPv4 `/16` lub węższym (IPv6 `/48` lub węższym).
- `dial_in_numbers`: numer, który wybierze Placecall, zapisany w formie,
  w jakiej wysyła go CXone. Nie musi być prawdziwym numerem telefonu. Nie może już
  być używany w ThunderPhone jako numer telefonu ani w innym punkcie końcowym: w takim
  przypadku zwracany jest kod `409`.

Adresy CXone są współdzielone przez wszystkich klientów, więc każdy inny klient CXone,
który wybierze ten numer, dotrze do Twojego agenta. Wybierając numer, użyj długiego,
którego nikt nie odgadnie (do 15 cyfr), upewnij się, że CXone wysyła go do ThunderPhone,
a nie do sieci telefonicznej, i nie publikuj go.

## 2. Wysyłaj połączenia z kontekstem

W skrypcie Studio, przed **Placecall**:

1. Dodaj akcję **Sipputheader** z nagłówkiem `X-Call-ID` i wartością
   `ContactID`. CXone nie wysyła własnego nagłówka call-id; ThunderPhone zapisuje
   ten nagłówek jako `external_call_id` połączenia.
2. Dodaj akcję **Sipputheader** dla każdej innej wartości, którą agent powinien znać,
   na przykład `X-Skill` ustawione na `support`. Trafia ona do promptu jako
   `{{sip_x_skill}}`. Sipputheader obsługuje `User-to-User`, dowolny nagłówek `X-`
   oraz większość nagłówków `P-`; NICE zaleca wartości liczące maksymalnie 256 znaków.

Następnie wykonaj **Placecall** na ten numer przez grupę łączy, która wysyła go do
`sip.thunderphone.com` z numerem zarówno w identyfikatorze URI żądania, jak i nagłówku `To`.
Punkt końcowy obsługuje TLS (port 5061) lub TCP (port 5060) i odrzuca UDP, a NICE nie
dokumentuje transportu łącza, więc upewnij się, że nie jest to UDP.

## 3. Odbierz połączenie z powrotem

CXone odczytuje nagłówki SIP tylko w `INVITE` i jego końcowej odpowiedzi, dlatego agent
zwraca połączenie: żegna się i rozłącza, a skrypt ponownie przejmuje rozmówcę. Dodaj ten
numer przekierowania (zobacz
[Dodaj numer przekierowania](/pl/guides/contact-centers/overview)):

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

NICE nie dokumentuje, że skrypt kontynuuje działanie po Placecall, gdy wykonane
połączenie się zakończy. Integracje CXone innych dostawców AI zamiast tego sygnalizują
skryptowi przez Signal API CXone (`POST /interactions/{contactId}/signal`), zanim się
rozłączą; ThunderPhone go nie wywołuje. Potwierdź z NICE, w jaki sposób Twój skrypt
ponownie przejmuje rozmówcę, a następnie pobierz przekazanie za pomocą akcji **REST API**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  po którym następuje `ContactID`.
- Nagłówek `Authorization: Bearer sk_live_…`.
- Odczytaj z odpowiedzi `handoff.summary` i `handoff.intent`, aby skierować
  kontakt.

Zobacz [Wyszukiwanie przekazanego połączenia](/api-reference/calls#look-up-a-handed-off-call).

## Przetestuj

Zadzwoń na numer uruchamiający skrypt, poproś agenta o osobę i sprawdź, czy
skrypt jest kontynuowany, a akcja interfejsu REST API zwraca przekazanie połączenia. Jeśli połączenie
nigdy nie dociera do agenta, sprawdź numer wysyłany przez CXone, czy jego adres
źródłowy znajduje się w `allowed_source_cidrs` oraz czy połączenie odbyło się przez TCP lub TLS. Następnie otwórz
połączenie za pomocą `GET /v1/calls/{call_id}`: `sip_headers` powinno zawierać `x-call-id`, a
`external_call_id` powinno być równe `ContactID`.

## Ograniczenia

- CXone wysyła i odczytuje nagłówki tylko w `INVITE` i jego końcowej odpowiedzi `2xx`, więc
  nic z `BYE` agenta nie dociera do skryptu.
- NICE nie dokumentuje obsługi `REFER` od agenta.
- Akcja interfejsu REST API domyślnie przekracza limit czasu po 10 sekundach (maksymalnie przed upływem 90 sekund)
  i odczytuje odpowiedzi o rozmiarze do 32 KB.
