Open in
Pripojenie z NICE CXone
Odosielajte hovory z NICE CXone hlasovému agentovi ThunderPhone zo skriptu Studio s ContactID v hlavičke SIP a pri pokračovaní skriptu vyhľadajte odovzdanie agentom.
Váš skript CXone Studio uskutoční hovor s hlasovým agentom pomocou hlavičiek SIP, ktoré prenášajú ID kontaktu a ďalší kontext. Keď hlasový agent skončí, zavesí hovor a akcia REST API v skripte načíta odovzdanie.
Skôr než začnete
- Hlasový agent ThunderPhone a kľúč API organizácie.
- Skupina trunkov SIP CXone, ktorá prijíma vlastné hlavičky. Váš zástupca účtu NICE musí toto nastavenie zapnúť, aby ich CXone odosielal.
1. Vytvorte koncový bod SIP
Placecall vytáča telefónne číslo prostredníctvom skupiny trunkov CXone, nie adresu SIP.
NICE preň nedokumentuje prihlasovacie údaje SIP a integrácia CXone iného poskytovateľa AI používa TLS so zoznamom povolených IP adries. Preto vytvorte koncový bod ip_allowlist s číslom, ktoré bude skript vytáčať, ako číslom pre prichádzajúce hovory (pozrite si
Platformy, ktoré vytáčajú telefónne číslo):
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: rozsahy signalizácie SIP vášho klastra CXone od NICE. Každý musí byť verejný rozsah IPv4 s maskou/16alebo užšou (IPv6/48alebo užšou).dial_in_numbers: číslo, ktoré bude Placecall vytáčať, zapísané spôsobom, akým ho CXone odosiela. Nemusí to byť skutočné telefónne číslo. Nesmie sa už používať v ThunderPhone ako telefónne číslo ani na inom koncovom bode: v takom prípade sa vráti409.
Adresy CXone zdieľajú všetci jeho zákazníci, takže každý iný zákazník CXone, ktorý vytočí toto číslo, sa spojí s vaším hlasovým agentom. Pri výbere čísla zvoľte dlhé číslo, ktoré nikto neuhádne (maximálne 15 číslic), uistite sa, že ho CXone odošle do ThunderPhone namiesto do telefónnej siete, a nezverejňujte ho.
2. Odosielajte hovory s kontextom
Vo svojom skripte Studio pred Placecall:
- Pridajte akciu Sipputheader s hlavičkou
X-Call-IDa hodnotouContactID. CXone neodosiela vlastnú hlavičku ID hovoru; ThunderPhone túto hlavičku uloží akoexternal_call_idhovoru. - Pridajte akciu Sipputheader pre každú ďalšiu hodnotu, ktorú má hlasový agent poznať, napríklad
X-Skillnastavenú nasupport. Do výzvy sa dostane ako{{sip_x_skill}}. Sipputheader prijímaUser-to-User, ľubovoľnú hlavičkuX-a väčšinu hlavičiekP-; NICE odporúča hodnoty s dĺžkou 256 znakov alebo menej.
Potom použite Placecall na toto číslo prostredníctvom skupiny trunkov, ktorá ho odosiela na
sip.thunderphone.com s číslom v identifikátore URI požiadavky aj v hlavičke To. Koncový bod prijíma TLS (port 5061) alebo TCP (port 5060) a odmieta UDP; NICE nepopisuje transport trunku, preto sa uistite, že nejde o UDP.
3. Prevezmite hovor späť
CXone číta hlavičky SIP iba pri INVITE a jeho konečnej odpovedi, preto hlasový agent vráti hovor: rozlúči sa a zavesí a váš skript opäť prevezme volajúceho. Pridajte toto číslo presmerovania (pozrite si
Pridanie čísla presmerovania):
{"name": "NICE CXone", "action": "return"}NICE nedokumentuje, že skript po skončení uskutočneného hovoru pokračuje po Placecall. Integrácie CXone iných poskytovateľov AI namiesto toho signalizujú skriptu prostredníctvom rozhrania Signal API CXone (POST /interactions/{contactId}/signal) pred zavesením; ThunderPhone ho nevolá. Overte si v NICE, ako váš skript prevezme volajúceho späť, a potom načítajte odovzdanie pomocou akcie REST API:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=nasledované hodnotouContactID.- Hlavička
Authorization: Bearer sk_live_…. - Z odpovede načítajte
handoff.summaryahandoff.intent, aby ste kontakt nasmerovali.
Pozrite si Vyhľadanie odovzdaného hovoru.
Otestujte to
Zavolajte na číslo, na ktorom beží skript, požiadajte agenta o osobu a overte,
že skript pokračuje a akcia REST API vráti odovzdanie hovoru. Ak hovor nikdy
nedosiahne agenta, skontrolujte číslo, ktoré CXone odosiela, či je jeho zdrojová adresa
v allowed_source_cidrs a či hovor prišiel cez TCP alebo TLS. Potom otvorte
hovor pomocou GET /v1/calls/{call_id}: sip_headers by mali obsahovať x-call-id
a external_call_id by sa malo rovnať ContactID.
Obmedzenia
- CXone odosiela a číta hlavičky iba pri
INVITEa jeho konečnej odpovedi2xx, takže nič zBYEagenta nedosiahne skript. - NICE nedokumentuje prijatie požiadavky
REFERod agenta. - Akcia REST API predvolene vyprší po 10 sekundách (maximálne do 90 sekúnd) a číta odpovede do veľkosti 32 KB.