---
title: "Повезивање из NICE CXone"
description: "Усмеравајте позиве из NICE CXone ка ThunderPhone агенту из Studio скрипте, са ContactID-ом у SIP заглављу, и потражите предају агента када се скрипта настави."
---

Ваша CXone Studio скрипта упућује позив агенту са SIP заглављима која садрже
идентификатор контакта и сваки други контекст. Када агент заврши, прекида позив, а
REST API радња у скрипти преузима предају.

## Пре него што почнете

- ThunderPhone агент и [API кључ](/sr/guides/api-keys) организације.
- CXone SIP група транкова која прихвата прилагођена заглавља. Представник за ваш
  NICE налог мора да омогући ову поставку пре него што их CXone пошаље.

## 1. Креирајте SIP крајњу тачку

Placecall позива број телефона преко CXone групе транкова, а не SIP адресу.
NICE не документује SIP акредитиве за њега, а CXone интеграција другог AI
добављача користи TLS са IP листом дозвољених адреса. Зато креирајте
`ip_allowlist` крајњу тачку са бројем који ће скрипта позвати као бројем за
позивање (погледајте
[Платформе које позивају број телефона](/sr/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`: SIP опсези сигнализације вашег CXone кластера,
  које добијате од NICE. Сваки мора бити јавни IPv4 опсег `/16` или ужи (IPv6
  `/48` или ужи).
- `dial_in_numbers`: број који ће Placecall позвати, написан онако како га
  CXone шаље. Не мора бити стварни број телефона. Не може већ бити у употреби
  на ThunderPhone, као број телефона или на другој крајњој тачки: тада се враћа
  `409`.

CXone адресе деле сви његови клијенти, па сваки други CXone клијент који
позове тај број стиже до вашег агента. Тамо где бирате број, изаберите дугачак
број који нико не би погодио (до 15 цифара), уверите се да га CXone шаље
ThunderPhone, а не у телефонску мрежу, и не објављујте га.

## 2. Шаљите позиве са контекстом

У вашој Studio скрипти, пре **Placecall**:

1. Додајте радњу **Sipputheader** са заглављем `X-Call-ID` и вредношћу
   `ContactID`. CXone не шаље сопствено заглавље идентификатора позива;
   ThunderPhone ово чува као `external_call_id` позива.
2. Додајте радњу **Sipputheader** за сваку другу вредност коју агент треба да
   зна, на пример `X-Skill` постављено на `support`. Она стиже у упит као
   `{{sip_x_skill}}`. Sipputheader прихвата `User-to-User`, свако `X-`
   заглавље и већину `P-` заглавља; NICE препоручује вредности од 256 знакова
   или мање.

Затим користите **Placecall** за тај број, преко групе транкова која га шаље
на `sip.thunderphone.com` са бројем и у URI захтева и у заглављу `To`.
Крајња тачка прихвата TLS (порт 5061) или TCP (порт 5060) и одбија UDP, а
NICE не документује транспорт транка, зато се уверите да није UDP.

## 3. Преузмите позив назад

CXone чита SIP заглавља само на `INVITE` и његов коначни одговор, па агент
враћа позив: поздравља се и прекида позив, а ваша скрипта поново преузима
позиваоца. Додајте овај број за пренос (погледајте
[Додајте број за пренос](/sr/guides/contact-centers/overview)):

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

NICE не документује да се скрипта наставља након Placecall када се упућени
позив заврши. CXone интеграције других AI добављача уместо тога сигнализирају
скрипти преко CXone Signal API-ја (`POST /interactions/{contactId}/signal`)
пре него што прекину позив; ThunderPhone га не позива. Потврдите са NICE како
ваша скрипта враћа позиваоца, а затим преузмите предају радњом **REST API**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  праћено са `ContactID`.
- Заглавље `Authorization: Bearer sk_live_…`.
- Прочитајте `handoff.summary` и `handoff.intent` из одговора да бисте
  усмерили контакт.

Погледајте [Потражите предати позив](/api-reference/calls#look-up-a-handed-off-call).

## Тестирајте

Позовите број који покреће скрипту, затражите од агента особу и проверите да ли
се скрипта наставља и да ли REST API радња враћа предају позива. Ако позив
никада не стигне до агента, проверите број који CXone шаље, да ли се његова
изворна адреса налази у `allowed_source_cidrs` и да ли је позив стигао преко TCP-а или TLS-а. Затим отворите
позив помоћу `GET /v1/calls/{call_id}`: `sip_headers` треба да садржи `x-call-id`, а
`external_call_id` треба да буде једнак са `ContactID`.

## Ограничења

- CXone шаље и чита заглавља само у `INVITE` захтеву и његовом коначном `2xx` одговору, тако да
  ништа из `BYE` поруке агента не стиже до скрипте.
- NICE не документује прихватање `REFER` захтева од агента.
- REST API радња подразумевано истиче након 10 секунди (највише 90)
  и чита одговоре до 32 KB.
