---
title: "Hubungkan dari Amazon Connect"
description: "Kirim panggilan Amazon Connect ke agen ThunderPhone melalui SIP dengan ID kontak dan UUI, lalu lanjutkan kembali alur Anda dengan hand-off agen."
---

Alur Amazon Connect Anda mengirim penelepon ke agen dengan ID kontak dan
UUI apa pun yang Anda tetapkan. Setelah agen selesai, agen mengakhiri panggilan, alur Anda berlanjut, dan
Lambda mengambil handoff berdasarkan ID kontak.

## Sebelum memulai

- Agen ThunderPhone dan [kunci API](/id/guides/api-keys) organisasi.
- Konektor **Transfer suara eksternal** Amazon Connect. Minta peningkatan kuota
  "External voice transfer connectors per account" terlebih dahulu: menu tetap tersembunyi hingga AWS menyetujuinya. AWS menagih setiap konektor per hari
  ([$100 per hari sejak 21 Juli 2025](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  ditambah penggunaan per menit.

<Warning>
  Panduan admin AWS saat ini tidak lagi memiliki halaman untuk transfer suara eksternal.
  Sebelum menggunakannya, konfirmasikan dengan AWS bahwa konektor tersedia untuk
  instance dan Region Anda.
</Warning>

## 1. Buat endpoint SIP

Konektor tidak mendokumentasikan autentikasi digest SIP, jadi buat
endpoint yang menerima panggilan berdasarkan alamat sumber:

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

Dapatkan rentang pensinyalan SIP konektor untuk Region Anda dari AWS. Setiap rentang harus
merupakan rentang IPv4 publik `/16` atau lebih sempit (IPv6 `/48` atau lebih sempit). Lihat
[Platform yang melakukan autentikasi berdasarkan IP sumber](/id/guides/sip-addresses)
untuk aturan serta risiko alamat yang dibagikan oleh setiap pelanggan
platform. Simpan `sip_uri` dari respons, misalnya
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Kirim panggilan dengan konteks

1. Di konsol Amazon Connect, buka **Sistem Suara Eksternal → Integrasi
   Transfer Suara** lalu pilih **Buat**.
2. Pilih jenis tujuan (SBC) dan tambahkan rute keluar dengan host
   `sip.thunderphone.com`, port `5061`, dan protokol TLS. Endpoint memerlukan
   TLS atau TCP (port `5060`) dan menolak UDP. AWS tidak mendokumentasikan protokol
   yang ditawarkan konektor, jadi konfirmasikan dengan AWS bahwa konektor dapat menggunakan salah satu
   protokol tersebut.
3. Dalam alur Anda, tambahkan blok **Transfer ke nomor telepon** dengan **Transfer ke**
   diatur ke **Sistem suara eksternal**, lalu tetapkan:
   - **ARN Tujuan:** konektor.
   - **Ke Pengguna:** bagian pengguna dari `sip_uri` endpoint, seperti
     `agent-12-jhxmginwjx`.
   - **UUI** (opsional): konteks untuk agen. Connect mengirimkannya dalam encoding heksadesimal.
   - **Lanjutkan alur setelah terputus:** Ya, agar alur berlanjut saat
     agen mengakhiri panggilan.

Connect mengirim ID kontak dalam `X-Amzn-ConnectContactId`. ThunderPhone menyimpannya
sebagai `external_call_id` panggilan, yang digunakan alur Anda untuk menemukan panggilan
nantinya. UUI mencapai Prompt sebagai `{{sip_uui}}`. Integrasi pihak ketiga
mendokumentasikan header ID kontak; dokumentasi AWS sendiri tidak, jadi periksa
pada panggilan uji pertama Anda.

## 3. Dapatkan kembali panggilan

AWS tidak mendokumentasikan cara bagi Connect untuk membaca header pada `BYE` atau menerima
`REFER` dari agen. Jadi agen mengembalikan panggilan: agen mengucapkan selamat tinggal dan
menutup panggilan, lalu alur Anda dilanjutkan setelah blok transfer. Tambahkan nomor transfer
ini (lihat [Tambahkan nomor transfer](/id/guides/contact-centers/overview)):

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

Kemudian ambil data serah-terima dengan blok **Panggil fungsi AWS Lambda** setelah
transfer. Lambda mencari panggilan berdasarkan id kontak:

```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 tersebut mengembalikan peta datar, sehingga alur dapat bercabang berdasarkan `intent` atau menetapkan
`summary` sebagai atribut kontak untuk orang yang menerima panggilan. Jalankan
blok secara sinkron (hingga 8 detik) dan simpan API key dalam keadaan terenkripsi, misalnya
di AWS Secrets Manager. Kolom respons tersedia di
[Cari panggilan yang diserahterimakan](/api-reference/calls#look-up-a-handed-off-call).

## Uji

Hubungi nomor pada instance Connect Anda yang mencapai blok transfer, minta agen
untuk menghubungkan Anda ke seseorang, dan periksa bahwa alur dilanjutkan. Kemudian buka panggilan dengan
`GET /v1/calls/{call_id}`: `sip_headers` harus mencantumkan
`x-amzn-connectcontactid`, dan `external_call_id` harus sama dengan `ContactId`
yang diterima Lambda Anda. Jika transfer gagal dengan SIP `404`, ThunderPhone tidak
menemukan bagian pengguna endpoint: bagian tersebut harus ada di URI permintaan dan header `To`.

## Batasan

- AWS tidak mendokumentasikan cara untuk membaca header pada `BYE`, termasuk
  `X-TP-Handoff-Id`, sehingga id kontak adalah satu-satunya tautan kembali ke panggilan.
- AWS tidak mendokumentasikan panjang UUI maksimum untuk konektor.
- Blok Lambda sinkron mengalami waktu habis setelah 8 detik.
