ThunderPhone v3 je dostupan.Postavite sve sami, već od 2 ¢/min.Pročitajte objavu

Contact centers

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 /16 ili uži (IPv6 /48 ili 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ća 409.

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:

  1. Dodajte radnju Sipputheader sa zaglavljem X-Call-ID i vrijednošću ContactID. CXone ne šalje vlastito zaglavlje ID-a poziva; ThunderPhone ovo zaglavlje pohranjuje kao external_call_id poziva.
  2. Dodajte radnju Sipputheader za svaku drugu vrijednost koju agent treba znati, kao što je X-Skill postavljen na support. U prompt stiže kao {{sip_x_skill}}. Sipputheader prihvaća User-to-User, bilo koje X- zaglavlje i većinu P- 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 slijedi ContactID.
  • Zaglavlje Authorization: Bearer sk_live_….
  • Pročitajte handoff.summary i handoff.intent iz 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 INVITE i njegovom završnom 2xx, pa ništa iz agentova BYE ne stiže do skripte.
  • NICE ne dokumentira prihvaćanje REFER zahtjeva 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.