Open in
Повезивање из NICE CXone
Усмеравајте позиве из NICE CXone ка ThunderPhone агенту из Studio скрипте, са ContactID-ом у SIP заглављу, и потражите предају агента када се скрипта настави.
Ваша CXone Studio скрипта упућује позив агенту са SIP заглављима која садрже идентификатор контакта и сваки други контекст. Када агент заврши, прекида позив, а REST API радња у скрипти преузима предају.
Пре него што почнете
- ThunderPhone агент и API кључ организације.
- CXone SIP група транкова која прихвата прилагођена заглавља. Представник за ваш NICE налог мора да омогући ову поставку пре него што их CXone пошаље.
1. Креирајте SIP крајњу тачку
Placecall позива број телефона преко CXone групе транкова, а не 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 за тај број, преко групе транкова која га шаље
на sip.thunderphone.com са бројем и у URI захтева и у заглављу To.
Крајња тачка прихвата TLS (порт 5061) или TCP (порт 5060) и одбија UDP, а
NICE не документује транспорт транка, зато се уверите да није UDP.
3. Преузмите позив назад
CXone чита SIP заглавља само на INVITE и његов коначни одговор, па агент
враћа позив: поздравља се и прекида позив, а ваша скрипта поново преузима
позиваоца. Додајте овај број за пренос (погледајте
Додајте број за пренос):
{"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из одговора да бисте усмерили контакт.
Погледајте Потражите предати позив.
Тестирајте
Позовите број који покреће скрипту, затражите од агента особу и проверите да ли
се скрипта наставља и да ли 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.