---
title: "Amazon Connect سے کنیکٹ کریں"
description: "Amazon Connect کالز کو رابطہ ID اور UUI کے ساتھ SIP کے ذریعے ThunderPhone ایجنٹ کو بھیجیں، اور ایجنٹ کے ہینڈ آف کے ساتھ اپنا فلو دوبارہ شروع کریں۔"
---

آپ کا Amazon Connect فلو رابطہ ID اور آپ کے سیٹ کردہ کسی بھی UUI کے ساتھ کالر کو ایجنٹ تک بھیجتا ہے۔ ایجنٹ کا کام مکمل ہونے پر وہ کال ختم کر دیتا ہے، آپ کا فلو جاری رہتا ہے، اور ایک Lambda رابطہ ID کے ذریعے منتقلی حاصل کرتا ہے۔

## شروع کرنے سے پہلے

- ایک ThunderPhone ایجنٹ اور تنظیم کی [API کلید](/ur/guides/api-keys)۔
- Amazon Connect کا **بیرونی وائس ٹرانسفر** کنیکٹر۔ پہلے "ہر اکاؤنٹ کے لیے بیرونی وائس ٹرانسفر کنیکٹرز" کوٹے میں اضافے کی درخواست کریں: AWS کی منظوری تک مینو پوشیدہ رہتا ہے۔ AWS ہر کنیکٹر کے لیے روزانہ فیس لیتا ہے
  ([$100 روزانہ، 21 جولائی 2025 سے](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  اور اس کے علاوہ فی منٹ استعمال کی فیس بھی لیتا ہے۔

<Warning>
  AWS کی موجودہ منتظم گائیڈ میں اب بیرونی وائس ٹرانسفر کے صفحات شامل نہیں ہیں۔
  اس پر تعمیر کرنے سے پہلے، AWS سے تصدیق کریں کہ کنیکٹر آپ کی انسٹینس اور Region کے لیے دستیاب ہے۔
</Warning>

## 1. SIP اینڈ پوائنٹ بنائیں

کنیکٹر SIP ڈائجسٹ توثیق کو دستاویزی شکل نہیں دیتا، اس لیے ایسا اینڈ پوائنٹ بنائیں جو ماخذ پتے کے ذریعے کالز قبول کرے:

```bash
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 کے ذریعے توثیق کرتے ہیں](/ur/guides/sip-addresses)
دیکھیں۔ جواب کا `sip_uri` محفوظ رکھیں، مثال کے طور پر
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`۔

## 2. سیاق کے ساتھ کالز بھیجیں

1. Amazon Connect کنسول میں، **بیرونی وائس سسٹمز → وائس ٹرانسفر انٹیگریشنز** کھولیں اور **بنائیں** منتخب کریں۔
2. منزل کی قسم منتخب کریں (ایک SBC) اور ہوسٹ
   `sip.thunderphone.com`، پورٹ `5061` اور TLS پروٹوکول کے ساتھ ایک آؤٹ باؤنڈ روٹ شامل کریں۔ اینڈ پوائنٹ کو
   TLS یا TCP (پورٹ `5060`) درکار ہے اور یہ UDP مسترد کرتا ہے۔ AWS یہ دستاویز نہیں کرتا کہ کنیکٹر کون سے
   پروٹوکول پیش کرتا ہے، اس لیے AWS سے تصدیق کریں کہ یہ ان میں سے ایک استعمال کر سکتا ہے۔
3. اپنے فلو میں **فون نمبر پر منتقل کریں** بلاک شامل کریں، جس میں **منتقل کریں**
   کو **بیرونی وائس سسٹم** پر سیٹ کریں، اور درج ذیل سیٹ کریں:
   - **منزل 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` قبول کرنے کا کوئی طریقہ دستاویزی نہیں ہے۔ اس لیے ایجنٹ کال واپس کرتا ہے: وہ الوداع کہتا ہے اور کال ختم کر دیتا ہے، اور آپ کا فلو ٹرانسفر بلاک کے بعد دوبارہ شروع ہو جاتا ہے۔ یہ ٹرانسفر نمبر شامل کریں ([ٹرانسفر نمبر شامل کریں](/ur/guides/contact-centers/overview) دیکھیں):

```json
{"name": "Amazon Connect", "action": "return"}
```

پھر ٹرانسفر کے بعد **AWS Lambda فنکشن چلائیں** بلاک کے ذریعے ہینڈ آف حاصل کریں۔ Lambda کانٹیکٹ آئی ڈی کے ذریعے کال تلاش کرتا ہے:

```python
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 میں۔ جوابی فیلڈز [منتقل کی گئی کال تلاش کریں](/api-reference/calls#look-up-a-handed-off-call) میں موجود ہیں۔

## اس کی جانچ کریں

اپنی 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 سیکنڈ کے بعد ٹائم آؤٹ ہو جاتا ہے۔
