ThunderPhone v3 এখন লাইভ।নিজেই ব্যবহার শুরু করুন, 2¢/মিনিট থেকে।ঘোষণাটি পড়ুন

Contact centers

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-এর আগে:

  1. হেডার X-Call-ID এবং ContactID-এর মান দিয়ে একটি Sipputheader অ্যাকশন যোগ করুন। CXone নিজস্ব কোনো call-id header পাঠায় না; ThunderPhone এটিকে কলের external_call_id হিসেবে সংরক্ষণ করে।
  2. এজেন্টের জানা উচিত এমন প্রতিটি অন্য মানের জন্য একটি Sipputheader অ্যাকশন যোগ করুন, যেমন support-এ সেট করা X-Skill। এটি prompt-এ {{sip_x_skill}} হিসেবে পৌঁছায়। Sipputheader User-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 পর্যন্ত প্রতিক্রিয়া পড়ে।