---
title: "Zoom Contact Centerから接続"
description: "サードパーティの音声ボットコネクタを使用してZoom Contact Centerの通話をThunderPhoneエージェントに転送し、SIP REFERで人間のエージェントに戻します。"
---

Zoom Contact Center フローの Bot ウィジェットは、Zoom のコール SID とともに発信者をエージェントへ送信します。発信者が担当者を必要とする場合、エージェントは Zoom の有人エージェントアドレスへ SIP `REFER` を送信し、フローはコール SID で引き継ぎを取得します。

## 開始前の準備

- ThunderPhone エージェントと組織の [API キー](/ja/guides/api-keys)。
- 管理者が管理し、Contact Center で利用可能にした Zoom Marketplace の**一般アプリ**。Bot ウィジェット用のコネクタを含めます
  （[Zoom のサードパーティ音声ボットガイド](https://developers.zoom.us/docs/contact-center/library/guides/3p-voicebot/)）。
- Zoom からボットプロバイダーへの SIP トランク。Zoom の ISV チームが段階的に構築します（要件確認、ステージングトランク、本番）。アプリの会社名はトランクレコードと完全に一致している必要があります。この設定は Zoom アカウントだけで完結せず、ThunderPhone サポートと Zoom とともに開始します。

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

Zoom のコネクタは SIP アドレスではなく、`999` で始まる 15 桁の番号へ発信します。コネクタを保存すると、この番号が生成されます。Zoom のトランクはポート 5061 で TLS 1.2 を使用し、音声には SRTP を使用します。また、パスワードではなく Zoom のサブネットによる許可リスト方式です。そのため、コネクタの番号をダイヤルイン番号として設定し、SRTP を必須にした `ip_allowlist` エンドポイントを作成します（[電話番号へ発信するプラットフォーム](/ja/guides/sip-addresses)を参照）。

```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": "Zoom Contact Center",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["ZOOM_SIGNALLING_RANGE_1", "ZOOM_SIGNALLING_RANGE_2"],
    "dial_in_numbers": ["999123456789012"],
    "srtp": "required"
  }'
```

- `allowed_source_cidrs`: Zoom から提供される Zoom の SIP シグナリングサブネット。各範囲は `/16` 以上に限定されたパブリック IPv4 範囲である必要があります（IPv6 は `/48` 以上に限定）。
- `dial_in_numbers`: `+` を付けず、Zoom が送信する形式そのままのコネクタ番号。
- `srtp`: Zoom のトランクは常に SRTP を使用するため、`required`。

Zoom のアドレスはすべての顧客で共有されるため、別の Zoom 顧客がこの番号へ発信した場合も、設定したエージェントに到達します。番号は Zoom が割り当てるため、公開しないでください。

## 2. コンテキスト付きで通話を送信する

フローに **Bot** ウィジェットを追加し、コネクタにバインドします。Zoom の ISV チームに、トランクをポート 5061 の TLS を使用して `sip.thunderphone.com` へ向けるよう依頼してください。リクエスト URI と `To` ヘッダーの両方にコネクタ番号を設定します。エンドポイントは UDP を拒否するため、トランクが UDP にフォールバックしないようにしてください。

Zoom は次を送信します。

- `X-ZOOM-Call-Sid`: 通話の `external_call_id` として保存されます。Zoom 自身のデータマッピングページには記載されていませんが、別の AI プロバイダーの Zoom 連携ドキュメントには記載されています。最初のテスト通話で確認してください。
- `X-ZOOM-DNIS`: 発信者がダイヤルした番号。`{{sip_x_zoom_dnis}}` として保存されます。
- `X-ZOOM-WEBHOOK`: コネクタの静的 URL。

## 3. 通話を戻す

エージェントは、Zoom の SBC 上にある人間のエージェントのアドレスへ `REFER` を送信します。Zoom から提供された SBC アドレスを使用して、この転送番号を追加します（[転送番号を追加する](/ja/guides/contact-centers/overview)を参照）。

```json
{"name": "Zoom human agent", "number": "sip:HumanAgent@203.0.113.10:5061"}
```

Zoom のガイドでは、ボットがコンテキストを渡す方法として 2 つ説明されています。`REFER` の前にコネクターの静的 URL へ `POST` する方法（`voicebot_metadata` などのイベント）と、**Bot からの着信**でマッピングされた SIP ヘッダーです。ThunderPhone は静的 URL へ投稿しません。Zoom のガイドには、`REFER` からマッピング済みヘッダーを読み取るかどうかは記載されていません。試す場合は、エントリに `"X-Handoff-Id": "{{handoff_id}}"` などの `headers` を追加し、テスト通話で確認してください。また、メタデータの `POST` なしで `REFER` を受け入れることを Zoom に確認してください。

どちらにも依存せずに引き継ぎ情報を取得するには、ボットウィジェットの後で **HTTP Call** または **Script** ウィジェットを使用してフローから検索します。

- `GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=`
  の後に通話 SID を追加します。
- ヘッダー: `Authorization: Bearer sk_live_…`。
- `handoff.summary` と `handoff.intent` を使用して発信者を振り分け、通話を引き継ぐ担当者に情報を伝えます。

Zoom はこれらのウィジェットのフィールドレベルのドキュメントを公開していないため、ウィジェットが `Authorization` ヘッダーを送信できることをアカウント内で確認してください。[引き継がれた通話を検索する](/api-reference/calls#look-up-a-handed-off-call)を参照してください。

## テストする

ボットウィジェットに接続される番号へ通話し、エージェントに担当者へつなぐよう依頼します。発信者が人間のエージェントに接続され、ウィジェットが引き継ぎ情報を返すことを確認してください。次に、`GET /v1/calls/{call_id}` で通話を開きます。`sip_headers` に `x-zoom-call-sid` が表示され、`external_call_id` がフローで使用する通話 SID と一致している必要があります。

## 制限事項

- ThunderPhone はコネクターの静的 URL へ投稿しないため、Zoom は検索を通じて引き継ぎ情報を取得します。または、テストで Zoom が `REFER` から読み取ることを確認できた場合は、マッピング済みヘッダーを通じて取得します。
- トランクは Zoom の ISV チームによって構築されるため、独自に設定またはテストすることはできません。
