Open in
Yhdistä NICE CXonesta
Ohjaa NICE CXone -puhelut ThunderPhone-agentille Studio-skriptistä ContactID:n avulla SIP-otsakkeessa ja hae agentin siirto, kun skripti jatkuu.
CXone Studio -skriptisi soittaa agentille SIP-otsakkeilla, jotka sisältävät kontaktin tunnuksen ja muun kontekstin. Kun agentti on valmis, se katkaisee puhelun, ja skriptin REST API -toiminto hakee siirron tiedot.
Ennen kuin aloitat
- ThunderPhone-agentti ja organisaation API-avain.
- CXone SIP-runkoryhmä, joka hyväksyy mukautetut otsakkeet. NICE-tilisi yhteyshenkilön on otettava tämä asetus käyttöön, ennen kuin CXone lähettää ne.
1. Luo SIP-päätepiste
Placecall soittaa puhelinnumeroon CXone-runkoryhmän kautta, ei SIP-osoitteeseen.
NICE ei dokumentoi sen SIP-käyttötietoja, ja toisen tekoälypalveluntarjoajan CXone-
integraatio käyttää TLS:ää IP-sallintaluettelon kanssa. Luo siksi ip_allowlist-
päätepiste numerolla, johon skripti soittaa, soittonumeroksi (katso
Alustat, jotka soittavat puhelinnumeroon):
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: CXone-klusterisi SIP-signalointialueet NICEltä. Jokaisen on oltava julkinen IPv4-alue, jonka etuliite on/16tai tarkempi (IPv6/48tai tarkempi).dial_in_numbers: numero, johon Placecall soittaa, kirjoitettuna siinä muodossa, jossa CXone lähettää sen. Sen ei tarvitse olla oikea puhelinnumero. Se ei voi olla jo käytössä ThunderPhonessa puhelinnumerona tai toisessa päätepisteessä: tällöin palautetaan409.
CXonen osoitteet ovat yhteisiä kaikille sen asiakkaille, joten kuka tahansa muu CXone-asiakas, joka soittaa numeroon, pääsee agentillesi. Kun valitset numeron, valitse pitkä numero, jota kukaan ei arvaisi (enintään 15 numeroa), varmista, että CXone lähettää sen ThunderPhoneen eikä puhelinverkkoon, äläkä julkaise sitä.
2. Lähetä puhelut kontekstin kanssa
Lisää Studio-skriptissäsi ennen Placecall-toimintoa:
- Sipputheader-toiminto otsakkeella
X-Call-IDja arvollaContactID. CXone ei lähetä omaa puhelutunnusotsakettaan; ThunderPhone tallentaa tämän puhelunexternal_call_id-tunnuksena. - Lisää Sipputheader-toiminto jokaiselle muulle arvolle, jonka agentin
pitää tietää, esimerkiksi
X-Skillarvollasupport. Se välitetään kehotteeseen muodossa{{sip_x_skill}}. Sipputheader hyväksyyUser-to-User-otsakkeen, kaikkiX--otsakkeet ja useimmatP--otsakkeet; NICE suosittelee enintään 256 merkin arvoja.
Tee sitten Placecall tähän numeroon runkoryhmän kautta, joka lähettää sen
osoitteeseen sip.thunderphone.com siten, että numero on sekä pyyntö-URI:ssa
että To-otsakkeessa. Päätepiste hyväksyy TLS:n (portti 5061) tai TCP:n
(portti 5060) ja hylkää UDP:n. NICE ei dokumentoi rungon siirtoprotokollaa,
joten varmista, ettei se ole UDP.
3. Palauta puhelu
CXone lukee SIP-otsakkeet vain INVITE-pyynnössä ja sen lopullisessa
vastauksessa, joten agentti palauttaa puhelun: se hyvästelee soittajan ja
katkaisee puhelun, minkä jälkeen skriptisi ottaa soittajan taas käsittelyyn.
Lisää tämä siirtonumero (katso
Lisää siirtonumero):
{"name": "NICE CXone", "action": "return"}NICE ei dokumentoi, että skripti jatkaa Placecall-toiminnon jälkeen, kun
soitettu puhelu päättyy. Muiden tekoälypalveluntarjoajien CXone-integraatiot
sen sijaan ilmoittavat skriptille CXonen Signal API:n kautta
(POST /interactions/{contactId}/signal) ennen kuin ne katkaisevat puhelun;
ThunderPhone ei kutsu sitä. Varmista NICEltä, miten skriptisi ottaa soittajan
takaisin käsittelyyn, ja hae sitten siirron tiedot REST API -toiminnolla:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=ja sen peräänContactID.- Otsake
Authorization: Bearer sk_live_…. - Lue vastauksesta
handoff.summaryjahandoff.intentkontaktin reitittämistä varten.
Katso Siirretyn puhelun haku.
Testaa
Soita numeroon, joka suorittaa skriptin, pyydä agentilta henkilöä ja tarkista,
että skripti jatkuu ja REST API -toiminto palauttaa siirron. Jos puhelu ei koskaan
saavuta agenttia, tarkista CXonen lähettämä numero, että sen lähdeosoite on
allowed_source_cidrs-asetuksessa ja että puhelu tuli TCP:n tai TLS:n kautta. Avaa sitten
puhelu komennolla GET /v1/calls/{call_id}: sip_headers-kentässä pitäisi näkyä x-call-id, ja
external_call_id-kentän pitäisi olla sama kuin ContactID.
Rajoitukset
- CXone lähettää ja lukee otsakkeita vain
INVITE-pyynnössä ja sen lopullisessa2xx-vastauksessa, joten mikään agentinBYE-pyynnössä ei saavuta skriptiä. - NICE ei dokumentoi agentilta tulevan
REFER-pyynnön hyväksymistä. - REST API -toiminto aikakatkaistaan oletusarvoisesti 10 sekunnin jälkeen (enintään alle 90 sekunnissa) ja se lukee vastauksia enintään 32 kilotavuun asti.