build-zoom-contact-center-app

/build-zoom-contact-center-app

アプリ、Web、ネイティブモバイルの各サーフェスにおける Zoom Contact Center 連携の背景情報です。

以下における Zoom Contact Center の実装ガイダンスです。

• Zoom クライアント内の Contact Center アプリ（Zoom Apps SDK の経路）
• Web チャネルへの埋め込み（チャット／ビデオ／キャンペーン）
• ネイティブモバイル SDK（Android／iOS）

公式ドキュメント：

• https://developers.zoom.us/docs/contact-center/
• https://developers.zoom.us/docs/contact-center/web/sdk-reference/
• https://marketplacefront.zoom.us/sdk/contact/android/index.html
• https://marketplacefront.zoom.us/sdk/contact/ios/index.html

ルーティングのガードレール

• ユーザーが Zoom Contact Center デスクトップクライアント内のアプリを構築する場合は、Zoom Apps SDK の経路を使用し、このスキルと zoom-apps-sdk を使ってください。
• Web サイトにチャット／ビデオウィジェットを埋め込む場合は、web/SKILL.md に案内してください。
• ネイティブ Android または iOS SDK のバイナリを統合する場合は、android/SKILL.md または ios/SKILL.md に案内してください。
• Contact Center の通話制御またはキュー API が必要な場合は、../rest-api/SKILL.md と組み合わせてください。

クイックリンク

こちらから始めてください：

1. concepts/architecture-and-lifecycle.md
2. scenarios/high-level-scenarios.md
3. references/forum-top-questions.md
4. references/versioning-and-compatibility.md
5. references/samples-validation.md
6. references/environment-variables.md
7. troubleshooting/common-drift-and-breaks.md
8. RUNBOOK.md

プラットフォーム別スキル：

• android/SKILL.md
• ios/SKILL.md
• web/SKILL.md

ドキュメント構成

contact-center/
├── SKILL.md
├── RUNBOOK.md
├── concepts/
│   └── architecture-and-lifecycle.md
├── scenarios/
│   └── high-level-scenarios.md
├── references/
│   ├── versioning-and-compatibility.md
│   ├── samples-validation.md
│   └── environment-variables.md
├── troubleshooting/
│   └── common-drift-and-breaks.md
├── android/
│   ├── SKILL.md
│   ├── concepts/sdk-lifecycle.md
│   ├── examples/service-patterns.md
│   ├── references/android-reference-map.md
│   └── troubleshooting/common-issues.md
├── ios/
│   ├── SKILL.md
│   ├── concepts/sdk-lifecycle.md
│   ├── examples/service-patterns.md
│   ├── references/ios-reference-map.md
│   └── troubleshooting/common-issues.md
└── web/
    ├── SKILL.md
    ├── concepts/lifecycle-and-events.md
    ├── examples/app-context-and-state.md
    ├── references/web-reference-map.md
    └── troubleshooting/common-issues.md

一般的なライフサイクルパターン

1. プラットフォームのコンテキストを早い段階で初期化します。
2. チャネルアイテムを作成します（チャット／ビデオ／ZVA では entryId、スケジュール済みコールバックとキャンペーンのフローでは apiKey）。
3. サービス／クライアントのインスタンスを取得します。
4. ユーザーが操作する前にリスナー／デリゲートを登録します。
5. フローを開始します（fetchUI、startVideo、または Web SDK の open/show 経路）。
6. エンゲージメントの状態変化（start、hold、resume、end）とコンテキストの切り替えを処理します。
7. フローを終了し、リソースを解放します（endChat／endVideo、logout/logoff、初期化解除／解放）。

ハイレベルなシナリオ

• engagementId ごとにメモを保存し、コンテキストの切り替え後も維持する、エージェント用サイドパネルアプリ。
• Web タグから起動する、ブラウザー上のチャット／ビデオキャンペーン。
• チャット／ビデオ／スケジュール済みコールバックに対応する、ネイティブモバイルの顧客向けアプリ。
• キャンペーンを起点とするチャネル選択（チャット、ZVA、ビデオ、スケジュール済みコールバック）。
• モバイルで切断されたビデオエンゲージメントに再参加するフロー。
• postMessage イベントの契約を使用する、Smart Embed CRM ソフトフォン。

詳細は scenarios/high-level-scenarios.md を参照してください。

連携先

• 認証とアプリ内のクライアント ID：../zoom-apps-sdk/SKILL.md および ../oauth/SKILL.md
• Contact Center REST ワークフロー：../rest-api/SKILL.md
• Web の音声／チャットチャネルでの Cobrowse：../cobrowse-sdk/SKILL.md

環境変数

• 標準化された .env キーと各値の取得場所については、references/environment-variables.md を参照してください。