---
title: "NICE CXone-ൽ നിന്ന് കണക്റ്റ് ചെയ്യുക"
description: "Studio സ്ക്രിപ്റ്റിൽ നിന്ന് SIP ഹെഡറിലെ ContactID ഉപയോഗിച്ച് NICE CXone കോളുകൾ ThunderPhone ഏജന്റിലേക്ക് അയയ്ക്കുക, സ്ക്രിപ്റ്റ് തുടരുമ്പോൾ ഏജന്റിന്റെ ഹാൻഡ്-ഓഫ് കണ്ടെത്തുക."
---

നിങ്ങളുടെ CXone Studio സ്ക്രിപ്റ്റ് കോൺടാക്ട് IDയും മറ്റ് സന്ദർഭ വിവരങ്ങളും ഉൾക്കൊള്ളുന്ന SIP ഹെഡറുകളോടെ ഏജന്റിലേക്ക് ഒരു കോൾ അയയ്ക്കുന്നു. ഏജന്റ് പൂർത്തിയാകുമ്പോൾ, അത് കോൾ വിച്ഛേദിക്കുന്നു, തുടർന്ന് സ്ക്രിപ്റ്റിലെ ഒരു REST API പ്രവർത്തനം കൈമാറ്റ വിവരങ്ങൾ ലഭ്യമാക്കുന്നു.

## ആരംഭിക്കുന്നതിന് മുമ്പ്

- ഒരു ThunderPhone ഏജന്റും ഒരു ഓർഗനൈസേഷൻ [API കീ](/ml/guides/api-keys)യും.
- ഇഷ്ടാനുസൃത ഹെഡറുകൾ സ്വീകരിക്കുന്ന ഒരു CXone SIP ട്രങ്ക് ഗ്രൂപ്പ്. CXone അവ അയയ്ക്കുന്നതിന് മുമ്പ് നിങ്ങളുടെ NICE അക്കൗണ്ട് പ്രതിനിധി ഈ ക്രമീകരണം പ്രവർത്തനക്ഷമമാക്കണം.

## 1. SIP എൻഡ്‌പോയിന്റ് സൃഷ്ടിക്കുക

Placecall ഒരു SIP വിലാസത്തിലേക്കല്ല, CXone ട്രങ്ക് ഗ്രൂപ്പിലൂടെ ഒരു ഫോൺ നമ്പറിലേക്കാണ് ഡയൽ ചെയ്യുന്നത്.
NICE ഇതിനായുള്ള SIP ക്രെഡൻഷ്യലുകൾ രേഖപ്പെടുത്തുന്നില്ല, കൂടാതെ മറ്റൊരു AI ദാതാവിന്റെ CXone
ഇന്റഗ്രേഷൻ ഒരു IP അനുവദനപ്പട്ടികയോടെ TLS ഉപയോഗിക്കുന്നു. അതിനാൽ, സ്ക്രിപ്റ്റ് ഡയൽ ചെയ്യുന്ന നമ്പർ ഒരു ഡയൽ-ഇൻ നമ്പറായി ഉപയോഗിച്ച് ഒരു `ip_allowlist`
എൻഡ്‌പോയിന്റ് സൃഷ്ടിക്കുക ([ഒരു ഫോൺ നമ്പറിലേക്ക് ഡയൽ ചെയ്യുന്ന പ്ലാറ്റ്ഫോമുകൾ](/ml/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`: NICE-ൽ നിന്നുള്ള നിങ്ങളുടെ CXone ക്ലസ്റ്ററിന്റെ SIP സിഗ്നലിംഗ് ശ്രേണികൾ.
  ഓരോന്നും `/16` അല്ലെങ്കിൽ അതിലും ഇടുങ്ങിയ ഒരു പൊതു IPv4 ശ്രേണിയായിരിക്കണം (IPv6 `/48`
  അല്ലെങ്കിൽ അതിലും ഇടുങ്ങിയത്).
- `dial_in_numbers`: Placecall ഡയൽ ചെയ്യുന്ന നമ്പർ, CXone അയയ്ക്കുന്ന രീതിയിൽ
  എഴുതിയത്. ഇത് ഒരു യഥാർഥ ഫോൺ നമ്പറായിരിക്കണമെന്നില്ല. ഒരു ഫോൺ നമ്പറായോ മറ്റൊരു എൻഡ്‌പോയിന്റിലോ ഇത് ഇതിനകം
  ThunderPhone-ൽ ഉപയോഗത്തിലായിരിക്കരുത്: അങ്ങനെ ആണെങ്കിൽ `409` ലഭിക്കും.

CXone-ന്റെ വിലാസങ്ങൾ അതിന്റെ എല്ലാ ഉപഭോക്താക്കൾക്കും പങ്കിട്ടുള്ളതാണ്, അതിനാൽ നമ്പർ ഡയൽ ചെയ്യുന്ന മറ്റേതെങ്കിലും CXone
ഉപഭോക്താവും നിങ്ങളുടെ ഏജന്റിലേക്ക് എത്തും. നമ്പർ തിരഞ്ഞെടുക്കുമ്പോൾ,
ആരും ഊഹിക്കാത്ത ദൈർഘ്യമേറിയ ഒന്ന് തിരഞ്ഞെടുക്കുക (പരമാവധി 15 അക്കങ്ങൾ), അത്
ഫോൺ നെറ്റ്‌വർക്കിലേക്ക് പുറത്തേക്ക് അയയ്ക്കാതെ CXone ThunderPhone-ലേക്ക് അയയ്ക്കുന്നുവെന്ന് ഉറപ്പാക്കുക, കൂടാതെ
അത് പ്രസിദ്ധീകരിക്കരുത്.

## 2. സന്ദർഭ വിവരങ്ങളോടെ കോളുകൾ അയയ്ക്കുക

നിങ്ങളുടെ Studio സ്ക്രിപ്റ്റിൽ, **Placecall**-ന് മുമ്പ്:

1. `X-Call-ID` ഹെഡറും
   `ContactID`-യുടെ മൂല്യവും ഉപയോഗിച്ച് ഒരു **Sipputheader** പ്രവർത്തനം ചേർക്കുക. CXone സ്വന്തമായി കോൾ-ID ഹെഡർ അയയ്ക്കുന്നില്ല; ThunderPhone
   ഇതിനെ കോളിന്റെ `external_call_id` ആയി സംഭരിക്കുന്നു.
2. ഏജന്റ് അറിഞ്ഞിരിക്കേണ്ട മറ്റെല്ലാ മൂല്യങ്ങൾക്കും ഒരു **Sipputheader** പ്രവർത്തനം ചേർക്കുക,
   ഉദാഹരണത്തിന് `support` ആയി സജ്ജീകരിച്ച `X-Skill`. ഇത് prompt-ൽ
   `{{sip_x_skill}}` ആയി എത്തും. Sipputheader `User-to-User`, ഏത് `X-` ഹെഡറും,
   മിക്ക `P-` ഹെഡറുകളും സ്വീകരിക്കുന്നു; NICE 256 പ്രതീകങ്ങളോ അതിൽ കുറവോ ഉള്ള മൂല്യങ്ങൾ ശുപാർശ ചെയ്യുന്നു.

തുടർന്ന്, റിക്വസ്റ്റ് URIയിലും `To`
ഹെഡറിലും നമ്പർ ഉൾപ്പെടുത്തി, അതിനെ `sip.thunderphone.com`-ലേക്ക് അയയ്ക്കുന്ന ഒരു ട്രങ്ക് ഗ്രൂപ്പിലൂടെ ആ നമ്പറിലേക്ക് **Placecall** നടത്തുക. എൻഡ്‌പോയിന്റ് TLS (പോർട്ട് 5061) അല്ലെങ്കിൽ TCP (പോർട്ട് 5060) സ്വീകരിക്കുകയും
UDP നിരസിക്കുകയും ചെയ്യുന്നു; NICE ട്രങ്കിന്റെ ട്രാൻസ്‌പോർട്ട് രേഖപ്പെടുത്തുന്നില്ല, അതിനാൽ അത്
UDP അല്ലെന്ന് ഉറപ്പാക്കുക.

## 3. കോൾ തിരികെ നേടുക

CXone SIP ഹെഡറുകൾ `INVITE`-ലും അതിന്റെ അന്തിമ പ്രതികരണത്തിലും മാത്രമേ വായിക്കൂ, അതിനാൽ
ഏജന്റ് കോൾ മടക്കിനൽകുന്നു: അത് വിടപറഞ്ഞ് കോൾ വിച്ഛേദിക്കുന്നു, തുടർന്ന് നിങ്ങളുടെ സ്ക്രിപ്റ്റ്
കോൾ ചെയ്യുന്നയാളെ വീണ്ടും സ്വീകരിക്കുന്നു. ഈ കൈമാറ്റ നമ്പർ ചേർക്കുക (
[കൈമാറ്റ നമ്പർ ചേർക്കുക](/ml/guides/contact-centers/overview) കാണുക):

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

നൽകിയ കോൾ അവസാനിക്കുമ്പോൾ Placecall-ന് ശേഷം ഒരു സ്ക്രിപ്റ്റ് തുടരുന്നുവെന്ന് NICE രേഖപ്പെടുത്തുന്നില്ല.
മറ്റൊരു AI ദാതാവിന്റെ CXone ഇന്റഗ്രേഷനുകൾ, കോൾ വിച്ഛേദിക്കുന്നതിന് മുമ്പ്,
CXone-ന്റെ Signal API (`POST /interactions/{contactId}/signal`) വഴി സ്ക്രിപ്റ്റിലേക്ക് സിഗ്നൽ അയയ്ക്കുന്നു;
ThunderPhone അത് വിളിക്കുന്നില്ല. നിങ്ങളുടെ സ്ക്രിപ്റ്റ് കോൾ ചെയ്യുന്നയാളെ എങ്ങനെ തിരികെ സ്വീകരിക്കുന്നുവെന്ന് NICE-യുമായി സ്ഥിരീകരിക്കുക, തുടർന്ന് ഒരു **REST API** പ്രവർത്തനം ഉപയോഗിച്ച് കൈമാറ്റ വിവരങ്ങൾ ലഭ്യമാക്കുക:

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  എന്നതിനുശേഷം `ContactID`.
- ഹെഡർ `Authorization: Bearer sk_live_…`.
- കോൺടാക്ട് റൂട്ട് ചെയ്യാൻ പ്രതികരണത്തിൽ നിന്ന് `handoff.summary`, `handoff.intent` എന്നിവ വായിക്കുക.

[കൈമാറിയ കോൾ തിരയുക](/api-reference/calls#look-up-a-handed-off-call) കാണുക.

## പരീക്ഷിക്കുക

സ്ക്രിപ്റ്റ് പ്രവർത്തിക്കുന്ന ഒരു നമ്പറിലേക്ക് വിളിക്കുക, ഏജന്റിനോട് ഒരു വ്യക്തിയെ ചോദിക്കുക, തുടർന്ന്
സ്ക്രിപ്റ്റ് തുടരുന്നുണ്ടെന്നും REST API പ്രവർത്തനം ഹാൻഡ്-ഓഫ് തിരികെ നൽകുന്നുണ്ടെന്നും പരിശോധിക്കുക. കോൾ
ഒരിക്കലും ഏജന്റിലെത്തുന്നില്ലെങ്കിൽ, CXone അയയ്ക്കുന്ന നമ്പർ, അതിന്റെ ഉറവിട വിലാസം
`allowed_source_cidrs`-ൽ ഉണ്ടോ, കോൾ TCP അല്ലെങ്കിൽ TLS വഴിയാണോ വന്നത് എന്നിവ പരിശോധിക്കുക. തുടർന്ന്
`GET /v1/calls/{call_id}` ഉപയോഗിച്ച് കോൾ തുറക്കുക: `sip_headers`-ൽ `x-call-id` പട്ടികപ്പെടുത്തിയിരിക്കണം,
കൂടാതെ `external_call_id`, `ContactID`-ക്ക് തുല്യമായിരിക്കണം.

## പരിധികൾ

- CXone, `INVITE`-ലും അതിന്റെ അന്തിമ `2xx`-ലും മാത്രമാണ് ഹെഡറുകൾ അയയ്ക്കുകയും വായിക്കുകയും ചെയ്യുന്നത്, അതിനാൽ
  ഏജന്റിന്റെ `BYE`-ലുള്ളതൊന്നും സ്ക്രിപ്റ്റിലെത്തില്ല.
- ഏജന്റിൽ നിന്ന് ഒരു `REFER` സ്വീകരിക്കുന്നതിനെക്കുറിച്ച് NICE രേഖപ്പെടുത്തുന്നില്ല.
- REST API പ്രവർത്തനം ഡിഫോൾട്ടായി 10 സെക്കൻഡിന് ശേഷം ടൈംഔട്ട് ആകുന്നു (പരമാവധി 90-ൽ താഴെ)
  കൂടാതെ 32 KB വരെയുള്ള പ്രതികരണങ്ങൾ വായിക്കുന്നു.
