ThunderPhone v3 je zdaj na voljo.Začnite sami, že od 2 ¢/min.Preberite obvestilo

Contact centers

Povežite iz NICE CXone

Pošljite klice NICE CXone glasovnemu agentu ThunderPhone iz skripta Studio s ContactID v glavi SIP in poiščite predajo agenta, ko se skript nadaljuje.

Vaš skript CXone Studio vzpostavi klic z agentom prek glav SIP, ki prenašajo ID stika in drug kontekst. Ko agent konča, odloži slušalko, dejanje REST API v skriptu pa pridobi predajo.

Preden začnete

  • Agent ThunderPhone in ključ API organizacije.
  • Skupina SIP-trunkov CXone, ki sprejema glave po meri. Vaš skrbnik računa NICE mora to nastavitev vklopiti, preden jih CXone pošlje.

1. Ustvarite končno točko SIP

Placecall kliče telefonsko številko prek skupine trunkov CXone, ne naslova SIP. NICE ne dokumentira poverilnic SIP za to možnost, integracija CXone drugega ponudnika umetne inteligence pa uporablja TLS s seznamom dovoljenih naslovov IP. Zato ustvarite končno točko ip_allowlist s številko, ki jo bo skript klical, kot številko za dohodne klice (glejte Platforme, ki kličejo telefonsko številko):

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: obsegi signalizacije SIP vaše gruče CXone, ki jih zagotovi NICE. Vsak mora biti javni obseg IPv4 velikosti /16 ali ožji (IPv6 /48 ali ožji).
  • dial_in_numbers: številka, ki jo bo Placecall poklical, zapisana tako, kot jo pošlje CXone. Ni nujno, da je prava telefonska številka. Ne sme biti že v uporabi v ThunderPhone, niti kot telefonska številka niti na drugi končni točki: v tem primeru se vrne 409.

Naslove CXone uporabljajo vse njegove stranke, zato vsaka druga stranka CXone, ki pokliče to številko, doseže vašega agenta. Pri izbiri številke izberite dolgo številko, ki je nihče ne bi uganil (do 15 števk), poskrbite, da jo CXone pošlje v ThunderPhone namesto v telefonsko omrežje, in je ne objavljajte.

2. Pošljite klice s kontekstom

V svojem skriptu Studio pred Placecall:

  1. Dodajte dejanje Sipputheader z glavo X-Call-ID in vrednostjo ContactID. CXone ne pošlje lastne glave ID-ja klica; ThunderPhone to glavo shrani kot external_call_id klica.
  2. Dodajte dejanje Sipputheader za vsako drugo vrednost, ki jo mora agent poznati, na primer X-Skill, nastavljeno na support. V pozivu je na voljo kot {{sip_x_skill}}. Sipputheader sprejme User-to-User, katero koli glavo X- in večino glav P-; NICE priporoča vrednosti z največ 256 znaki.

Nato izvedite Placecall na to številko prek skupine trunkov, ki jo pošlje na sip.thunderphone.com s številko v URI-ju zahteve in glavi To. Končna točka sprejema TLS (vrata 5061) ali TCP (vrata 5060) in zavrača UDP, NICE pa ne dokumentira transporta trunka, zato preverite, da ne uporablja UDP.

3. Prevzemite klic nazaj

CXone bere glave SIP samo pri INVITE in njegovem končnem odgovoru, zato agent vrne klic: poslovi se in odloži slušalko, vaš skript pa znova prevzame klicatelja. Dodajte to številko za preusmeritev (glejte Dodajte številko za preusmeritev):

{"name": "NICE CXone", "action": "return"}

NICE ne dokumentira, da se skript po koncu vzpostavljenega klica nadaljuje po Placecall. Integracije CXone drugih ponudnikov umetne inteligence namesto tega signalizirajo skriptu prek API-ja Signal podjetja CXone (POST /interactions/{contactId}/signal), preden odložijo slušalko; ThunderPhone ga ne pokliče. Pri NICE potrdite, kako vaš skript znova prevzame klicatelja, nato pa predajo pridobite z dejanjem REST API:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= ki mu sledi ContactID.
  • Glava Authorization: Bearer sk_live_….
  • Iz odgovora preberite handoff.summary in handoff.intent, da usmerite stik.

Glejte Poiščite predani klic.

Preizkusite

Pokličite številko, na kateri se izvaja skript, agenta prosite za osebo in preverite, ali se skript nadaljuje ter ali dejanje REST API vrne predajo. Če klic nikoli ne doseže agenta, preverite številko, ki jo pošlje CXone, ali je njen izvorni naslov v allowed_source_cidrs in ali je klic prišel prek TCP ali TLS. Nato odprite klic z GET /v1/calls/{call_id}: sip_headers mora navesti x-call-id, vrednost external_call_id pa mora biti enaka ContactID.

Omejitve

  • CXone pošilja in bere glave samo pri INVITE in njegovem končnem odgovoru 2xx, zato nič iz agentovega BYE ne doseže skripta.
  • NICE ne dokumentira sprejemanja REFER od agenta.
  • Dejanje REST API privzeto poteče po 10 sekundah (največ v manj kot 90 sekundah) in prebere odgovore do 32 KB.