---
title: "Amazon Connect वरून कनेक्ट करा"
description: "संपर्क आयडी आणि UUI सह Amazon Connect कॉल्स SIP द्वारे ThunderPhone एजंटकडे पाठवा आणि एजंटच्या हँड-ऑफसह तुमचा फ्लो पुन्हा सुरू करा."
---

तुमचा Amazon Connect फ्लो कॉलरला कॉन्टॅक्ट आयडी आणि तुम्ही सेट केलेल्या
कोणत्याही UUI सह एजंटकडे पाठवतो. एजंटचे काम पूर्ण झाल्यावर तो कॉल संपवतो, तुमचा
फ्लो पुढे सुरू राहतो आणि Lambda कॉन्टॅक्ट आयडीद्वारे हँड-ऑफ मिळवते.

## सुरू करण्यापूर्वी

- ThunderPhone एजंट आणि संस्थेची [API की](/mr/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 कडून पुष्टी करा.
</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"]
  }'
```

तुमच्या प्रदेशासाठी कनेक्टरच्या SIP सिग्नलिंग श्रेणी AWS कडून मिळवा. प्रत्येक श्रेणी
सार्वजनिक IPv4 ची `/16` किंवा त्याहून अरुंद श्रेणी (IPv6 ची `/48` किंवा त्याहून अरुंद)
असणे आवश्यक आहे. नियमांसाठी आणि प्लॅटफॉर्मच्या प्रत्येक ग्राहकासोबत सामायिक असलेल्या
पत्त्याच्या धोक्यासाठी
[स्रोत IP द्वारे प्रमाणीकरण करणारे प्लॅटफॉर्म](/mr/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 `X-Amzn-ConnectContactId` मध्ये कॉन्टॅक्ट आयडी पाठवते. ThunderPhone तो
कॉलच्या `external_call_id` म्हणून जतन करते, ज्याद्वारे तुमचा फ्लो नंतर कॉल शोधतो.
UUI prompt पर्यंत `{{sip_uui}}` म्हणून पोहोचते. तृतीय-पक्ष इंटिग्रेशन्स
कॉन्टॅक्ट-आयडी हेडरचे दस्तऐवजीकरण करतात; AWS चे स्वतःचे दस्तऐवज तसे करत नाहीत,
म्हणून तुमच्या पहिल्या चाचणी कॉलमध्ये ते तपासा.

## 3. कॉल परत मिळवा

AWS मध्ये Connect ला `BYE` वरील हेडर वाचण्याचा किंवा एजंटकडून `REFER` स्वीकारण्याचा कोणताही मार्ग दस्तऐवजीकृत नाही. त्यामुळे एजंट कॉल परत करतो: तो निरोप देतो आणि कॉल बंद करतो, आणि ट्रान्सफर ब्लॉकनंतर तुमचा फ्लो पुन्हा सुरू होतो. हा ट्रान्सफर नंबर जोडा ([ट्रान्सफर नंबर जोडा](/mr/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 मध्ये `X-TP-Handoff-Id` सह `BYE` वरील हेडर वाचण्याचा कोणताही मार्ग दस्तऐवजीकृत नाही, त्यामुळे कॉन्टॅक्ट आयडी हाच कॉलशी परत जोडणारा एकमेव दुवा आहे.
- AWS मध्ये कनेक्टरसाठी कमाल UUI लांबी दस्तऐवजीकृत नाही.
- सिंक्रोनस Lambda ब्लॉक 8 सेकंदांनंतर टाइम आउट होतो.
