Open in
Talkdesk থেকে সংযোগ করুন
Connect to Autopilot Voice ব্যবহার করে Talkdesk কল একটি ThunderPhone এজেন্টের কাছে পাঠান এবং UUI-তে hand-off id দিয়ে সেগুলো আবার এসকেলেট করুন।
আপনার Talkdesk Studio ফ্লো কলারকে interaction id এবং UUI সহ এজেন্টের কাছে পাঠায়। কলারের একজন ব্যক্তির প্রয়োজন হলে, এজেন্ট Talkdesk-এ একটি SIP REFER দিয়ে এসকেলেট করে এবং hand-off id একটি Studio ভেরিয়েবলে সংরক্ষিত হয়।
শুরু করার আগে
- একটি ThunderPhone এজেন্ট এবং একটি সংস্থা API key।
- একটি Talkdesk Conversation Orchestrator লাইসেন্স, যা External Voice Stream মোডে Studio-এর Connect to Autopilot Voice কম্পোনেন্ট কভার করে (Talkdesk-এর নিবন্ধ)। এজেন্ট কল ধরে রাখার সময় Talkdesk প্রতি মিনিটে বিল করে।
1. SIP এন্ডপয়েন্ট তৈরি করুন
Talkdesk শুধু একটি 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": "Talkdesk",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
"srtp": "optional"
}'Talkdesk-এর নিবন্ধে বলা হয়েছে যে এটি SRTP-র মাধ্যমে অডিও পাঠায়, এবং "srtp": "optional"
Talkdesk সেটি অফার করলে SRTP-তে উত্তর দেয়। নিবন্ধে Talkdesk
SRTP প্রয়োজন কি না বলা হয়নি; Talkdesk যদি আপনাকে বলে যে এটি প্রয়োজন, তাহলে srtp-কে required সেট করুন, যা এটি ছাড়া কল প্রত্যাখ্যান করে।
Talkdesk থেকে Talkdesk-এর SIP signalling range সংগ্রহ করুন। প্রতিটি অবশ্যই একটি পাবলিক IPv4
রেঞ্জ /16 বা তার চেয়ে সংকীর্ণ হতে হবে (IPv6 /48 বা তার চেয়ে সংকীর্ণ)। দেখুন
উৎস IP দিয়ে প্রমাণীকরণ করা প্ল্যাটফর্ম।
Talkdesk Twilio-এর নেটওয়ার্ক থেকে SIP পাঠায়, যার ঠিকানা সব Twilio গ্রাহক
ভাগ করে ব্যবহার করে, তাই এন্ডপয়েন্টের ঠিকানাই অন্য কলারদের বাইরে রাখে: এটি
প্রকাশ করবেন না।
প্রতিক্রিয়ার sip_uri সংরক্ষণ করুন, যেমন
sip:agent-12-jhxmginwjx@sip.thunderphone.com।
2. কনটেক্সটসহ কল পাঠান
আপনার Studio ফ্লোতে External Voice
Stream মোডে Connect to Autopilot Voice যোগ করুন এবং এর লক্ষ্য হিসেবে এন্ডপয়েন্টের sip_uri-তে ;transport=tls যুক্ত করে সেট করুন, যেমন
sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls। এন্ডপয়েন্ট UDP-এর মাধ্যমে কল প্রত্যাখ্যান করে, কারণ অন্যথা না বললে Twilio-এর SIP UDP ব্যবহার করে।
Talkdesk পাঠায়:
X-Talkdesk-Interaction-Id, যা কলেরexternal_call_idহিসেবে সংরক্ষিত হয়;User-to-User, হেক্স-এনকোড করা, যেমনbusiness_hours=open। এটি ডিকোড হয়ে{{sip_uui}}হিসেবে prompt-এ পৌঁছায়।
কম্পোনেন্টের সংস্করণ 2.1 Defined headers-ও পাঠাতে পারে। Talkdesk-এর পছন্দসমূহের পৃষ্ঠায় এগুলোকে WebSocket-এর মাধ্যমে পাঠানো JSON হিসেবে বর্ণনা করা হয়েছে, তাই এগুলোর ওপর নির্ভর করার আগে Talkdesk-এর সঙ্গে নিশ্চিত করুন যে সেগুলো SIP header হিসেবে আসে কি না।
3. কলটি ফিরে পান
এজেন্ট Talkdesk-এর এসকেলেশন ঠিকানায় একটি REFER দিয়ে এসকেলেট করে, যেখানে
হ্যান্ড-অফ আইডিটি সেই ঠিকানার ভিতরে হেক্স UUI হিসেবে থাকে—Talkdesk শুধুমাত্র সেখান থেকেই এটি পড়ে।
এই ট্রান্সফার নম্বরটি যোগ করুন (দেখুন
ট্রান্সফার নম্বর যোগ করুন
এবং ট্রান্সফার ঠিকানার ভিতরের হেডার):
{
"name": "Talkdesk escalation",
"number": "sip:escalation@talkdesk.com",
"headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}ঠিকানাটি Talkdesk-এর নিবন্ধে দেওয়া ঠিকানাটিই। কম্পোনেন্টের 2.1 সংস্করণ
autopilot_result= পড়ে; 1.7 সংস্করণ escalate_to= পড়ে, তাই 1.7-এ সেই কী ব্যবহার করুন।
REFER দেখতে এমন হয়:
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
Talkdesk মানটি একটি Studio ভেরিয়েবলে রাখে। সারাংশ এবং উদ্দেশ্য পেতে, Connections দিয়ে তৈরি একটি কাস্টম ইন্টিগ্রেশনে একটি অ্যাকশন চালান ধাপ যোগ করুন:
- প্রমাণীকরণের ধরন API কী, হেডারের নাম
Authorization, মানBearer sk_live_…। - অনুরোধ:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=এবং তার পরে ভেরিয়েবলের আইডি। ইন্টারঅ্যাকশন আইডি দিয়েexternal_call_idব্যবহার করেও কলটি খুঁজে দেখতে পারেন। handoff.intentঅনুযায়ী রাউট করুন এবং কল গ্রহণকারী ব্যক্তিকেhandoff.summaryদেখান।
দেখুন হ্যান্ড-অফ করা কল খুঁজুন।
এটি পরীক্ষা করুন
Studio ফ্লোর মাধ্যমে একটি কল শুরু করুন, এজেন্টের কাছে একজন ব্যক্তিকে চান, এবং পরীক্ষা করুন
যে ফ্লোটি কম্পোনেন্টের পরেও তার ভেরিয়েবলে হ্যান্ড-অফ আইডি নিয়ে চলতে থাকে। তারপর GET /v1/calls/{call_id} দিয়ে কলটি খুলুন:
external_call_id-এ Talkdesk ইন্টারঅ্যাকশন আইডি থাকা উচিত।
সীমাবদ্ধতা
- Talkdesk সর্বোচ্চ 256 বাইট UUI পড়ে এবং
|বা;দিয়ে আলাদা করা মান অনুমোদন করে না, তাই একটি একক মান পাঠান। হ্যান্ড-অফ আইডিটি এতে ধরে যায়। - Talkdesk-এর API এজেন্টের ট্রান্সক্রিপ্ট পড়তে পারে না। পরিবর্তে হ্যান্ড-অফ লুকআপ বা
GET /v1/calls/{call_id}ব্যবহার করুন।