---
title: "Unganisha kutoka NICE CXone"
description: "Tuma simu za NICE CXone kwa ejenti wa ThunderPhone kutoka kwenye script ya Studio ukiwa na ContactID katika kichwa cha SIP, na utafute uhamisho wa ejenti script inapoendelea."
---

Script yako ya CXone Studio hupiga simu kwa ejenti ikiwa na vichwa vya SIP vinavyobeba kitambulisho cha kontakti na muktadha mwingine wowote. Ejenti inapomaliza, hukata simu, na kitendo cha REST API katika script huchukua urejeshaji.

## Kabla ya kuanza

- Ejenti wa ThunderPhone na [ufunguo wa API](/sw/guides/api-keys) wa shirika.
- Kundi la trunk la SIP la CXone linalokubali vichwa maalum. Mwakilishi wa akaunti yako ya NICE lazima awashe mpangilio huu kabla CXone haijavituma.

## 1. Unda kituo cha SIP

Placecall hupiga namba ya simu kupitia kundi la trunk la CXone, si anwani ya SIP.
NICE haiandiki kumbukumbu za vitambulisho vya SIP kwa ajili yake, na muunganisho wa CXone wa mtoa huduma mwingine wa AI hutumia TLS yenye orodha ya IP zinazoruhusiwa. Kwa hiyo, unda kituo cha `ip_allowlist` chenye namba ambayo script itapiga kama namba ya kupigia kuingia (tazama
[Majukwaa yanayopiga namba ya simu](/sw/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`: masafa ya uashiriaji wa SIP ya klasta yako ya CXone, kutoka NICE. Kila moja lazima liwe masafa ya umma ya IPv4 ya `/16` au finyu zaidi (IPv6 ya `/48` au finyu zaidi).
- `dial_in_numbers`: namba ambayo Placecall itapiga, iliyoandikwa jinsi CXone inavyoituma. Si lazima iwe namba halisi ya simu. Haiwezi kuwa tayari inatumika kwenye ThunderPhone, kama namba ya simu au kwenye kituo kingine: hilo hurejesha `409`.

Anwani za CXone zinashirikiwa na wateja wake wote, kwa hiyo mteja mwingine yeyote wa CXone anayepiga namba hiyo hufikia ejenti wako. Unapochagua namba, chagua ndefu ambayo hakuna mtu angekisia (hadi tarakimu 15), hakikisha CXone inaielekeza kwa ThunderPhone badala ya kuituma kwenye mtandao wa simu, na usiichapishe.

## 2. Tuma simu zenye muktadha

Katika script yako ya Studio, kabla ya **Placecall**:

1. Ongeza kitendo cha **Sipputheader** chenye kichwa `X-Call-ID` na thamani ya `ContactID`. CXone haitumi kichwa chake cha call-id; ThunderPhone huhifadhi hiki kama `external_call_id` ya simu.
2. Ongeza kitendo cha **Sipputheader** kwa kila thamani nyingine ambayo ejenti anapaswa kujua, kama vile `X-Skill` iliyowekwa kuwa `support`. Hufika kwenye prompt kama `{{sip_x_skill}}`. Sipputheader hukubali `User-to-User`, kichwa chochote cha `X-`, na vichwa vingi vya `P-`; NICE inapendekeza thamani za herufi 256 au chini yake.

Kisha **Placecall** kwenye namba hiyo, kupitia kundi la trunk linaloituma kwa
`sip.thunderphone.com` likiwa na namba katika URI ya ombi na kichwa cha `To`.
Kituo kinakubali TLS (port 5061) au TCP (port 5060) na hukataa UDP, na NICE haiandiki kumbukumbu za usafirishaji wa trunk, kwa hiyo hakikisha si UDP.

## 3. Rudisha simu

CXone husoma vichwa vya SIP kwenye `INVITE` pekee na jibu lake la mwisho, kwa hiyo ejenti hurudisha simu: huaga na kukata simu, kisha script yako humchukua mpigaji tena. Ongeza namba hii ya uhamisho (tazama
[Ongeza namba ya uhamisho](/sw/guides/contact-centers/overview)):

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

NICE haiandiki kumbukumbu kwamba script huendelea baada ya Placecall wakati simu iliyopigwa inapoisha. Muunganisho wa CXone wa watoa huduma wengine wa AI badala yake huashiria script kupitia Signal API ya CXone (`POST /interactions/{contactId}/signal`) kabla hawajakataa simu; ThunderPhone haiiti. Thibitisha na NICE jinsi script yako inavyomrudisha mpigaji, kisha chukua urejeshaji kwa kitendo cha **REST API**:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  ikifuatiwa na `ContactID`.
- Kichwa `Authorization: Bearer sk_live_…`.
- Soma `handoff.summary` na `handoff.intent` kutoka kwenye jibu ili kuelekeza kontakti.

Tazama [Tafuta simu iliyorejeshwa](/api-reference/calls#look-up-a-handed-off-call).

## Ijaribu

Piga nambari inayotumia script, muombe ejenti akuunganishe na mtu, kisha uthibitishe kuwa
script inaendelea na kitendo cha REST API kinarejesha uhamisho. Ikiwa simu
haimfikii ejenti kamwe, angalia nambari inayotumwa na CXone, kwamba anwani yake ya chanzo
imo katika `allowed_source_cidrs`, na kwamba simu ilikuja kupitia TCP au TLS. Kisha fungua
simu kwa `GET /v1/calls/{call_id}`: `sip_headers` inapaswa kuorodhesha `x-call-id`, na
`external_call_id` inapaswa kuwa sawa na `ContactID`.

## Vikomo

- CXone hutuma na kusoma vichwa kwenye `INVITE` na `2xx` yake ya mwisho pekee, hivyo
  hakuna chochote kwenye `BYE` ya ejenti kinachofika kwenye script.
- NICE haiandiki kuhusu kukubali `REFER` kutoka kwa ejenti.
- Kitendo cha REST API huisha muda baada ya sekunde 10 kwa chaguo-msingi (kiwango cha juu ni chini ya 90)
  na husoma majibu hadi 32 KB.
