ThunderPhone v3 現已上線。自助開通,價格低至每分鐘 2¢。查看公告

Contact centers

從 Amazon Connect 連接

透過 SIP 將 Amazon Connect 通話連同聯絡人 ID 及 UUI 傳送至 ThunderPhone 智能體,並以智能體的轉交結果繼續你的流程。

你的 Amazon Connect 流程會將來電者連同聯絡 ID 及你設定的任何 UUI 傳送至智能體。智能體完成後會掛線,流程隨即繼續,而 Lambda 會按聯絡 ID 擷取交接資料。

開始前

  • 一個 ThunderPhone 智能體及一組組織 API 金鑰。
  • Amazon Connect 的 外部語音轉接 連接器。請先申請提高「每個帳戶的外部語音轉接連接器」配額:在 AWS 批准前,選單會維持隱藏。AWS 會按日為每個連接器收費(自 2025 年 7 月 21 日起每日 $100),另加按分鐘計的使用費。

1. 建立 SIP 端點

連接器沒有說明 SIP 摘要驗證,因此請建立一個按來源位址接受來電的端點:

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

向 AWS 取得你所在區域的連接器 SIP 訊號範圍。每個範圍必須為 /16 或更小的公用 IPv4 範圍(IPv6 則為 /48 或更小)。請參閱 按來源 IP 驗證的平台 了解相關規則,以及平台所有客戶共用同一位址的風險。保留回應中的 sip_uri,例如 sip:agent-12-jhxmginwjx@sip.thunderphone.com。

2. 傳送附帶背景資料的來電

  1. 在 Amazon Connect 控制台中,開啟 外部語音系統 → 語音轉接整合,然後選擇 建立。
  2. 選擇目標類型(SBC),並新增一條外撥路由,主機設為 sip.thunderphone.com、連接埠設為 5061,通訊協定設為 TLS。端點需要 TLS 或 TCP(連接埠 5060),並會拒絕 UDP。AWS 沒有說明連接器提供哪些 通訊協定,因此請向 AWS 確認其可使用其中一種。
  3. 在你的流程中,新增 轉接至電話號碼 區塊,將 轉接至 設為 外部語音系統,然後設定:
    • 目標 ARN: 連接器。
    • 至用戶: 端點 sip_uri 的用戶部分,例如 agent-12-jhxmginwjx。
    • UUI(選填):提供予智能體的背景資料。Connect 會以十六進制編碼傳送。
    • 中斷連線後繼續流程: 是,讓流程在智能體掛線後繼續。

Connect 會在 X-Amzn-ConnectContactId 中傳送聯絡 ID。ThunderPhone 會將其儲存為通話的 external_call_id,讓你的流程可於稍後尋找該通話。UUI 會以 {{sip_uui}} 形式傳送至提示詞。第三方整合服務文件有記載聯絡 ID 標頭;AWS 自己的文件則沒有,因此請在首次測試通話時確認。

3. 接回通話

AWS 未有說明 Connect 如何讀取 BYE 上的標頭,亦未有說明如何接受來自智能體的 REFER。因此,智能體會交回通話:它會道別並掛線,而你的流程會在轉駁區塊後繼續。加入此轉駁號碼(參閱加入轉駁號碼):

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

然後,在轉駁後加入一個呼叫 AWS Lambda 函數區塊以擷取交接資料。Lambda 會按聯絡人 ID 查找通話:

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 "",
    }

此區塊會傳回扁平映射,因此流程可按 intent 分支,或將 summary 設為接聽通話人員的聯絡人屬性。以同步方式執行區塊(最多 8 秒),並將 API 金鑰加密儲存,例如儲存在 AWS Secrets Manager。回應欄位詳見查找已交接的通話。

測試

致電 Connect 執行個體中會到達轉駁區塊的號碼,要求智能體轉駁至真人,並確認流程會繼續執行。然後使用 GET /v1/calls/{call_id} 開啟通話:sip_headers 應列出 x-amzn-connectcontactid,而 external_call_id 應與 Lambda 接收的 ContactId 相同。如果轉駁因 SIP 404 失敗,ThunderPhone 未能找到端點的使用者部分:它必須同時出現在請求 URI 及 To 標頭中。

限制

  • AWS 未有說明如何讀取 BYE 上的標頭,包括 X-TP-Handoff-Id,因此聯絡人 ID 是連回該通話的唯一連結。
  • AWS 未有說明連接器的 UUI 長度上限。
  • 同步 Lambda 區塊會在 8 秒後逾時。