ThunderPhone v3、提供開始。セルフサービスで、1分あたり2セントから。発表内容を見る

Contact centers

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 チームによって構築されるため、独自に設定またはテストすることはできません。