Open in
Hubungkan dari Amazon Connect
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 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) ditambah penggunaan per menit.
1. Buat endpoint SIP
Konektor tidak mendokumentasikan autentikasi digest SIP, jadi buat endpoint yang menerima panggilan berdasarkan alamat sumber:
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
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
- Di konsol Amazon Connect, buka Sistem Suara Eksternal → Integrasi Transfer Suara lalu pilih Buat.
- Pilih jenis tujuan (SBC) dan tambahkan rute keluar dengan host
sip.thunderphone.com, port5061, dan protokol TLS. Endpoint memerlukan TLS atau TCP (port5060) dan menolak UDP. AWS tidak mendokumentasikan protokol yang ditawarkan konektor, jadi konfirmasikan dengan AWS bahwa konektor dapat menggunakan salah satu protokol tersebut. - 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_uriendpoint, sepertiagent-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):
{"name": "Amazon Connect", "action": "return"}Kemudian ambil data serah-terima dengan blok Panggil fungsi AWS Lambda setelah transfer. Lambda mencari panggilan berdasarkan id kontak:
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.
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, termasukX-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.