ThunderPhone v3 је сада доступан.Почните самостално, већ од 2 ¢/мин.Прочитајте објаву

Contact centers

Повезивање из 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:

  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 и његов коначни одговор, па агент враћа позив: поздравља се и прекида позив, а ваша скрипта поново преузима позиваоца. Додајте овај број за пренос (погледајте Додајте број за пренос):

{"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.