Open in
Amazon Connect سے کنیکٹ کریں
Amazon Connect کالز کو رابطہ ID اور UUI کے ساتھ SIP کے ذریعے ThunderPhone ایجنٹ کو بھیجیں، اور ایجنٹ کے ہینڈ آف کے ساتھ اپنا فلو دوبارہ شروع کریں۔
آپ کا Amazon Connect فلو رابطہ ID اور آپ کے سیٹ کردہ کسی بھی UUI کے ساتھ کالر کو ایجنٹ تک بھیجتا ہے۔ ایجنٹ کا کام مکمل ہونے پر وہ کال ختم کر دیتا ہے، آپ کا فلو جاری رہتا ہے، اور ایک Lambda رابطہ ID کے ذریعے منتقلی حاصل کرتا ہے۔
شروع کرنے سے پہلے
- ایک ThunderPhone ایجنٹ اور تنظیم کی API کلید۔
- Amazon Connect کا بیرونی وائس ٹرانسفر کنیکٹر۔ پہلے "ہر اکاؤنٹ کے لیے بیرونی وائس ٹرانسفر کنیکٹرز" کوٹے میں اضافے کی درخواست کریں: AWS کی منظوری تک مینو پوشیدہ رہتا ہے۔ AWS ہر کنیکٹر کے لیے روزانہ فیس لیتا ہے ($100 روزانہ، 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"]
}'اپنے Region کے لیے کنیکٹر کی SIP سگنلنگ رینجز AWS سے حاصل کریں۔ ہر رینج ایک عوامی IPv4 رینج ہونی چاہیے جو /16 یا اس سے زیادہ مخصوص ہو (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 رابطہ ID کو X-Amzn-ConnectContactId میں بھیجتا ہے۔ ThunderPhone اسے کال کے external_call_id کے طور پر محفوظ کرتا ہے، جس کے ذریعے آپ کا فلو بعد میں کال تلاش کرتا ہے۔ UUI پرامپٹ تک {{sip_uui}} کے طور پر پہنچتا ہے۔ فریق ثالث انٹیگریشنز رابطہ ID ہیڈر کو دستاویزی شکل دیتی ہیں؛ AWS کی اپنی دستاویزات ایسا نہیں کرتیں، اس لیے اپنی پہلی ٹیسٹ کال میں اسے چیک کریں۔
3. کال واپس حاصل کریں
AWS میں Connect کے لیے 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 میں
BYEپر، بشمولX-TP-Handoff-Id، ہیڈرز پڑھنے کا کوئی طریقہ دستاویزی نہیں ہے، اس لیے کانٹیکٹ آئی ڈی ہی کال سے واپس جڑنے کا واحد ربط ہے۔ - AWS کنیکٹر کے لیے زیادہ سے زیادہ UUI طوالت دستاویزی نہیں کرتا۔
- ہم وقت Lambda بلاک 8 سیکنڈ کے بعد ٹائم آؤٹ ہو جاتا ہے۔