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 டிரங்க் குழு வழியாக ஒரு தொலைபேசி எண்ணை டயல் செய்கிறது.
இதற்கான SIP சான்றுகளை NICE ஆவணப்படுத்தவில்லை; மற்றொரு 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: CXone அனுப்பும் வடிவில் எழுதப்பட்ட, Placecall டயல் செய்யும் எண். இது உண்மையான தொலைபேசி எண்ணாக இருக்க வேண்டியதில்லை. இது தொலைபேசி எண்ணாகவோ அல்லது வேறு எண்ட்பாயிண்டிலோ 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}}ஆக அடையும். Sipputheader,User-to-User, எந்தX-ஹெடரையும், பெரும்பாலானP-ஹெடர்களையும் ஏற்கிறது; 256 எழுத்துகள் அல்லது அதற்குக் குறைவான மதிப்புகளை NICE பரிந்துரைக்கிறது.
அதன்பின் அந்த எண்ணுக்கு Placecall செய்யவும்; எண்ணை கோரிக்கை URI மற்றும் To
ஹெடர் இரண்டிலும் வைத்து அதை sip.thunderphone.com-க்கு அனுப்பும் டிரங்க் குழு வழியாகச் செய்யவும். எண்ட்பாயிண்ட் TLS (போர்ட் 5061) அல்லது TCP (போர்ட் 5060)-ஐ ஏற்கிறது; UDP-ஐ மறுக்கிறது. NICE டிரங்கின் பரிமாற்ற நெறிமுறையை ஆவணப்படுத்தவில்லை, எனவே அது UDP அல்ல என்பதை உறுதிசெய்யவும்.
3. அழைப்பை மீண்டும் பெறவும்
CXone, INVITE மற்றும் அதன் இறுதிப் பதிலில் மட்டுமே SIP ஹெடர்களைப் படிக்கிறது; எனவே
ஏஜென்ட் அழைப்பைத் திருப்பி அனுப்புகிறது: அது விடைபெற்று அழைப்பை முடிக்கிறது; உங்கள் ஸ்கிரிப்ட்
அழைப்பாளரை மீண்டும் ஏற்கிறது. இந்த பரிமாற்ற எண்ணைச் சேர்க்கவும் (பரிமாற்ற எண்ணைச் சேர்க்கவும் என்பதைப் பார்க்கவும்):
{"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 வரையிலான பதில்களை வாசிக்கும்.