Open in
NICE CXone నుండి కనెక్ట్ చేయండి
Studio స్క్రిప్ట్ నుండి SIP హెడర్లోని ContactIDతో NICE CXone కాల్లను ThunderPhone ఏజెంట్కు పంపండి మరియు స్క్రిప్ట్ కొనసాగినప్పుడు ఏజెంట్ హ్యాండ్-ఆఫ్ను పరిశీలించండి.
మీ CXone Studio స్క్రిప్ట్ సంప్రదింపు id మరియు ఇతర సందర్భ సమాచారాన్ని కలిగి ఉన్న SIP హెడర్లతో ఏజెంట్కు కాల్ చేస్తుంది. ఏజెంట్ పని పూర్తయినప్పుడు, అది కాల్ను ముగిస్తుంది మరియు స్క్రిప్ట్లోని 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 తనదైన call-id హెడర్ను పంపదు; ThunderPhone దీనిని కాల్ యొక్కexternal_call_idగా నిల్వ చేస్తుంది. - ఏజెంట్ తెలుసుకోవాల్సిన ప్రతి ఇతర విలువ కోసం ఒక Sipputheader చర్యను జోడించండి, ఉదాహరణకు
supportగా సెట్ చేసినX-Skill. అది promptకు{{sip_x_skill}}గా చేరుతుంది. SipputheaderUser-to-User, ఏదైనాX-హెడర్, మరియు ఎక్కువP-హెడర్లను స్వీకరిస్తుంది; NICE 256 అక్షరాలు లేదా అంతకంటే తక్కువ విలువలను సిఫార్సు చేస్తుంది.
అనంతరం, అభ్యర్థన URI మరియు To హెడర్ రెండింటిలోనూ నంబర్తో దానిని sip.thunderphone.comకు పంపే ట్రంక్ గ్రూప్ ద్వారా ఆ నంబర్కు Placecall చేయండి. ఎండ్పాయింట్ TLSను (పోర్ట్ 5061) లేదా TCPను (పోర్ట్ 5060) స్వీకరిస్తుంది మరియు UDPని నిరాకరిస్తుంది; NICE ట్రంక్ రవాణా విధానాన్ని డాక్యుమెంట్ చేయదు కాబట్టి, అది UDP కాదని నిర్ధారించండి.
3. కాల్ను తిరిగి పొందండి
CXone SIP హెడర్లను INVITE మరియు దాని తుది ప్రతిస్పందనలో మాత్రమే చదువుతుంది, కాబట్టి ఏజెంట్ కాల్ను తిరిగి పంపుతుంది: అది వీడ్కోలు చెప్పి కాల్ను ముగిస్తుంది, ఆపై మీ స్క్రిప్ట్ కాలర్ను మళ్లీ తీసుకుంటుంది. ఈ బదిలీ నంబర్ను జోడించండి (బదిలీ నంబర్ను జోడించండి చూడండి):
{"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ను చదవండి.
హ్యాండ్-ఆఫ్ చేసిన కాల్ను కనుగొనండి చూడండి.
పరీక్షించండి
స్క్రిప్ట్ను అమలు చేసే నంబర్కు కాల్ చేయండి, ఒక వ్యక్తి కోసం ఏజెంట్ను అడగండి, ఆపై
స్క్రిప్ట్ కొనసాగుతుందో మరియు 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 వరకు ప్రతిస్పందనలను చదువుతుంది.