Open in
Amazon Connectから接続
Amazon Connectの通話を、コンタクトIDとUUIを使用してSIP経由でThunderPhoneエージェントに送信し、エージェントの引き継ぎでフローを再開します。
Amazon Connect フローは、コンタクトIDと設定した UUI をエージェントに送信します。エージェントが完了すると通話を切断し、フローが続行され、Lambda がコンタクトIDで引き継ぎ情報を取得します。
開始前に必要なもの
- ThunderPhone エージェントと組織の API キー。
- Amazon Connect の 外部音声転送 コネクタ。先に「アカウントごとの外部音声転送コネクタ」のクォータ引き上げをリクエストしてください。AWS による承認までメニューは表示されません。AWS は各コネクタに対して日額料金(2025年7月21日以降は1日あたり$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"]
}'対象リージョンのコネクタ用 SIP シグナリング範囲を AWS から取得します。各範囲は、パブリック IPv4 の /16 以下、または IPv6 の /48 以下である必要があります。送信元 IP で認証するプラットフォーム
で、ルールと、プラットフォームのすべての顧客で共有されるアドレスのリスクを確認してください。応答の sip_uri を保持します。例:
sip:agent-12-jhxmginwjx@sip.thunderphone.com。
2. コンテキスト付きで通話を送信する
- Amazon Connect コンソールで 外部音声システム → 音声転送統合 を開き、作成 を選択します。
- 宛先タイプとして SBC を選択し、ホスト
sip.thunderphone.com、ポート5061、プロトコル TLS のアウトバウンドルートを追加します。エンドポイントには TLS または TCP(ポート5060)が必要で、UDP は受け付けません。AWS はコネクタで利用可能なプロトコルを文書化していないため、いずれかを使用できることを AWS に確認してください。 - フローに 電話番号に転送 ブロックを追加し、転送先 を 外部音声システム に設定して、次を指定します。
- 宛先 ARN: コネクタ。
- 宛先ユーザー: エンドポイントの
sip_uriのユーザー部分。例:agent-12-jhxmginwjx。 - UUI(任意): エージェント向けのコンテキスト。Connect はこれを16進数エンコードして送信します。
- 切断後にフローを再開: はい。これにより、エージェントが通話を切断したときにフローが続行されます。
Connect はコンタクトIDを X-Amzn-ConnectContactId で送信します。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 では、
X-TP-Handoff-Idを含むBYEのヘッダーを読み取る方法は文書化されていないため、コンタクト ID が通話に戻る唯一のリンクです。 - AWS では、コネクタの UUI の最大長は文書化されていません。
- 同期 Lambda ブロックは 8 秒後にタイムアウトします。