Open in
NICE CXoneમાંથી કનેક્ટ કરો
Studio સ્ક્રિપ્ટમાંથી SIP હેડરમાં ContactID સાથે NICE CXone કૉલને ThunderPhone એજન્ટને મોકલો અને સ્ક્રિપ્ટ આગળ ચાલુ રહે ત્યારે એજન્ટનું હેન્ડ-ઓફ શોધો.
તમારી CXone Studio સ્ક્રિપ્ટ SIP હેડર્સ સાથે એજન્ટને કૉલ કરે છે, જેમાં સંપર્ક id અને અન્ય કોઈપણ સંદર્ભ હોય છે. એજન્ટનું કામ પૂર્ણ થાય ત્યારે તે કૉલ બંધ કરે છે અને સ્ક્રિપ્ટમાં રહેલી REST API ક્રિયા હેન્ડ-ઓફ મેળવે છે.
શરૂ કરતાં પહેલાં
- ThunderPhone એજન્ટ અને સંસ્થા API કી.
- કસ્ટમ હેડર્સ સ્વીકારતું CXone SIP ટ્રંક ગ્રુપ. CXone તેમને મોકલે તે પહેલાં તમારા NICE એકાઉન્ટ પ્રતિનિધિએ આ સેટિંગ ચાલુ કરવું જરૂરી છે.
1. SIP એન્ડપૉઇન્ટ બનાવો
Placecall SIP સરનામા પર નહીં, પરંતુ CXone ટ્રંક ગ્રુપ મારફતે ફોન નંબર ડાયલ કરે છે.
NICE તેના માટે SIP ઓળખપત્રો દસ્તાવેજિત કરતું નથી, અને અન્ય AI પ્રદાતાના CXone
ઇન્ટિગ્રેશનમાં IP મંજૂર-યાદી સાથે TLS વપરાય છે. તેથી સ્ક્રિપ્ટ જે નંબર ડાયલ કરશે તેને ડાયલ-ઇન નંબર તરીકે રાખીને ip_allowlist
એન્ડપૉઇન્ટ બનાવો (જુઓ
ફોન નંબર ડાયલ કરતા પ્લેટફૉર્મ્સ):
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 પહેલાં:
- હેડર
X-Call-IDઅનેContactIDમૂલ્ય સાથે Sipputheader ક્રિયા ઉમેરો. CXone પોતાનો કોઈ કૉલ-id હેડર મોકલતું નથી; ThunderPhone આ હેડરને કૉલનાexternal_call_idતરીકે સંગ્રહે છે. - એજન્ટે જાણવું જોઈએ એવા દરેક અન્ય મૂલ્ય માટે Sipputheader ક્રિયા ઉમેરો,
જેમ કે
supportપર સેટ કરેલX-Skill. તે promptમાં{{sip_x_skill}}તરીકે પહોંચે છે. SipputheaderUser-to-User, કોઈપણX-હેડર અને મોટા ભાગનાP-હેડર્સ સ્વીકારે છે; NICE 256 અક્ષરો અથવા ઓછાં મૂલ્યોની ભલામણ કરે છે.
પછી, તે નંબર પર Placecall કરો, એવા ટ્રંક ગ્રુપ મારફતે જે તેને
નંબર સાથે વિનંતી URI અને To હેડર બંનેમાં sip.thunderphone.com પર મોકલે.
એન્ડપૉઇન્ટ TLS (પોર્ટ 5061) અથવા TCP (પોર્ટ 5060) સ્વીકારે છે અને
UDP નકારે છે, તથા NICE ટ્રંકનું પરિવહન દસ્તાવેજિત કરતું નથી, તેથી ખાતરી કરો કે તે
UDP નથી.
3. કૉલ પાછો મેળવો
CXone SIP હેડર્સ માત્ર INVITE અને તેના અંતિમ પ્રતિભાવમાં વાંચે છે, તેથી
એજન્ટ કૉલ પરત કરે છે: તે વિદાય કહે છે અને કૉલ બંધ કરે છે, અને તમારી સ્ક્રિપ્ટ
કૉલરને ફરીથી સંભાળે છે. આ ટ્રાન્સફર નંબર ઉમેરો (જુઓ
ટ્રાન્સફર નંબર ઉમેરો):
{"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વાંચો.
તેનું પરીક્ષણ કરો
સ્ક્રિપ્ટ ચલાવતા નંબર પર કૉલ કરો, એજન્ટને કોઈ વ્યક્તિ માટે પૂછો અને તપાસો કે
સ્ક્રિપ્ટ ચાલુ રહે છે તથા 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 સુધીના પ્રતિસાદ વાંચે છે.