Open in
Amazon Connect থেকে সংযোগ করুন
Amazon Connect কলগুলোকে contact id এবং UUI সহ SIP-এর মাধ্যমে একটি ThunderPhone এজেন্টের কাছে পাঠান, এবং এজেন্টের হ্যান্ড-অফ দিয়ে আপনার ফ্লো পুনরায় চালু করুন।
আপনার Amazon Connect ফ্লো কলারকে কনট্যাক্ট আইডি এবং আপনার সেট করা যেকোনো UUI-সহ এজেন্টের কাছে পাঠায়। এজেন্টের কাজ শেষ হলে সে কল কেটে দেয়, আপনার ফ্লো চলতে থাকে, এবং একটি Lambda কনট্যাক্ট আইডি দিয়ে হ্যান্ড-অফ নিয়ে আসে।
শুরু করার আগে
- একটি ThunderPhone এজেন্ট এবং একটি প্রতিষ্ঠান API কী।
- Amazon Connect-এর বাহ্যিক ভয়েস ট্রান্সফার কানেক্টর। আগে "প্রতি অ্যাকাউন্টে বাহ্যিক ভয়েস ট্রান্সফার কানেক্টর" কোটা বৃদ্ধির অনুরোধ করুন: AWS অনুমোদন না দেওয়া পর্যন্ত মেনুটি লুকানো থাকে। AWS প্রতিটি কানেক্টরের জন্য প্রতিদিন বিল করে ($100 a day since July 21, 2025) এবং এর সঙ্গে প্রতি মিনিটের ব্যবহারমূল্য যোগ হয়।
1. SIP এন্ডপয়েন্ট তৈরি করুন
কানেক্টরটি SIP ডাইজেস্ট প্রমাণীকরণ নথিভুক্ত করে না, তাই উৎস ঠিকানা থেকে কল গ্রহণ করে এমন একটি এন্ডপয়েন্ট তৈরি করুন:
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": "Amazon Connect",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["CONNECT_SIGNALLING_RANGE_1", "CONNECT_SIGNALLING_RANGE_2"]
}'আপনার অঞ্চলের জন্য কানেক্টরের SIP সিগন্যালিং রেঞ্জ AWS থেকে নিন। প্রতিটি অবশ্যই /16 বা তার চেয়ে সংকীর্ণ একটি পাবলিক IPv4 রেঞ্জ হতে হবে (IPv6-এর ক্ষেত্রে /48 বা তার চেয়ে সংকীর্ণ)। নিয়ম এবং প্ল্যাটফর্মের প্রতিটি গ্রাহকের মধ্যে ভাগাভাগি করা একটি ঠিকানার ঝুঁকির জন্য
উৎস IP দিয়ে প্রমাণীকরণকারী প্ল্যাটফর্ম
দেখুন। প্রতিক্রিয়ার sip_uri সংরক্ষণ করুন, যেমন
sip:agent-12-jhxmginwjx@sip.thunderphone.com।
2. কনটেক্সটসহ কল পাঠান
- Amazon Connect কনসোলে, বাহ্যিক ভয়েস সিস্টেম → ভয়েস ট্রান্সফার ইন্টিগ্রেশন খুলুন এবং তৈরি করুন নির্বাচন করুন।
- গন্তব্যের ধরন (একটি SBC) বেছে নিন এবং হোস্ট
sip.thunderphone.com, পোর্ট5061এবং প্রোটোকল TLS দিয়ে একটি আউটবাউন্ড রুট যোগ করুন। এন্ডপয়েন্টের জন্য TLS বা TCP (পোর্ট5060) প্রয়োজন এবং এটি UDP গ্রহণ করে না। কানেক্টর কোন প্রোটোকল দেয় তা AWS নথিভুক্ত করে না, তাই এটি সেগুলোর একটি ব্যবহার করতে পারে কি না AWS-এর কাছে নিশ্চিত করুন। - আপনার ফ্লোতে ফোন নম্বরে ট্রান্সফার করুন ব্লক যোগ করুন, যেখানে এতে ট্রান্সফার করুন-এ বাহ্যিক ভয়েস সিস্টেম সেট করা থাকবে, এবং সেট করুন:
- গন্তব্য ARN: কানেক্টর।
- ব্যবহারকারীর কাছে: এন্ডপয়েন্টের
sip_uri-এর ব্যবহারকারী অংশ, যেমনagent-12-jhxmginwjx। - UUI (ঐচ্ছিক): এজেন্টের জন্য কনটেক্সট। Connect এটি হেক্স-এনকোড করা অবস্থায় পাঠায়।
- সংযোগ বিচ্ছিন্ন হওয়ার পর ফ্লো পুনরায় শুরু করুন: হ্যাঁ, যাতে এজেন্ট কল কেটে দিলে ফ্লো চলতে থাকে।
Connect X-Amzn-ConnectContactId-এ কনট্যাক্ট আইডি পাঠায়। ThunderPhone এটিকে কলের external_call_id হিসেবে সংরক্ষণ করে, যার মাধ্যমে আপনার ফ্লো পরে কলটি খুঁজে পায়। UUI {{sip_uui}} হিসেবে prompt-এ পৌঁছায়। তৃতীয় পক্ষের ইন্টিগ্রেশনগুলো কনট্যাক্ট-আইডি হেডার নথিভুক্ত করে; AWS-এর নিজস্ব ডকসে তা নেই, তাই আপনার প্রথম টেস্ট কলে এটি পরীক্ষা করুন।
3. কলটি ফিরিয়ে নিন
AWS, BYE-তে হেডার পড়ার বা এজেন্টের কাছ থেকে REFER গ্রহণ করার কোনো উপায় নথিভুক্ত করেনি। তাই এজেন্ট কলটি ফিরিয়ে দেয়: এটি বিদায় জানিয়ে কল কেটে দেয়, এবং ট্রান্সফার ব্লকের পরে আপনার ফ্লো আবার শুরু হয়। এই ট্রান্সফার নম্বরটি যোগ করুন (ট্রান্সফার নম্বর যোগ করুন দেখুন):
{"name": "Amazon Connect", "action": "return"}এরপর ট্রান্সফারের পরে একটি AWS Lambda ফাংশন আহ্বান করুন ব্লক দিয়ে হ্যান্ড-অফ আনুন। Lambda কনট্যাক্ট আইডি দিয়ে কলটি খুঁজে বের করে:
import json
import os
import urllib.error
import urllib.parse
import urllib.request
def lambda_handler(event, context):
contact_id = event["Details"]["ContactData"]["ContactId"]
url = "https://api.thunderphone.com/v1/calls/handoff?" + urllib.parse.urlencode(
{"external_call_id": contact_id}
)
request = urllib.request.Request(
url, headers={"Authorization": "Bearer " + os.environ["THUNDERPHONE_API_KEY"]}
)
try:
with urllib.request.urlopen(request, timeout=5) as response:
call = json.load(response)
except (urllib.error.URLError, TimeoutError):
return {"found": "false"}
handoff = call.get("handoff") or {}
return {
"found": "true",
"intent": handoff.get("intent") or "",
"summary": handoff.get("summary") or "",
}ব্লকটি একটি সমতল ম্যাপ ফেরত দেয়, তাই ফ্লো intent অনুযায়ী শাখা করতে পারে অথবা কল গ্রহণকারী ব্যক্তির জন্য summary-কে কনট্যাক্ট অ্যাট্রিবিউট হিসেবে সেট করতে পারে। ব্লকটি সিঙ্ক্রোনাসভাবে চালান (সর্বোচ্চ 8 সেকেন্ড) এবং API কী এনক্রিপ্ট করে সংরক্ষণ করুন, যেমন AWS Secrets Manager-এ। রেসপন্স ফিল্ডগুলো হ্যান্ড-অফ করা কল খুঁজে দেখুন-এ রয়েছে।
এটি পরীক্ষা করুন
আপনার Connect ইনস্ট্যান্সের এমন একটি নম্বরে কল করুন যা ট্রান্সফার ব্লকে পৌঁছায়, এজেন্টের কাছে একজন ব্যক্তিকে চান, এবং ফ্লো আবার শুরু হচ্ছে কি না পরীক্ষা করুন। তারপর GET /v1/calls/{call_id} দিয়ে কলটি খুলুন: sip_headers-এ x-amzn-connectcontactid তালিকাভুক্ত থাকা উচিত, এবং external_call_id আপনার Lambda যে ContactId পায় তার সমান হওয়া উচিত। SIP 404 সহ ট্রান্সফার ব্যর্থ হলে, ThunderPhone এন্ডপয়েন্টের ইউজার অংশ খুঁজে পায়নি: এটি রিকোয়েস্ট URI এবং To হেডার—উভয় জায়গায় থাকতে হবে।
সীমাবদ্ধতা
- AWS,
X-TP-Handoff-Id-সহBYE-তে হেডার পড়ার কোনো উপায় নথিভুক্ত করেনি, তাই কনট্যাক্ট আইডিই কলে ফিরে যাওয়ার একমাত্র সংযোগ। - AWS কানেক্টরের জন্য সর্বোচ্চ UUI দৈর্ঘ্য নথিভুক্ত করেনি।
- একটি সিঙ্ক্রোনাস Lambda ব্লক 8 সেকেন্ড পরে টাইম আউট হয়।