ThunderPhone v3 вече е тук.Започнете самостоятелно — от 2 цента/мин.Прочетете съобщението

Contact centers

Свързване от 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:

  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 към този номер през 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.