---
title: "Amazon Connect இலிருந்து இணைக்கவும்"
description: "contact id மற்றும் UUI உடன் Amazon Connect அழைப்புகளை SIP வழியாக ThunderPhone ஏஜென்ட்டிற்கு அனுப்பி, ஏஜென்ட்டின் hand-off மூலம் உங்கள் flow-ஐத் தொடரவும்."
---

உங்கள் Amazon Connect flow, contact ID மற்றும் நீங்கள் அமைக்கும் எந்த UUI-உடனும் அழைப்பாளரை ஏஜென்ட்டிற்கு அனுப்பும். ஏஜென்ட் முடித்ததும், அது அழைப்பைத் துண்டிக்கும், உங்கள் flow தொடரும், மேலும் ஒரு Lambda contact ID மூலம் ஒப்படைப்பைப் பெறும்.

## தொடங்குவதற்கு முன்

- ஒரு ThunderPhone ஏஜென்ட் மற்றும் ஒரு நிறுவனம் [API விசை](/ta/guides/api-keys).
- Amazon Connect-இன் **வெளிப்புற குரல் பரிமாற்றம்** இணைப்பி. முதலில்
  "ஒரு கணக்கிற்கான வெளிப்புற குரல் பரிமாற்ற இணைப்பிகள்" quota அதிகரிப்பைக் கோருங்கள்: AWS அதை அங்கீகரிக்கும் வரை
  மெனு மறைந்தே இருக்கும். AWS ஒவ்வொரு இணைப்பிக்கும் ஒரு நாளுக்கு கட்டணம் வசூலிக்கும்
  ([$100 ஒரு நாள், July 21, 2025 முதல்](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  மற்றும் நிமிடப் பயன்பாட்டிற்கும் கூடுதல் கட்டணம் வசூலிக்கும்.

<Warning>
  AWS-இன் தற்போதைய நிர்வாக வழிகாட்டியில் வெளிப்புற குரல் பரிமாற்றத்திற்கான பக்கங்கள் இனி இல்லை.
  இதை அடிப்படையாகக் கொண்டு உருவாக்குவதற்கு முன், உங்கள் instance மற்றும் பிராந்தியத்திற்கு இந்த இணைப்பி கிடைக்கிறதா என்பதை
  AWS-இடம் உறுதிப்படுத்துங்கள்.
</Warning>

## 1. SIP endpoint-ஐ உருவாக்குங்கள்

இந்த இணைப்பி SIP digest அங்கீகாரத்தை ஆவணப்படுத்தவில்லை; எனவே மூல முகவரி மூலம் அழைப்புகளை ஏற்கும்
ஒரு endpoint-ஐ உருவாக்குங்கள்:

```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-இடமிருந்து பெறுங்கள். ஒவ்வொன்றும்
`/16` அல்லது அதைவிடக் குறுகலான பொது IPv4 வரம்பாக இருக்க வேண்டும் (IPv6 `/48` அல்லது அதைவிடக் குறுகலானது). விதிகள் மற்றும் தளத்தின்
ஒவ்வொரு வாடிக்கையாளரும் பகிரக்கூடிய முகவரியின் ஆபத்து பற்றிய விவரங்களுக்கு
[மூல IP மூலம் அங்கீகரிக்கும் தளங்கள்](/ta/guides/sip-addresses)
பார்க்கவும். பதிலில் உள்ள `sip_uri`-ஐ வைத்திருங்கள், உதாரணமாக
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. சூழலுடன் அழைப்புகளை அனுப்புங்கள்

1. Amazon Connect console-இல், **வெளிப்புற குரல் அமைப்புகள் → குரல்
   பரிமாற்ற ஒருங்கிணைப்புகள்** என்பதைத் திறந்து **உருவாக்கு** என்பதைத் தேர்ந்தெடுக்கவும்.
2. இலக்கு வகையை (ஒரு SBC) தேர்ந்தெடுத்து, host
   `sip.thunderphone.com`, port `5061`, மற்றும் TLS நெறிமுறையுடன் ஒரு வெளிச்செல்லும் route-ஐச் சேர்க்கவும். இந்த endpoint-க்கு
   TLS அல்லது TCP (port `5060`) தேவை; அது UDP-ஐ நிராகரிக்கும். இணைப்பி எந்த
   நெறிமுறைகளை வழங்குகிறது என்பதை AWS ஆவணப்படுத்தவில்லை; எனவே அவற்றில் ஒன்றைப் பயன்படுத்த முடியும் என்பதை
   AWS-இடம் உறுதிப்படுத்துங்கள்.
3. உங்கள் flow-இல், **தொலைபேசி எண்ணுக்கு பரிமாற்று** block-ஐச் சேர்த்து, **பரிமாற்று**
   என்பதை **வெளிப்புற குரல் அமைப்பு** என அமைக்கவும்; பின்னர் இதை அமைக்கவும்:
   - **இலக்கு ARN:** இணைப்பி.
   - **பயனருக்கு:** endpoint-இன் `sip_uri`-இல் உள்ள பயனர் பகுதி, உதாரணமாக
     `agent-12-jhxmginwjx`.
   - **UUI** (விருப்பமானது): ஏஜென்ட்டிற்கான சூழல். Connect இதை hex-encoded வடிவில் அனுப்பும்.
   - **இணைப்பு துண்டிக்கப்பட்ட பிறகு flow-ஐத் தொடரவும்:** ஆம், இதனால்
     ஏஜென்ட் அழைப்பைத் துண்டிக்கும்போது flow தொடரும்.

Connect, contact ID-ஐ `X-Amzn-ConnectContactId`-இல் அனுப்பும். ThunderPhone அதை அழைப்பின்
`external_call_id` ஆகச் சேமிக்கும்; இதன் மூலமே உங்கள் flow பின்னர் அழைப்பைக் கண்டறியும். UUI,
prompt-ஐ `{{sip_uui}}` ஆக அடையும். மூன்றாம் தரப்பு ஒருங்கிணைப்புகள் contact-ID header-ஐ
ஆவணப்படுத்துகின்றன; AWS-இன் சொந்த ஆவணங்கள் அவ்வாறு செய்யவில்லை, எனவே உங்கள் முதல்
சோதனை அழைப்பில் அதைச் சரிபார்க்கவும்.

## 3. அழைப்பை மீண்டும் பெறுங்கள்

`BYE`-இல் தலைப்புகளைப் படிக்கவோ அல்லது ஏஜென்டிடமிருந்து `REFER`-ஐ ஏற்கவோ Connect-க்கு வழி இல்லை என்று AWS ஆவணப்படுத்துகிறது. எனவே ஏஜென்ட் அழைப்பைத் திருப்பி அனுப்புகிறது: அது விடைபெற்று அழைப்பை முடிக்கிறது, மேலும் பரிமாற்றத் தொகுதிக்குப் பிறகு உங்கள் ஓட்டம் தொடர்கிறது. இந்தப் பரிமாற்ற எண்ணைச் சேர்க்கவும் ([பரிமாற்ற எண்ணைச் சேர்க்கவும்](/ta/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` தலைப்பு இரண்டிலும் இருக்க வேண்டும்.

## வரம்புகள்

- `X-TP-Handoff-Id` உட்பட `BYE`-இல் தலைப்புகளைப் படிப்பதற்கான வழியை AWS ஆவணப்படுத்தவில்லை; எனவே அழைப்புக்கான ஒரே இணைப்பு தொடர்பு அடையாளம்தான்.
- இணைப்பிக்கான அதிகபட்ச UUI நீளத்தை AWS ஆவணப்படுத்தவில்லை.
- ஒத்திசைவு Lambda தொகுதி 8 வினாடிகளுக்குப் பிறகு நேரம் முடிவடையும்.
