---
title: "Yhdistä NICE CXonesta"
description: "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](/fi/guides/api-keys).
- 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](/fi/guides/sip-addresses)):

```bash
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](/fi/guides/contact-centers/overview)):

```json
{"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](/api-reference/calls#look-up-a-handed-off-call).

## 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.
