---
title: "Amazon Connect ਤੋਂ ਕਨੈਕਟ ਕਰੋ"
description: "Amazon Connect ਕਾਲਾਂ ਨੂੰ contact id ਅਤੇ UUI ਸਮੇਤ SIP ਰਾਹੀਂ ThunderPhone ਏਜੰਟ ਨੂੰ ਭੇਜੋ, ਅਤੇ ਏਜੰਟ ਦੇ hand-off ਨਾਲ ਆਪਣਾ ਫਲੋ ਮੁੜ ਸ਼ੁਰੂ ਕਰੋ।"
---

ਤੁਹਾਡਾ Amazon Connect ਫਲੋ ਕਾਲਰ ਨੂੰ contact id ਅਤੇ ਤੁਹਾਡੇ ਵੱਲੋਂ ਸੈੱਟ ਕੀਤਾ ਕੋਈ ਵੀ UUI ਦੇ ਨਾਲ ਏਜੰਟ ਕੋਲ ਭੇਜਦਾ ਹੈ। ਜਦੋਂ ਏਜੰਟ ਦਾ ਕੰਮ ਮੁੱਕ ਜਾਂਦਾ ਹੈ, ਉਹ ਕਾਲ ਬੰਦ ਕਰ ਦਿੰਦਾ ਹੈ, ਤੁਹਾਡਾ ਫਲੋ ਜਾਰੀ ਰਹਿੰਦਾ ਹੈ, ਅਤੇ ਇੱਕ Lambda contact id ਰਾਹੀਂ ਹੈਂਡ-ਆਫ਼ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।

## ਸ਼ੁਰੂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ

- ਇੱਕ ThunderPhone ਏਜੰਟ ਅਤੇ ਇੱਕ ਸੰਗਠਨ ਦੀ [API ਕੁੰਜੀ](/pa/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 ਤੋਂ ਪ੍ਰਾਪਤ ਕਰੋ। ਹਰੇਕ
`/16` ਜਾਂ ਇਸ ਤੋਂ ਸੰਕੁਚਿਤ ਜਨਤਕ IPv4 ਰੇਂਜ ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ (IPv6 `/48` ਜਾਂ ਇਸ ਤੋਂ ਸੰਕੁਚਿਤ)। ਨਿਯਮਾਂ ਅਤੇ ਪਲੇਟਫਾਰਮ ਦੇ ਹਰੇਕ ਗਾਹਕ ਵੱਲੋਂ ਸਾਂਝੇ ਕੀਤੇ ਪਤੇ ਦੇ ਜੋਖਮ ਲਈ
[ਉਹ ਪਲੇਟਫਾਰਮ ਜੋ ਸਰੋਤ IP ਰਾਹੀਂ ਪ੍ਰਮਾਣਿਤ ਕਰਦੇ ਹਨ](/pa/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` ਵਿੱਚ contact id ਭੇਜਦਾ ਹੈ। ThunderPhone ਇਸਨੂੰ ਕਾਲ ਦੇ `external_call_id` ਵਜੋਂ ਸਟੋਰ ਕਰਦਾ ਹੈ, ਜਿਸ ਰਾਹੀਂ ਤੁਹਾਡਾ ਫਲੋ ਬਾਅਦ ਵਿੱਚ ਕਾਲ ਲੱਭਦਾ ਹੈ। UUI prompt ਤੱਕ `{{sip_uui}}` ਵਜੋਂ ਪਹੁੰਚਦਾ ਹੈ। ਤੀਜੀ-ਧਿਰ ਇੰਟੀਗ੍ਰੇਸ਼ਨ contact-id ਹੈਡਰ ਨੂੰ ਦਸਤਾਵੇਜ਼ਬੱਧ ਕਰਦੀਆਂ ਹਨ; AWS ਦੇ ਆਪਣੇ ਦਸਤਾਵੇਜ਼ ਨਹੀਂ ਕਰਦੇ, ਇਸ ਲਈ ਆਪਣੀ ਪਹਿਲੀ ਟੈਸਟ ਕਾਲ ਵਿੱਚ ਇਸਦੀ ਜਾਂਚ ਕਰੋ।

## 3. ਕਾਲ ਦੀ ਜਾਣਕਾਰੀ ਵਾਪਸ ਲਵੋ

AWS ਨੇ ਇਹ ਨਹੀਂ ਦੱਸਿਆ ਕਿ Connect `BYE` ਉੱਤੇ ਹੈਡਰ ਕਿਵੇਂ ਪੜ੍ਹ ਸਕਦਾ ਹੈ ਜਾਂ
ਏਜੰਟ ਤੋਂ `REFER` ਕਿਵੇਂ ਸਵੀਕਾਰ ਕਰ ਸਕਦਾ ਹੈ। ਇਸ ਲਈ ਏਜੰਟ ਕਾਲ ਵਾਪਸ ਕਰਦਾ ਹੈ: ਉਹ
ਵਿਦਾ ਕਹਿ ਕੇ ਕਾਲ ਕੱਟ ਦਿੰਦਾ ਹੈ ਅਤੇ ਤੁਹਾਡਾ ਫਲੋ ਟ੍ਰਾਂਸਫਰ ਬਲਾਕ ਤੋਂ ਬਾਅਦ ਮੁੜ ਸ਼ੁਰੂ ਹੁੰਦਾ ਹੈ। ਇਹ ਟ੍ਰਾਂਸਫਰ
ਨੰਬਰ ਜੋੜੋ ([ਟ੍ਰਾਂਸਫਰ ਨੰਬਰ ਜੋੜੋ](/pa/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` ਉਸ `ContactId`
ਦੇ ਬਰਾਬਰ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ ਜੋ ਤੁਹਾਡੇ Lambda ਨੂੰ ਮਿਲਦਾ ਹੈ। ਜੇ ਟ੍ਰਾਂਸਫਰ SIP `404` ਨਾਲ ਅਸਫਲ ਹੁੰਦਾ ਹੈ,
ਤਾਂ ThunderPhone ਨੂੰ ਐਂਡਪੌਇੰਟ ਦਾ ਯੂਜ਼ਰ ਭਾਗ ਨਹੀਂ ਮਿਲਿਆ: ਇਹ ਬੇਨਤੀ URI ਅਤੇ `To`
ਹੈਡਰ, ਦੋਵਾਂ ਵਿੱਚ ਹੋਣਾ ਲਾਜ਼ਮੀ ਹੈ।

## ਸੀਮਾਵਾਂ

- AWS ਨੇ `BYE` ਉੱਤੇ, ਜਿਸ ਵਿੱਚ `X-TP-Handoff-Id` ਵੀ ਸ਼ਾਮਲ ਹੈ, ਹੈਡਰ ਪੜ੍ਹਨ ਦਾ ਕੋਈ ਤਰੀਕਾ ਨਹੀਂ ਦੱਸਿਆ,
  ਇਸ ਲਈ ਸੰਪਰਕ id ਹੀ ਕਾਲ ਨਾਲ ਵਾਪਸ ਜੋੜਨ ਦਾ ਇੱਕੋ-ਇੱਕ ਲਿੰਕ ਹੈ।
- AWS ਨੇ ਕਨੈਕਟਰ ਲਈ ਵੱਧ ਤੋਂ ਵੱਧ UUI ਲੰਬਾਈ ਬਾਰੇ ਕੋਈ ਦਸਤਾਵੇਜ਼ ਨਹੀਂ ਦਿੱਤਾ।
- ਇੱਕ ਸਮਕਾਲੀ Lambda ਬਲਾਕ 8 ਸਕਿੰਟਾਂ ਬਾਅਦ ਟਾਈਮ ਆਉਟ ਹੋ ਜਾਂਦਾ ਹੈ।
