Open in
Свързване от NICE CXone
Изпращайте обаждания от NICE CXone към агент на ThunderPhone от Studio скрипт с ContactID в SIP заглавка и проверявайте прехвърлянето на агента, когато скриптът продължи.
Вашият CXone Studio скрипт осъществява обаждане към агента със SIP заглавки, които съдържат идентификатора на контакта и всякакъв друг контекст. Когато агентът приключи, той затваря разговора, а REST API действие в скрипта извлича прехвърлянето.
Преди да започнете
- ThunderPhone агент и API ключ за организация.
- CXone SIP trunk група, която приема персонализирани заглавки. Вашият представител на NICE трябва да активира тази настройка, преди CXone да ги изпраща.
1. Създайте SIP крайна точка
Placecall набира телефонен номер през CXone trunk група, а не SIP адрес.
NICE не документира SIP идентификационни данни за нея, а интеграцията с CXone на друг
доставчик на AI използва 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 към този номер през trunk група, която го изпраща към
sip.thunderphone.com с номера както в URI на заявката, така и в заглавката To.
Крайната точка приема TLS (порт 5061) или TCP (порт 5060) и отказва UDP, а NICE не
документира транспорта на trunk групата, затова се уверете, че не е UDP.
3. Получете обратно обаждането
CXone чете SIP заглавки само в INVITE и неговия окончателен отговор, затова
агентът връща обаждането: казва довиждане и затваря разговора, а вашият скрипт отново поема
обаждащия се. Добавете този номер за прехвърляне (вижте
Добавяне на номера за прехвърляне):
{"name": "NICE CXone", "action": "return"}NICE не документира, че скриптът продължава след Placecall, когато осъщественото
обаждане приключи. Вместо това интеграциите с CXone на други доставчици на AI сигнализират
на скрипта чрез 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 KB.