ThunderPhone v3 kini tersedia.Gunakan langsung secara mandiri, mulai 2¢/menit.Baca pengumumannya

Contact centers

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

  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):

{"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, 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.