---
title: "Amazon Connect నుండి కనెక్ట్ చేయండి"
description: "కాంటాక్ట్ ID మరియు UUIతో Amazon Connect కాల్‌లను SIP ద్వారా ThunderPhone ఏజెంట్‌కు పంపి, ఏజెంట్ హ్యాండ్-ఆఫ్‌తో మీ ఫ్లోను కొనసాగించండి."
---

మీ Amazon Connect ఫ్లో, కాలర్‌ను కాంటాక్ట్ ID మరియు మీరు సెట్ చేసిన ఏవైనా UUIతో ఏజెంట్‌కు పంపుతుంది. ఏజెంట్ పని పూర్తిచేసినప్పుడు, అది కాల్‌ను ముగిస్తుంది, మీ ఫ్లో కొనసాగుతుంది, మరియు ఒక Lambda కాంటాక్ట్ ID ద్వారా హ్యాండ్-ఆఫ్‌ను పొందుతుంది.

## ప్రారంభించే ముందు

- ఒక ThunderPhone ఏజెంట్ మరియు ఒక సంస్థ [API కీ](/te/guides/api-keys).
- Amazon Connect యొక్క **బాహ్య వాయిస్ బదిలీ** కనెక్టర్. ముందుగా "ఖాతాకు బాహ్య వాయిస్ బదిలీ కనెక్టర్లు" కోటా పెంపుదలను అభ్యర్థించండి: AWS ఆమోదించే వరకు మెను కనిపించదు. AWS ప్రతి కనెక్టర్‌కు రోజుకు ఛార్జ్ చేస్తుంది
  ([జూలై 21, 2025 నుండి రోజుకు $100](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  మరియు ప్రతి నిమిషం వినియోగ ఛార్జీలు అదనం.

<Warning>
  AWS ప్రస్తుత అడ్మిన్ గైడ్‌లో బాహ్య వాయిస్ బదిలీకి సంబంధించిన పేజీలు ఇక లేవు.
  దీనిపై నిర్మించే ముందు, కనెక్టర్ మీ ఇన్‌స్టాన్స్ మరియు Region కోసం అందుబాటులో ఉందని 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"]
  }'
```

మీ Region కోసం కనెక్టర్ యొక్క SIP సిగ్నలింగ్ పరిధులను AWS నుండి పొందండి. ప్రతి దానీ
`/16` లేదా దాని కంటే సన్నని పబ్లిక్ IPv4 పరిధి అయి ఉండాలి (IPv6 కోసం `/48` లేదా దాని కంటే సన్ననిది). నియమాలు మరియు ప్లాట్‌ఫారమ్‌లోని ప్రతి కస్టమర్ పంచుకునే చిరునామా వల్ల కలిగే ప్రమాదం కోసం
[సోర్స్ IP ద్వారా ప్రమాణీకరించే ప్లాట్‌ఫారమ్‌లు](/te/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}}`గా prompt‌కు చేరుతుంది. మూడవ పక్ష ఇంటిగ్రేషన్‌లు కాంటాక్ట్-ID హెడర్‌ను డాక్యుమెంట్ చేస్తాయి; AWS స్వంత డాక్యుమెంటేషన్‌లో అది లేదు, కాబట్టి మీ మొదటి పరీక్ష కాల్‌లో దాన్ని పరిశీలించండి.

## 3. కాల్‌ను తిరిగి పొందండి

`BYE`లో హెడర్‌లను చదవడానికి లేదా ఏజెంట్ నుండి `REFER`ను స్వీకరించడానికి Connectలో మార్గం లేదని AWS డాక్యుమెంట్ చేస్తుంది. కాబట్టి ఏజెంట్ కాల్‌ను తిరిగి పంపుతుంది: వీడ్కోలు చెప్పి కాల్‌ను ముగిస్తుంది, ఆపై ట్రాన్స్‌ఫర్ బ్లాక్ తర్వాత మీ ఫ్లో కొనసాగుతుంది. ఈ ట్రాన్స్‌ఫర్ నంబర్‌ను జోడించండి ([ట్రాన్స్‌ఫర్ నంబర్‌ను జోడించండి](/te/guides/contact-centers/overview) చూడండి):

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

తర్వాత ట్రాన్స్‌ఫర్ అనంతరం **AWS Lambda ఫంక్షన్‌ను ఇన్వోక్ చేయండి** బ్లాక్‌తో హ్యాండ్-ఆఫ్‌ను పొందండి. Lambda కాంటాక్ట్ ID ద్వారా కాల్‌ను వెతుకుతుంది:

```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 డాక్యుమెంట్ చేస్తుంది, కాబట్టి కాల్‌కు తిరిగి ఉన్న ఏకైక లింక్ కాంటాక్ట్ ID మాత్రమే.
- కనెక్టర్ కోసం గరిష్ఠ UUI పొడవును AWS డాక్యుమెంట్ చేయదు.
- సింక్రోనస్ Lambda బ్లాక్ 8 సెకన్ల తర్వాత టైమ్ అవుట్ అవుతుంది.
