---
title: "Подключение из NICE CXone"
description: "Направляйте звонки NICE CXone агенту ThunderPhone из скрипта Studio, передавая ContactID в заголовке SIP, и находите передачу разговора агентом при продолжении скрипта."
---

Ваш сценарий CXone Studio совершает вызов агенту с SIP-заголовками, содержащими
идентификатор контакта и любой другой контекст. Когда агент завершает вызов,
действие REST API в сценарии получает данные передачи.

## Перед началом работы

- Агент ThunderPhone и [ключ API](/ru/guides/api-keys) организации.
- Группа SIP-транков CXone, принимающая пользовательские заголовки. Ваш
  представитель NICE должен включить этот параметр, прежде чем CXone начнёт их отправлять.

## 1. Создайте SIP-конечную точку

Placecall набирает номер телефона через группу транков CXone, а не SIP-адрес.
NICE не документирует SIP-учётные данные для него, а интеграция CXone другого
поставщика ИИ использует TLS со списком разрешённых IP-адресов. Поэтому создайте
конечную точку `ip_allowlist` с номером, который будет набирать сценарий, в качестве
номера для входящих вызовов (см.
[Платформы, набирающие номер телефона](/ru/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` и его окончательном ответе,
поэтому агент возвращает вызов: прощается и завершает вызов, а ваш сценарий
снова получает звонящего. Добавьте этот номер перевода (см.
[Добавьте номер перевода](/ru/guides/contact-centers/overview)):

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

NICE не документирует, что сценарий продолжается после Placecall, когда
завершается совершённый вызов. Вместо этого интеграции CXone других поставщиков
ИИ перед завершением вызова отправляют сигнал сценарию через Signal API CXone
(`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 КБ.
