Open in
Povezivanje iz NICE CXone
Usmjerite NICE CXone pozive glasovnom agentu ThunderPhone iz Studio skripte s ContactID-jem u SIP zaglavlju i dohvatite predaju agenta kada se skripta nastavi.
Vaša CXone Studio skripta upućuje poziv agentu sa SIP zaglavljima koja prenose ID kontakta i svaki drugi kontekst. Kada agent završi, prekida vezu, a radnja REST API-ja u skripti dohvaća predaju poziva.
Prije početka
- ThunderPhone agent i organizacijski API ključ.
- CXone SIP grupa trunkova koja prihvaća prilagođena zaglavlja. Vaš NICE predstavnik za račun mora uključiti ovu postavku prije nego što ih CXone pošalje.
1. Izradite SIP krajnju točku
Placecall bira telefonski broj putem CXone grupe trunkova, a ne SIP adresu.
NICE ne dokumentira SIP vjerodajnice za njega, a integracija CXone drugog
pružatelja AI usluga koristi TLS s popisom dopuštenih IP adresa. Stoga izradite
krajnju točku ip_allowlist s brojem koji će skripta birati kao brojem za
dolazne pozive (pogledajte
Platforme koje biraju telefonski broj):
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: rasponi SIP signalizacije vašeg CXone klastera koje daje NICE. Svaki mora biti javni IPv4 raspon/16ili uži (IPv6/48ili uži).dial_in_numbers: broj koji će Placecall birati, zapisan na način na koji ga CXone šalje. Ne mora biti stvarni telefonski broj. Ne smije već biti u upotrebi na ThunderPhoneu, kao telefonski broj ili na drugoj krajnjoj točki: to vraća409.
CXoneove adrese dijele svi njegovi korisnici, pa svaki drugi CXone korisnik koji bira broj dolazi do vašeg agenta. Tamo gdje odabirete broj, odaberite dug broj koji nitko ne bi pogodio (do 15 znamenki), provjerite šalje li ga CXone na ThunderPhone umjesto prema telefonskoj mreži i nemojte ga objavljivati.
2. Pošaljite pozive s kontekstom
U svojoj Studio skripti, prije Placecall:
- Dodajte radnju Sipputheader sa zaglavljem
X-Call-IDi vrijednošćuContactID. CXone ne šalje vlastito zaglavlje ID-a poziva; ThunderPhone ovo zaglavlje pohranjuje kaoexternal_call_idpoziva. - Dodajte radnju Sipputheader za svaku drugu vrijednost koju agent treba
znati, kao što je
X-Skillpostavljen nasupport. U prompt stiže kao{{sip_x_skill}}. Sipputheader prihvaćaUser-to-User, bilo kojeX-zaglavlje i većinuP-zaglavlja; NICE preporučuje vrijednosti od najviše 256 znakova.
Zatim izvršite Placecall na taj broj putem grupe trunkova koja ga šalje na
sip.thunderphone.com s brojem i u URI-ju zahtjeva i u zaglavlju To.
Krajnja točka prihvaća TLS (port 5061) ili TCP (port 5060), a odbija UDP, a
NICE ne dokumentira transport trunka, stoga provjerite da nije UDP.
3. Preuzmite poziv natrag
CXone čita SIP zaglavlja samo u INVITE zahtjevu i njegovom konačnom odgovoru,
stoga agent vraća poziv: pozdravi se i prekine vezu, a vaša skripta ponovno
preuzima pozivatelja. Dodajte ovaj broj za prijenos poziva (pogledajte
Dodajte broj za prijenos):
{"name": "NICE CXone", "action": "return"}NICE ne dokumentira nastavlja li se skripta nakon radnje Placecall kada
upućeni poziv završi. Integracije CXone drugih pružatelja AI usluga umjesto
toga signaliziraju skripti putem CXoneova Signal API-ja
(POST /interactions/{contactId}/signal) prije prekida veze; ThunderPhone ga
ne poziva. Potvrdite s NICE-om kako vaša skripta ponovno preuzima pozivatelja,
a zatim dohvatite predaju poziva radnjom REST API:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=nakon čega slijediContactID.- Zaglavlje
Authorization: Bearer sk_live_…. - Pročitajte
handoff.summaryihandoff.intentiz odgovora kako biste usmjerili kontakt.
Pogledajte Potražite predani poziv.
Testirajte
Nazovite broj koji pokreće skriptu, zatražite od agenta osobu i provjerite
nastavlja li se skripta te vraća li radnja REST API-ja preusmjeravanje. Ako poziv
nikad ne dođe do agenta, provjerite broj koji CXone šalje, nalazi li se njegova
izvorna adresa u allowed_source_cidrs i je li poziv stigao putem TCP-a ili TLS-a. Zatim otvorite
poziv pomoću GET /v1/calls/{call_id}: sip_headers treba navesti x-call-id, a
external_call_id treba biti jednak ContactID.
Ograničenja
- CXone šalje i čita zaglavlja samo na
INVITEi njegovom završnom2xx, pa ništa iz agentovaBYEne stiže do skripte. - NICE ne dokumentira prihvaćanje
REFERzahtjeva od agenta. - Radnja REST API-ja prema zadanim postavkama istječe nakon 10 sekundi (najviše manje od 90) i čita odgovore do 32 KB.