Open in
NICE CXone থেকে সংযোগ করুন
Studio স্ক্রিপ্ট থেকে SIP হেডারে ContactID সহ NICE CXone কল একটি ThunderPhone এজেন্টের কাছে পাঠান, এবং স্ক্রিপ্ট চলতে থাকলে এজেন্টের হ্যান্ড-অফ খুঁজে দেখুন।
আপনার CXone Studio স্ক্রিপ্ট SIP হেডারসহ এজেন্টের কাছে একটি কল পাঠায়, যেখানে contact id এবং অন্য যেকোনো প্রসঙ্গ থাকে। এজেন্টের কাজ শেষ হলে এটি কলটি কেটে দেয়, এবং স্ক্রিপ্টের একটি REST API অ্যাকশন hand-off সংগ্রহ করে।
শুরু করার আগে
- একটি ThunderPhone এজেন্ট এবং একটি organization API key।
- কাস্টম হেডার গ্রহণ করে এমন একটি CXone SIP trunk group। CXone পাঠানোর আগে আপনার NICE account representative-কে এই সেটিং চালু করতে হবে।
1. SIP endpoint তৈরি করুন
Placecall SIP address নয়, CXone trunk group-এর মাধ্যমে একটি ফোন নম্বরে ডায়াল করে।
NICE এটির জন্য SIP credentials নথিভুক্ত করেনি, এবং অন্য একটি AI provider-এর CXone
integration IP allowlist-সহ TLS ব্যবহার করে। তাই স্ক্রিপ্ট যে নম্বরে ডায়াল করবে সেটিকে
dial-in number হিসেবে দিয়ে একটি ip_allowlist endpoint তৈরি করুন (দেখুন
যেসব প্ল্যাটফর্ম ফোন নম্বরে ডায়াল করে):
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 cluster-এর SIP signalling ranges। প্রতিটি অবশ্যই/16বা তার চেয়ে সংকীর্ণ public IPv4 range হতে হবে (IPv6-এর ক্ষেত্রে/48বা তার চেয়ে সংকীর্ণ)।dial_in_numbers: Placecall যে নম্বরে ডায়াল করবে, CXone যেভাবে নম্বরটি পাঠায় সেভাবে লিখুন। এটি প্রকৃত ফোন নম্বর হওয়ার প্রয়োজন নেই। ThunderPhone-এ এটি আগে থেকেই ফোন নম্বর হিসেবে বা অন্য endpoint-এ ব্যবহৃত থাকতে পারবে না: সেক্ষেত্রে409ফেরত আসে।
CXone-এর address সব গ্রাহকের জন্য শেয়ার করা থাকে, তাই অন্য কোনো CXone গ্রাহক এই নম্বরে ডায়াল করলে আপনার এজেন্টে পৌঁছে যাবে। নম্বরটি যেখানে বেছে নেবেন, এমন একটি দীর্ঘ নম্বর বেছে নিন যা কেউ অনুমান করতে পারবে না (সর্বোচ্চ 15 digit), নিশ্চিত করুন CXone এটি ফোন network-এ পাঠানোর বদলে ThunderPhone-এ পাঠায়, এবং এটি প্রকাশ করবেন না।
2. প্রসঙ্গসহ কল পাঠান
আপনার Studio স্ক্রিপ্টে, Placecall-এর আগে:
- হেডার
X-Call-IDএবংContactID-এর মান দিয়ে একটি Sipputheader অ্যাকশন যোগ করুন। CXone নিজস্ব কোনো call-id header পাঠায় না; ThunderPhone এটিকে কলেরexternal_call_idহিসেবে সংরক্ষণ করে। - এজেন্টের জানা উচিত এমন প্রতিটি অন্য মানের জন্য একটি Sipputheader অ্যাকশন যোগ করুন,
যেমন
support-এ সেট করাX-Skill। এটি prompt-এ{{sip_x_skill}}হিসেবে পৌঁছায়। SipputheaderUser-to-User, যেকোনোX-header এবং অধিকাংশP-header গ্রহণ করে; NICE 256 character বা তার কম মান ব্যবহারের পরামর্শ দেয়।
তারপর সেই নম্বরে Placecall করুন, এমন একটি trunk group-এর মাধ্যমে যা নম্বরটি request URI এবং
To header—দুটিতেই রেখে sip.thunderphone.com-এ পাঠায়। Endpoint TLS (port 5061) অথবা
TCP (port 5060) গ্রহণ করে এবং UDP প্রত্যাখ্যান করে; NICE trunk-এর transport নথিভুক্ত করেনি,
তাই নিশ্চিত করুন এটি UDP নয়।
3. কলটি ফেরত নিন
CXone কেবল INVITE এবং এর final response-এ SIP header পড়ে, তাই এজেন্ট কলটি ফেরত দেয়:
এটি বিদায় বলে কল কেটে দেয়, এবং আপনার স্ক্রিপ্ট আবার কলারকে গ্রহণ করে। এই transfer number যোগ করুন (দেখুন
transfer number যোগ করুন):
{"name": "NICE CXone", "action": "return"}NICE নথিভুক্ত করেনি যে স্থাপিত কল শেষ হলে Placecall-এর পরে একটি স্ক্রিপ্ট চলতে থাকে।
অন্য AI provider-দের CXone integration কল কাটার আগে CXone-এর Signal API
(POST /interactions/{contactId}/signal) দিয়ে স্ক্রিপ্টে signal পাঠায়; ThunderPhone এটি কল করে না।
আপনার স্ক্রিপ্ট কীভাবে কলারকে ফেরত নেয় তা NICE-এর সঙ্গে নিশ্চিত করুন, তারপর একটি REST API অ্যাকশন দিয়ে
hand-off সংগ্রহ করুন:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=-এর পরেContactIDযোগ করুন।- Header
Authorization: Bearer sk_live_…। - contact route করার জন্য response থেকে
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 পর্যন্ত প্রতিক্রিয়া পড়ে।