ThunderPhone v3 on julkaistu.Ota käyttöön itse – alkaen 2 ¢/min.Lue lisää julkistuksesta

Contact centers

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 /16 tai tarkempi (IPv6 /48 tai 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 palautetaan 409.

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:

  1. Sipputheader-toiminto otsakkeella X-Call-ID ja arvolla ContactID. CXone ei lähetä omaa puhelutunnusotsakettaan; ThunderPhone tallentaa tämän puhelun external_call_id-tunnuksena.
  2. Lisää Sipputheader-toiminto jokaiselle muulle arvolle, jonka agentin pitää tietää, esimerkiksi X-Skill arvolla support. Se välitetään kehotteeseen muodossa {{sip_x_skill}}. Sipputheader hyväksyy User-to-User-otsakkeen, kaikki X--otsakkeet ja useimmat P--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ään ContactID.
  • Otsake Authorization: Bearer sk_live_….
  • Lue vastauksesta handoff.summary ja handoff.intent kontaktin 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 lopullisessa 2xx-vastauksessa, joten mikään agentin BYE-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.