---
title: "Amazon Connectから接続"
description: "Amazon Connectの通話を、コンタクトIDとUUIを使用してSIP経由でThunderPhoneエージェントに送信し、エージェントの引き継ぎでフローを再開します。"
---

Amazon Connect フローは、コンタクトIDと設定した UUI をエージェントに送信します。エージェントが完了すると通話を切断し、フローが続行され、Lambda がコンタクトIDで引き継ぎ情報を取得します。

## 開始前に必要なもの

- ThunderPhone エージェントと組織の [API キー](/ja/guides/api-keys)。
- Amazon Connect の **外部音声転送** コネクタ。先に「アカウントごとの外部音声転送コネクタ」のクォータ引き上げをリクエストしてください。AWS による承認までメニューは表示されません。AWS は各コネクタに対して日額料金（[2025年7月21日以降は1日あたり$100](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/)）に加え、分単位の利用料金を請求します。

<Warning>
  AWS の現行管理ガイドには、外部音声転送に関するページがありません。
  構築を開始する前に、コネクタが対象のインスタンスとリージョンで利用可能か AWS に確認してください。
</Warning>

## 1. SIP エンドポイントを作成する

コネクタでは SIP ダイジェスト認証が文書化されていないため、送信元アドレスで通話を受け付けるエンドポイントを作成します。

```bash
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 で認証するプラットフォーム](/ja/guides/sip-addresses)
で、ルールと、プラットフォームのすべての顧客で共有されるアドレスのリスクを確認してください。応答の `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 はこれを16進数エンコードして送信します。
   - **切断後にフローを再開:** はい。これにより、エージェントが通話を切断したときにフローが続行されます。

Connect はコンタクトIDを `X-Amzn-ConnectContactId` で送信します。ThunderPhone はこれを通話の `external_call_id` として保存し、フローはこれを使用して後で通話を検索します。UUI は `{{sip_uui}}` としてプロンプトに渡されます。サードパーティ統合ではコンタクトIDヘッダーが文書化されていますが、AWS 自身のドキュメントには記載がないため、最初のテスト通話で確認してください。

## 3. 通話を戻す

AWS では、Connect が `BYE` のヘッダーを読み取る方法や、エージェントからの
`REFER` を受け入れる方法は文書化されていません。そのため、エージェントが通話を戻します。終了の挨拶をして通話を切ると、フローは転送ブロックの後から再開されます。次の転送番号を追加します（[転送番号を追加する](/ja/guides/contact-centers/overview)を参照）。

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

次に、転送後に **AWS Lambda 関数を呼び出す** ブロックを使用してハンドオフを取得します。Lambda はコンタクト ID で通話を検索します。

```python
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 などに暗号化して保存します。レスポンスフィールドについては、[ハンドオフされた通話を検索する](/api-reference/calls#look-up-a-handed-off-call)を参照してください。

## テストする

転送ブロックに到達する 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 秒後にタイムアウトします。
