ThunderPhone v3 yayında.Hemen kendiniz kullanmaya başlayın; dakikası 2 sentten başlayan fiyatlarla.Duyuruyu okuyun

Contact centers

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

  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 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-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.