Open in
Zoom Contact Centerから接続
サードパーティの音声ボットコネクタを使用してZoom Contact Centerの通話をThunderPhoneエージェントに転送し、SIP REFERで人間のエージェントに戻します。
Zoom Contact Center フローの Bot ウィジェットは、Zoom のコール SID とともに発信者をエージェントへ送信します。発信者が担当者を必要とする場合、エージェントは Zoom の有人エージェントアドレスへ SIP REFER を送信し、フローはコール SID で引き継ぎを取得します。
開始前の準備
- ThunderPhone エージェントと組織の API キー。
- 管理者が管理し、Contact Center で利用可能にした Zoom Marketplace の一般アプリ。Bot ウィジェット用のコネクタを含めます (Zoom のサードパーティ音声ボットガイド)。
- Zoom からボットプロバイダーへの SIP トランク。Zoom の ISV チームが段階的に構築します(要件確認、ステージングトランク、本番)。アプリの会社名はトランクレコードと完全に一致している必要があります。この設定は Zoom アカウントだけで完結せず、ThunderPhone サポートと Zoom とともに開始します。
1. SIP エンドポイントを作成する
Zoom のコネクタは SIP アドレスではなく、999 で始まる 15 桁の番号へ発信します。コネクタを保存すると、この番号が生成されます。Zoom のトランクはポート 5061 で TLS 1.2 を使用し、音声には SRTP を使用します。また、パスワードではなく Zoom のサブネットによる許可リスト方式です。そのため、コネクタの番号をダイヤルイン番号として設定し、SRTP を必須にした ip_allowlist エンドポイントを作成します(電話番号へ発信するプラットフォームを参照)。
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 アドレスを使用して、この転送番号を追加します(転送番号を追加するを参照)。
{"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 ヘッダーを送信できることをアカウント内で確認してください。引き継がれた通話を検索するを参照してください。
テストする
ボットウィジェットに接続される番号へ通話し、エージェントに担当者へつなぐよう依頼します。発信者が人間のエージェントに接続され、ウィジェットが引き継ぎ情報を返すことを確認してください。次に、GET /v1/calls/{call_id} で通話を開きます。sip_headers に x-zoom-call-sid が表示され、external_call_id がフローで使用する通話 SID と一致している必要があります。
制限事項
- ThunderPhone はコネクターの静的 URL へ投稿しないため、Zoom は検索を通じて引き継ぎ情報を取得します。または、テストで Zoom が
REFERから読み取ることを確認できた場合は、マッピング済みヘッダーを通じて取得します。 - トランクは Zoom の ISV チームによって構築されるため、独自に設定またはテストすることはできません。