---
title: "NICE CXoneમાંથી કનેક્ટ કરો"
description: "Studio સ્ક્રિપ્ટમાંથી SIP હેડરમાં ContactID સાથે NICE CXone કૉલને ThunderPhone એજન્ટને મોકલો અને સ્ક્રિપ્ટ આગળ ચાલુ રહે ત્યારે એજન્ટનું હેન્ડ-ઓફ શોધો."
---

તમારી CXone Studio સ્ક્રિપ્ટ SIP હેડર્સ સાથે એજન્ટને કૉલ કરે છે, જેમાં સંપર્ક id અને અન્ય કોઈપણ સંદર્ભ હોય છે. એજન્ટનું કામ પૂર્ણ થાય ત્યારે તે કૉલ બંધ કરે છે અને સ્ક્રિપ્ટમાં રહેલી REST API ક્રિયા હેન્ડ-ઓફ મેળવે છે.

## શરૂ કરતાં પહેલાં

- ThunderPhone એજન્ટ અને સંસ્થા [API કી](/gu/guides/api-keys).
- કસ્ટમ હેડર્સ સ્વીકારતું CXone SIP ટ્રંક ગ્રુપ. CXone તેમને મોકલે તે પહેલાં તમારા NICE એકાઉન્ટ પ્રતિનિધિએ આ સેટિંગ ચાલુ કરવું જરૂરી છે.

## 1. SIP એન્ડપૉઇન્ટ બનાવો

Placecall SIP સરનામા પર નહીં, પરંતુ CXone ટ્રંક ગ્રુપ મારફતે ફોન નંબર ડાયલ કરે છે.
NICE તેના માટે SIP ઓળખપત્રો દસ્તાવેજિત કરતું નથી, અને અન્ય AI પ્રદાતાના CXone
ઇન્ટિગ્રેશનમાં IP મંજૂર-યાદી સાથે TLS વપરાય છે. તેથી સ્ક્રિપ્ટ જે નંબર ડાયલ કરશે તેને ડાયલ-ઇન નંબર તરીકે રાખીને `ip_allowlist`
એન્ડપૉઇન્ટ બનાવો (જુઓ
[ફોન નંબર ડાયલ કરતા પ્લેટફૉર્મ્સ](/gu/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 અક્ષરો અથવા ઓછાં મૂલ્યોની ભલામણ કરે છે.

પછી, તે નંબર પર **Placecall** કરો, એવા ટ્રંક ગ્રુપ મારફતે જે તેને
નંબર સાથે વિનંતી URI અને `To` હેડર બંનેમાં `sip.thunderphone.com` પર મોકલે.
એન્ડપૉઇન્ટ TLS (પોર્ટ 5061) અથવા TCP (પોર્ટ 5060) સ્વીકારે છે અને
UDP નકારે છે, તથા NICE ટ્રંકનું પરિવહન દસ્તાવેજિત કરતું નથી, તેથી ખાતરી કરો કે તે
UDP નથી.

## 3. કૉલ પાછો મેળવો

CXone SIP હેડર્સ માત્ર `INVITE` અને તેના અંતિમ પ્રતિભાવમાં વાંચે છે, તેથી
એજન્ટ કૉલ પરત કરે છે: તે વિદાય કહે છે અને કૉલ બંધ કરે છે, અને તમારી સ્ક્રિપ્ટ
કૉલરને ફરીથી સંભાળે છે. આ ટ્રાન્સફર નંબર ઉમેરો (જુઓ
[ટ્રાન્સફર નંબર ઉમેરો](/gu/guides/contact-centers/overview)):

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

NICE એ દસ્તાવેજિત કરતું નથી કે Placecall દ્વારા કરાયેલ કૉલ પૂરો થાય ત્યારે સ્ક્રિપ્ટ ચાલુ રહે છે.
અન્ય 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` પરનું કંઈપણ સ્ક્રિપ્ટ સુધી પહોંચતું નથી.
- NICE એજન્ટ તરફથી `REFER` સ્વીકારવાનું દસ્તાવેજીકરણ કરતું નથી.
- REST API ક્રિયા ડિફૉલ્ટરૂપે 10 સેકન્ડ પછી સમયસમાપ્ત થાય છે (વધુમાં વધુ 90 હેઠળ)
  અને 32 KB સુધીના પ્રતિસાદ વાંચે છે.
