Open in
Подключение из NICE CXone
Направляйте звонки NICE CXone агенту ThunderPhone из скрипта Studio, передавая ContactID в заголовке SIP, и находите передачу разговора агентом при продолжении скрипта.
Ваш сценарий CXone Studio совершает вызов агенту с SIP-заголовками, содержащими идентификатор контакта и любой другой контекст. Когда агент завершает вызов, действие REST API в сценарии получает данные передачи.
Перед началом работы
- Агент ThunderPhone и ключ API организации.
- Группа SIP-транков CXone, принимающая пользовательские заголовки. Ваш представитель NICE должен включить этот параметр, прежде чем CXone начнёт их отправлять.
1. Создайте SIP-конечную точку
Placecall набирает номер телефона через группу транков CXone, а не SIP-адрес.
NICE не документирует SIP-учётные данные для него, а интеграция CXone другого
поставщика ИИ использует TLS со списком разрешённых IP-адресов. Поэтому создайте
конечную точку ip_allowlist с номером, который будет набирать сценарий, в качестве
номера для входящих вызовов (см.
Платформы, набирающие номер телефона):
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:
- Добавьте действие Sipputheader с заголовком
X-Call-IDи значениемContactID. CXone не отправляет собственный заголовок идентификатора вызова; ThunderPhone сохраняет этот заголовок какexternal_call_idвызова. - Добавьте действие 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 и его окончательном ответе,
поэтому агент возвращает вызов: прощается и завершает вызов, а ваш сценарий
снова получает звонящего. Добавьте этот номер перевода (см.
Добавьте номер перевода):
{"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, чтобы направить контакт.
Проверьте
Позвоните на номер, который запускает сценарий, попросите агента соединить с человеком и убедитесь, что
сценарий продолжается, а действие 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 КБ.