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

Contact centers

Zoom Contact Center থেকে সংযুক্ত করুন

তৃতীয় পক্ষের voicebot কানেক্টরের মাধ্যমে Zoom Contact Center-এর কল ThunderPhone এজেন্টের কাছে পাঠান এবং SIP REFER দিয়ে সেগুলো আবার একজন মানব এজেন্টের কাছে ফিরিয়ে নিন।

আপনার Zoom Contact Center ফ্লোতে একটি বট উইজেট কলারকে Zoom-এর কল sid সহ এজেন্টের কাছে পাঠায়। কলারের একজন ব্যক্তির প্রয়োজন হলে, এজেন্ট Zoom-এর মানব-এজেন্ট ঠিকানায় একটি SIP REFER পাঠায় এবং আপনার ফ্লো কল sid ব্যবহার করে হ্যান্ড-অফটি পুনরুদ্ধার করে।

শুরু করার আগে

  • একটি ThunderPhone এজেন্ট এবং একটি প্রতিষ্ঠান API key।
  • একটি Zoom Marketplace সাধারণ অ্যাপ, যা আপনার অ্যাডমিন পরিচালনা করেন এবং Contact Center-এর জন্য উপলভ্য করেন, এবং যাতে বট উইজেটের জন্য একটি কানেক্টর রয়েছে (Zoom-এর তৃতীয়-পক্ষ ভয়েসবট গাইড)।
  • Zoom থেকে বট প্রোভাইডারের দিকে একটি SIP ট্রাঙ্ক। Zoom-এর ISV টিম এটি ধাপে ধাপে তৈরি করে (ডিসকভারি, একটি স্টেজিং ট্রাঙ্ক, তারপর প্রোডাকশন), এবং অ্যাপের Company Name অবশ্যই ট্রাঙ্ক রেকর্ডের সঙ্গে হুবহু মিলতে হবে। এই সেটআপটি ThunderPhone সাপোর্ট এবং Zoom-এর মাধ্যমে শুরু হয়, শুধুমাত্র আপনার Zoom অ্যাকাউন্টে নয়।

1. SIP এন্ডপয়েন্ট তৈরি করুন

Zoom-এর কানেক্টর একটি SIP ঠিকানার পরিবর্তে 999 দিয়ে শুরু হওয়া 15-সংখ্যার নম্বরে ডায়াল করে। কানেক্টর সংরক্ষণ করলে এই নম্বরটি তৈরি হয়। Zoom-এর ট্রাঙ্ক অডিওর জন্য SRTP সহ পোর্ট 5061-এ TLS 1.2 ব্যবহার করে এবং পাসওয়ার্ডের পরিবর্তে Zoom-এর সাবনেট দ্বারা allowlist করা থাকে। তাই কানেক্টরের নম্বরটিকে ডায়াল-ইন নম্বর হিসেবে এবং SRTP আবশ্যক রেখে একটি 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": "Zoom Contact Center",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["999123456789012"],
    "srtp": "required"
  }'
  • allowed_source_cidrs: Zoom থেকে পাওয়া Zoom-এর SIP সিগন্যালিং সাবনেট। প্রতিটিই অবশ্যই /16 বা এর চেয়ে সংকীর্ণ একটি পাবলিক IPv4 রেঞ্জ হতে হবে (IPv6 /48 বা এর চেয়ে সংকীর্ণ)।
  • dial_in_numbers: Zoom যেভাবে পাঠায় ঠিক সেইভাবে কানেক্টরের নম্বর, + ছাড়া।
  • srtp: required, কারণ Zoom-এর ট্রাঙ্ক সবসময় SRTP ব্যবহার করে।

Zoom-এর ঠিকানাগুলো এর সব গ্রাহকের মধ্যে ভাগ করা, তাই অন্য কোনো Zoom গ্রাহক এই নম্বরে ডায়াল করলে আপনার এজেন্টের কাছে পৌঁছে যাবে। Zoom নম্বরটি নির্ধারণ করে; এটি প্রকাশ করবেন না।

2. প্রসঙ্গসহ কল পাঠান

আপনার ফ্লোতে একটি বট উইজেট যোগ করুন এবং এটি কানেক্টরের সঙ্গে বাইন্ড করুন। Zoom-এর ISV টিমকে ট্রাঙ্কটি sip.thunderphone.com-এ নির্দেশ করতে বলুন, পোর্ট 5061-এ TLS সহ, এবং রিকোয়েস্ট URI ও To হেডার উভয়টিতে কানেক্টরের নম্বর রাখুন। এন্ডপয়েন্টটি UDP প্রত্যাখ্যান করে, তাই নিশ্চিত করুন যে ট্রাঙ্কটি এতে ফিরে না যায়।

Zoom পাঠায়:

  • X-ZOOM-Call-Sid, যা কলের external_call_id হিসেবে সংরক্ষিত হয়। Zoom-এর নিজস্ব ডেটা ম্যাপিং পেজে এটি তালিকাভুক্ত নেই; অন্য একটি AI প্রোভাইডারের Zoom ইন্টিগ্রেশন এটি নথিভুক্ত করেছে, তাই আপনার প্রথম পরীক্ষামূলক কলে এটি পরীক্ষা করুন।
  • X-ZOOM-DNIS, কলার যে নম্বরে ডায়াল করেছেন, সেটি {{sip_x_zoom_dnis}} হিসেবে।
  • X-ZOOM-WEBHOOK, কানেক্টরের Static URL।

3. কলটি ফেরত নিন

এজেন্ট Zoom-এর SBC-তে মানব-এজেন্টের ঠিকানায় একটি REFER পাঠায়। এই ট্রান্সফার নম্বরটি যোগ করুন (দেখুন ট্রান্সফার নম্বর যোগ করুন), Zoom আপনাকে যে SBC ঠিকানা দেয় সেটি দিয়ে:

{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}

Zoom-এর গাইডে একটি বট কীভাবে কনটেক্সট পাঠায় তার দুটি উপায় বর্ণনা করা হয়েছে: REFER-এর আগে কানেক্টরের Static URL-এ একটি POST (voicebot_metadata এবং অনুরূপ ইভেন্ট), এবং Inbound from Bot-এর অধীনে ম্যাপ করা SIP হেডার। ThunderPhone Static URL-এ পোস্ট করে না। Zoom-এর গাইডে বলা নেই যে এটি একটি REFER থেকে ম্যাপ করা হেডার পড়ে কি না; চেষ্টা করতে চাইলে এন্ট্রিতে "X-Handoff-Id": "{{handoff_id}}"-এর মতো headers যোগ করুন এবং একটি টেস্ট কলে পরীক্ষা করুন। এছাড়াও Zoom-এর সঙ্গে নিশ্চিত করুন যে এটি আগে কোনো মেটাডেটা POST ছাড়াই একটি REFER গ্রহণ করে।

দুটির কোনোটির ওপর নির্ভর না করে হ্যান্ড-অফ পেতে, Bot উইজেটের পরে আপনার ফ্লো দিয়ে এটি খুঁজে নিন, একটি HTTP Call অথবা Script উইজেট ব্যবহার করে:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= এর পরে কল sid।
  • হেডার Authorization: Bearer sk_live_…।
  • কলারকে রাউট করতে এবং কল গ্রহণকারী ব্যক্তিকে সংক্ষিপ্ত তথ্য দিতে handoff.summary ও handoff.intent ব্যবহার করুন।

Zoom এই উইজেটগুলোর জন্য ফিল্ড-স্তরের ডকুমেন্টেশন প্রকাশ করে না, তাই আপনার অ্যাকাউন্টে নিশ্চিত করুন যে উইজেটটি একটি Authorization হেডার পাঠাতে পারে। দেখুন হ্যান্ড-অফ করা কল খুঁজে নিন।

এটি পরীক্ষা করুন

Bot উইজেটে পৌঁছায় এমন একটি নম্বরে কল করুন, এজেন্টকে একজন ব্যক্তির সঙ্গে কথা বলতে বলুন, এবং পরীক্ষা করুন যে কলার একজন মানব এজেন্টের কাছে পৌঁছায় ও উইজেটটি হ্যান্ড-অফ ফেরত দেয়। তারপর GET /v1/calls/{call_id} দিয়ে কলটি খুলুন: sip_headers-এ x-zoom-call-sid তালিকাভুক্ত থাকা উচিত, এবং external_call_id আপনার ফ্লো যে কল sid ব্যবহার করে তার সঙ্গে মিলতে হবে।

সীমাবদ্ধতা

  • ThunderPhone কানেক্টরের Static URL-এ পোস্ট করে না, তাই Zoom হ্যান্ড-অফটি লুকআপের মাধ্যমে পায়, অথবা আপনার পরীক্ষা দেখালে যে Zoom REFER থেকে সেগুলো পড়ে তবে ম্যাপ করা হেডারের মাধ্যমে পায়।
  • ট্রাঙ্কটি Zoom-এর ISV টিম তৈরি করে, তাই আপনি নিজে এটি সেট আপ বা পরীক্ষা করতে পারবেন না।