Open in
Amazon Connect
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ı.
- 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) ve ayrıca dakika başına kullanım ücreti uygular.
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:
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 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
- Amazon Connect konsolunda Harici Ses Sistemleri → Ses Aktarımı Entegrasyonları bölümünü açın ve Oluştur seçeneğini belirleyin.
- Hedef türünü (bir SBC) seçin ve
sip.thunderphone.comana bilgisayarı,5061bağlantı noktası ve TLS protokolüyle bir giden rota ekleyin. Uç nokta TLS veya TCP (5060bağ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. - 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-jhxmginwjxgibi uç noktanınsip_urideğ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 bölümüne bakın):
{"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:
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 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-Iddahil olmak üzereBYEü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.