---
title: "Amazon Connect'ten bağlanın"
description: "Amazon Connect çağrılarını, iletişim kimliği ve UUI ile SIP üzerinden bir ThunderPhone yapay zeka ajanına gönderin ve ajanın aktarımıyla akışınıza devam edin."
---

Amazon Connect akışınız, arayanı iletişim kimliği ve ayarladığınız tüm UUI'lerle sesli AI ajanına gönderir. Ajan işi bittiğinde görüşmeyi sonlandırır, akışınız devam eder ve Lambda iletişim kimliğine göre aktarım bilgilerini alır.

## Başlamadan önce

- Bir ThunderPhone yapay zeka ajanı ve kuruluşunuzun [API anahtarı](/tr/guides/api-keys).
- Amazon Connect'in **Harici ses aktarımı** bağlayıcısı. Önce "Hesap başına harici ses aktarımı bağlayıcısı" kota artışını talep edin: AWS onaylayana kadar menü gizli kalır. AWS, her bağlayıcı için günlük ücret alır
  ([21 Temmuz 2025'ten beri günlük $100](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  ve ayrıca dakika başına kullanım ücreti uygular.

<Warning>
  AWS'nin güncel yönetici kılavuzunda artık harici ses aktarımı sayfaları bulunmuyor.
  Buna dayalı geliştirme yapmadan önce bağlayıcının örneğiniz ve Bölgeniz için kullanılabilir olduğunu AWS ile doğrulayın.
</Warning>

## 1. SIP uç noktasını oluşturun

Bağlayıcı SIP özet kimlik doğrulamasını belgelemez; bu nedenle çağrıları kaynak adresine göre kabul eden bir uç nokta oluşturun:

```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"]
  }'
```

Bölgeniz için bağlayıcının SIP sinyalleşme aralıklarını AWS'den alın. Her biri `/16` veya daha dar bir genel IPv4 aralığı (IPv6 için `/48` veya daha dar) olmalıdır. Kurallar ve platformun tüm müşterilerinin paylaştığı bir adresin riski için [kaynak IP'ye göre kimlik doğrulayan platformlar](/tr/guides/sip-addresses) bölümüne bakın. Örneğin `sip:agent-12-jhxmginwjx@sip.thunderphone.com` gibi yanıttaki `sip_uri` değerini saklayın.

## 2. Çağrıları bağlamla gönderin

1. Amazon Connect konsolunda **Harici Ses Sistemleri → Ses Aktarımı Entegrasyonları** bölümünü açın ve **Oluştur** seçeneğini belirleyin.
2. Hedef türünü (bir SBC) seçin ve `sip.thunderphone.com` ana bilgisayarı, `5061` bağlantı noktası ve TLS protokolüyle bir giden rota ekleyin. Uç nokta TLS veya TCP (`5060` bağlantı noktası) gerektirir ve UDP'yi reddeder. AWS, bağlayıcının sunduğu protokolleri belgelemez; bu nedenle bunlardan birini kullanabildiğini AWS ile doğrulayın.
3. Akışınıza **Telefon numarasına aktar** bloğu ekleyin, **Şuraya aktar** seçeneğini **Harici ses sistemi** olarak ayarlayın ve şunları yapılandırın:
   - **Hedef ARN:** bağlayıcı.
   - **Kullanıcı:** `agent-12-jhxmginwjx` gibi uç noktanın `sip_uri` değerindeki kullanıcı bölümü.
   - **UUI** (isteğe bağlı): ajan için bağlam. Connect bunu onaltılık kodlanmış olarak gönderir.
   - **Bağlantı kesildikten sonra akışı sürdür:** Evet; böylece ajan görüşmeyi sonlandırdığında akış devam eder.

Connect, iletişim kimliğini `X-Amzn-ConnectContactId` içinde gönderir. ThunderPhone bunu çağrının `external_call_id` değeri olarak saklar; akışınızın çağrıyı daha sonra bulmasını sağlayan değer budur. UUI, isteme `{{sip_uui}}` olarak ulaşır. Üçüncü taraf entegrasyonları iletişim kimliği üst bilgisini belgeler; AWS'nin kendi belgeleri bunu belirtmez, bu nedenle ilk test çağrınızda kontrol edin.

## 3. Çağrıyı geri alın

AWS, Connect'in `BYE` üzerindeki üst bilgileri okuması veya ajandan gelen bir
`REFER` isteğini kabul etmesi için herhangi bir yöntem belgelemez. Bu nedenle
ajan çağrıyı geri verir: vedalaşır ve kapatır; akışınız aktarım bloğundan sonra
devam eder. Bu aktarım numarasını ekleyin ([Aktarım numarasını ekleyin](/tr/guides/contact-centers/overview) bölümüne bakın):

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

Ardından, aktarımın sonrasına bir **AWS Lambda işlevini çağır** bloğu ekleyerek
çağrı devrini alın. Lambda, çağrıyı kişi kimliğine göre arar:

```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 "",
    }
```

Blok düz bir eşleme döndürür; böylece akış `intent` değerine göre dallanabilir
veya çağrıyı devralan kişi için `summary` değerini kişi özniteliği olarak
ayarlayabilir. Bloğu eşzamanlı olarak çalıştırın (en fazla 8 saniye) ve API
anahtarını örneğin AWS Secrets Manager içinde şifrelenmiş olarak saklayın.
Yanıt alanları [Devredilen bir çağrıyı arayın](/api-reference/calls#look-up-a-handed-off-call) bölümünde açıklanmıştır.

## Test edin

Aktarım bloğuna ulaşan Connect örneğinizdeki bir numarayı arayın, ajandan bir
kişiyle görüşmek isteyin ve akışın devam ettiğini kontrol edin. Ardından çağrıyı
`GET /v1/calls/{call_id}` ile açın: `sip_headers`,
`x-amzn-connectcontactid` değerini listelemeli ve `external_call_id`, Lambda
işlevinizin aldığı `ContactId` değeriyle eşleşmelidir. Aktarım SIP `404` ile
başarısız olursa ThunderPhone uç noktanın kullanıcı bölümünü bulamamıştır: bu
bölüm hem istek URI'sinde hem de `To` üst bilgisinde bulunmalıdır.

## Sınırlar

- AWS, `X-TP-Handoff-Id` dahil olmak üzere `BYE` üzerindeki üst bilgileri okumak
  için herhangi bir yöntem belgelemez; bu nedenle kişi kimliği çağrıya geri
  bağlanan tek bağlantıdır.
- AWS, bağlayıcı için maksimum bir UUI uzunluğu belgelemez.
- Eşzamanlı bir Lambda bloğu 8 saniye sonra zaman aşımına uğrar.
